clean-code-guard

rbw-claude-code

A Claude Code plugin marketplace with parallel Codex marketplace metadata for the plugins that already map cleanly onto Codex's current plugin model.

This project started as a fork of EveryInc/compound-engineering-plugin.

Installation

Claude Code

Add this marketplace to Claude Code:

/plugin marketplace add RBozydar/rbw-claude-code

Then browse and install plugins:

/plugin menu

Codex

Codex currently reads local marketplaces rather than remote GitHub marketplace references. This repo now ships a repo-local Codex marketplace at .agents/plugins/marketplace.json.

To use it:

git clone https://github.com/RBozydar/rbw-claude-code.git
cd rbw-claude-code
codex
/plugins

The current Codex marketplace exposes:

• core
• python-backend
• deep-research-plus

The guard plugins remain Claude-only for now because current Codex plugin docs describe skills, apps, and MCP configuration, but not hook plugins.

Poetry Users

If you use Poetry instead of uv for package management, install from the poetry-variant branch:

/plugin marketplace add RBozydar/rbw-claude-code#poetry-variant

This variant includes enforce-poetry instead of enforce-uv, suggesting poetry run and poetry add commands.

Hook Setup (Required Workaround)

Due to a known Claude Code bug, plugin hooks are matched but not executed. Until this is fixed upstream, you need to manually configure hooks in your settings.

Navigate to the marketplace directory:

cd ~/.claude/plugins/RBozydar/rbw-claude-code

Run the setup script:

# Global hooks (apply to all projects) - default
./scripts/setup-hooks.sh

# Or project-specific hooks (run from within your project)
./scripts/setup-hooks.sh --project

To verify hooks are active:

/hooks

You should see the configured hooks listed (enforce-uv, conventional-commits, etc.).

Auto-Sync Detection

Once hooks are installed, a SessionStart hook automatically checks if your configured hooks are in sync with available plugin hooks. If hooks change (e.g., after updating the marketplace), you'll see a warning at session start:

====================================================
  rbw-claude-code: Hooks are out of sync!
====================================================

  Plugin hooks have changed. Run to update:

    ./scripts/setup-hooks.sh --project

====================================================

You can also manually check sync status:

./scripts/setup-hooks.sh --check           # Check global hooks
./scripts/setup-hooks.sh --check --project # Check project hooks

Available Plugins

AI-Powered Development

Plugin	Description
core	Universal AI development tools: 29 agents, 18 commands, 16 skills
python-backend	Python-specific tools: 5 reviewers, 2 commands
deep-research-plus	Deep research workflows with optional GDELT MCP support

Automation Hooks

Plugin	Description
enforce-uv	Block bare python/pip/pytest commands, enforce uv
conventional-commits	Validate conventional commit format
python-format	Auto-format Python files with ruff after edits
python-typecheck	Run type checking after Python file edits
test-reminder	Remind to add tests when creating new Python files

Security Hooks

Plugin	Description
protect-env	Block reading .env files to protect secrets
git-safety-guard	Block destructive git commands
safety-guard	Block destructive file ops and supply chain attacks

Codex Support

Codex-compatible plugins in this repo currently are:

• core
• python-backend
• deep-research-plus

Each now ships a .codex-plugin/plugin.json, and the repo marketplace lives at .agents/plugins/marketplace.json.

Hook-only plugins remain Claude-specific for now. Details: docs/codex-compatibility.md

For Codex-only local generation without hand-maintaining duplicate markdown, the repo now generates:

• Codex custom agents under .codex/agents/ from Claude agents/
• Codex custom prompts under .codex/prompts/ from Claude commands/

Regenerate both from source:

uv run python scripts/generate_codex_agents.py

Install them into your Codex home:

./scripts/install-codex-agents.sh