Documentation
AI Craftsman Superpowers
The quality gate that brings DDD, Clean Architecture and TDD to every agent session, on Claude Code, Codex, Grok and Hermes. Zero configuration required to start. Zero drift by design.
v4.14.0Apache 2.0Claude Code 2.1.218+ · Codex · Grok · Hermes
Quick Start
# 1. Add the marketplace, then install
$/plugin marketplace add BULDEE/ai-craftsman-superpowers
$/plugin install craftsman@ai-craftsman-superpowers
$/plugin marketplace add BULDEE/ai-craftsman-superpowers
$/plugin install craftsman@ai-craftsman-superpowers
# 2. Configure your stack
$/craftsman:setup
$/craftsman:setup
# 3. Verify the gate is armed, then code
$/craftsman:healthcheck
$/craftsman:healthcheck
What You Get
22 Skills
Design, debug, test, scaffold, verify, legacy, loop: full lifecycle coverage
12 Agents
Architect, Security, Doc Writer, UX Director, Legacy Surgeon, Team Lead, plus six from the packs
Progressive Gate
Regex before disk, then LSP semantics, then static analysis and architecture (opt-in)
7 Packs Shipped
Symfony, React, Python, Go, Rust, Bash, AI/ML
Quality Metrics
SQLite-backed violation and correction tracking with trend analysis
Zero-Drift CI
Same rules in hooks AND CI: GitHub, GitLab, Bitbucket, Jenkins
Documentation
- Hosts and CapabilitiesFour hosts, one engine: Claude Code, Codex, Grok, Hermes. What each host does and limitations.
- Getting StartedInstall AI Craftsman Superpowers and run your first quality-enforced session in under 5 minutes.
- ConfigurationComplete reference for .craft-config.yml - global, project, and directory-level configuration.
- Commands ReferenceComplete reference for the AI Craftsman Superpowers skills: usage, effort, and examples.
- Agents Reference6 core agents and 6 pack agents: roles, models, allowed tools, and when to use each.
- Rules Engine3-level rule inheritance system: Global → Project → Directory. Built-in rules, custom rules, and severity levels.
- Creating PacksComplete guide to creating community packs: pack.yml manifest, validators, agents, knowledge, and publishing.
- CI IntegrationZero-drift CI integration for GitHub Actions, GitLab CI, Bitbucket Pipelines, and Jenkins.
- Metrics & AnalyticsSQLite-backed quality metrics: violations, corrections, session history, and 7-day trends.
- TroubleshootingCommon issues, debug mode, and FAQ for AI Craftsman Superpowers.
- ChangelogVersion history for AI Craftsman Superpowers, from v1.0.0 to v4.14.0.