cadre-devkit-claude

Cadre DevKit for Claude Code

Turn Claude Code from a helpful intern into a reliable senior engineer.

---

What is Claude Code?

Claude Code is Anthropic's official CLI for AI-assisted coding. You run it in your terminal, and Claude can read your files, write code, run commands, and help you build software.

It's powerful. It's also... unpredictable.

The Problem

AI coding assistants have a reliability problem:

Issue	What Happens
Hallucination	"Tests pass!" (they don't)
Over-engineering	50 lines of defensive code for a 3-line function
AI slop	Comments everywhere, any casts, unnecessary try/catch
Context loss	Re-explores the same code every session
Dangerous commands	rm -rf / is just a typo away
No planning	Jumps straight to code without understanding
Inconsistent quality	Great on Monday, chaos on Tuesday

You end up babysitting the AI instead of shipping code.

The Solution

This devkit adds a quality and safety layer to Claude Code:

• Hooks that actually block dangerous commands (not just warnings)
• Structured workflow from idea to shipping
• Evidence-based verification (no more "it should work")
• Research-first pattern (understand before implementing)
• Knowledge preservation (learnings persist across sessions)
• Anti-slop tooling (removes AI code smell)
• Interactive learning (teach yourself about Claude Code)

It's not a collection of prompts. It's an integrated system.

---

Installation

Option 1: Via Plugin System (Recommended)

Start Claude Code:

claude

Then inside Claude Code, add the marketplace and install the plugin:

/plugin marketplace add github.com/benshapyro/cadre-devkit-claude
/plugin install cadre-devkit-claude@cadre-devkit

For local development, use the file path:

/plugin marketplace add /Users/bshap/Projects/cadre-internal/devkits/cadre-devkit-claude
/plugin install cadre-devkit-claude@cadre-devkit

Option 2: Git Clone with Install Script

git clone https://github.com/benshapyro/cadre-devkit-claude.git
cd cadre-devkit-claude
./install.sh

Option 3: Manual Installation

# Clone
git clone https://github.com/benshapyro/cadre-devkit-claude.git

# Copy components
cp -r cadre-devkit-claude/commands/* ~/.claude/commands/
cp -r cadre-devkit-claude/skills/* ~/.claude/skills/
cp -r cadre-devkit-claude/agents/* ~/.claude/agents/
cp -r cadre-devkit-claude/hooks/* ~/.claude/hooks/

# Make hooks executable
chmod +x ~/.claude/hooks/**/*.py
chmod +x ~/.claude/hooks/**/*.sh

Configure Hooks

Add to ~/.claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{ "type": "command", "command": "~/.claude/hooks/security/dangerous-command-blocker.py" }]
      },
      {
        "matcher": "Edit|Write|Read",
        "hooks": [{ "type": "command", "command": "~/.claude/hooks/security/sensitive-file-guard.py" }]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/formatting/auto-format.py" },
          { "type": "command", "command": "~/.claude/hooks/testing/test-on-change.py" }
        ]
      }
    ]
  }
}

Verify Installation

After installing via plugin system, restart Claude Code to load the plugin. Then verify:

/help                       # Should show /learn, /plan, /research, etc.
/learn                      # Should show welcome message
Can you run rm -rf /        # Should be blocked by security hook

If you used the install script or manual installation, hooks are configured automatically in your ~/.claude/settings.json.

---

The Workflow