AI Craftsman Superpowers
Transform Claude into a disciplined Senior Software Craftsman
Senior craftsman methodology for Claude Code. DDD, Clean Architecture, TDD.
Transform Claude Code into a disciplined software engineer with battle-tested methodologies.
Requirements
- Claude Code v1.0.33 or later
- Run
claude --versionto check
Installation
From GitHub (Recommended)
# Step 1: Add the marketplace
/plugin marketplace add BULDEE/ai-craftsman-superpowers
# Step 2: Install the plugin
/plugin install craftsman@BULDEE-ai-craftsman-superpowers
# Step 3: Restart Claude Code
exit
claude
From Local Path
# If you cloned the repo locally
git clone https://github.com/BULDEE/ai-craftsman-superpowers.git /path/to/ai-craftsman-superpowers
/plugin marketplace add /path/to/ai-craftsman-superpowers
/plugin install craftsman@ai-craftsman-superpowers
Verify Installation
# Open plugin manager
/plugin
# Go to "Installed" tab to see craftsman plugin
# Go to "Errors" tab if skills don't appear
API Cost Model
The plugin uses AI agent hooks for deep semantic analysis beyond regex. These are optional and can be disabled.
| Agent Hook | Trigger | Model | Purpose |
|---|---|---|---|
| DDD Verifier | Each Write/Edit | Haiku | Layer violations, aggregate boundaries, naming |
| Sentry Context | Each Write/Edit | Haiku | Error context from Sentry (if configured) |
| Architecture Analyzer | Session start | Haiku | Build project context map |
| Final Reviewer | Session end | Haiku | Validate architecture (strict mode only) |
Estimated cost: ~$0.15-0.30 per session (50 Write/Edit operations)
Opt-out: Set agent_hooks: false in plugin config to disable all agent hooks. Regex-based validation (Level 1) and static analysis (Level 2) continue to work without agent hooks.
Quick Start
After installation, try:
# Design a new entity (follows DDD phases)
/craftsman:design
I need to create a User entity for an e-commerce platform.
# Debug an issue systematically (ReAct pattern)
/craftsman:debug
I have a memory leak in my Node.js app.
# Plan a feature implementation
/craftsman:plan
I need to migrate our API to microservices.
# Review code for architecture issues
/craftsman:challenge
[paste your code]
# Run the full development workflow (design → spec → plan → implement → test → verify → commit)
/craftsman:workflow
I need to add a forgot password feature.
# Quick setup (zero questions, smart defaults)
/craftsman:setup --quick
See /examples for detailed usage examples with expected outputs.
Why Craftsman? — 6 Core Differentiators
What makes this plugin genuinely unique in the Claude Code ecosystem:
1. Correction Learning System
Records every violation fix users make and injects correction trends at next session start. SQLite-backed feedback loop that progressively teaches Claude the exact patterns your codebase rejects. Cross-file pattern detection suggests project-wide fixes when 3+ files share the same violation. Unique in the ecosystem — no other Claude Code plugin creates this behavioral feedback loop.
2. Rules Engine with 3-Level Inheritance
Enterprise-ready rule customization: Global → Project → Directory overrides. Short form (PHP001: warn) and long form (custom rules with regex, message, severity, languages, paths). Legacy code coexists with strict new code via directory-level relaxation. Python-backed YAML parser with bash 3.2 shell compatibility.
3. Cognitive Bias Detector
Real-time detection of acceleration bias, scope creep, and over-optimization in user prompts. Context-aware bilingual FR/EN pattern matching on UserPromptSubmit hook — requires imperative verb context to reduce false positives. Non-blocking warnings that encourage reflection before action.
4. Real-Time Quality Gate
3-level progressive validation on every Write/Edit:
- Level 1: Regex (<50ms) — strict_types, final, any, setters. Always active.
- Level 2: Static analysis (<2s) — PHPStan, ESLint. When tools installed.
- Level 3: Architecture (<2s) — deptrac, dependency-cruiser. When tools installed.
Graceful degradation: works with zero tools installed (Level 1 only).