claude-superpowers

Claude Superpowers

Production-ready tools for autonomous development with Claude Code.

---

What's Inside

Component	Count	Description
Agents	9	Specialized AI agents for different tasks
Skills	7	Methodology guides and knowledge domains
Commands	4	Output style modes
Hooks	2	Automation triggers
Workflows	1	Ralph Loop autonomous iteration

---

Quick Start

Option 1: Plugin Installation

# Clone the repo
git clone https://github.com/mjohnson518/claude_superpowers.git

# Install as a plugin (coming soon)
claude plugins install ./claude_superpowers

Option 2: Manual Copy

# Clone the repo
git clone https://github.com/mjohnson518/claude_superpowers.git

# Copy to your project's .claude directory
cp -r claude_superpowers/skills/* /path/to/your/project/.claude/skills/
cp -r claude_superpowers/agents/* /path/to/your/project/.claude/agents/
cp -r claude_superpowers/commands/* /path/to/your/project/.claude/commands/
cp -r claude_superpowers/hooks/* /path/to/your/project/.claude/hooks/

---

Agents

Nine specialized agents for different development tasks:

Agent	Purpose	Trigger Keywords
orchestrator	Coordinate complex multi-step tasks	"improve", "refactor", large features
code-reviewer	Quality assessment (0-10 scoring)	"review", "check quality", before commit
security-auditor	OWASP-based vulnerability detection	"security scan", "audit", auth changes
debugger	Root cause analysis	"bug", "error", "not working"
docs-writer	Documentation generation	"document", "README", "API docs"
test-runner	Test/lint/build validation	"run tests", "validate", "CI"
git-executor	Git operations	"commit", "branch", "push"
refactorer	Code structure improvement	"clean up", "technical debt"
test-architect	Test strategy design	"test strategy", "coverage"

Git Executor Identity

The git-executor agent enforces commit standards. Configure your identity:

# Set your git identity (required before first use)
git config user.name "Your Name"
git config user.email "your-email@example.com"

See agents/ORCHESTRATION.md for workflow diagrams.

---

Skills

Seven methodology guides and knowledge domains:

Core Skills (Existing)

Skill	Purpose
production-readiness	15-dimension production audit with scoring
claude-code-optimizer	EPCC workflow (Explore → Plan → Code → Commit)
sprint-orchestrator	Multi-project sprint management

New Skills

Skill	Purpose
architecture-patterns	Clean Architecture, DDD, microservices
performance-optimization	Profiling, caching, bottleneck identification
api-design	REST, GraphQL, and API best practices
project-analysis	Codebase analysis and onboarding

---

Commands

Four output style modes to adjust Claude's behavior:

Command	Mode	Use Case
/superpowers:architect	System design	Architecture decisions, design docs
/superpowers:rapid	Fast development	Prototyping, getting things working
/superpowers:mentor	Teaching	Learning, explanations, tutorials
/superpowers:review	Code review	Quality assessment, PR reviews

---

Hooks

Automation triggers for security and file protection:

Security Scan Hook

• Trigger: Before Write/Edit operations
• Action: Blocks commits containing secrets, API keys, credentials
• Patterns: AWS keys, GitHub tokens, private keys, passwords

File Protection Hook

• Trigger: Before Write/Edit operations
• Action: Prevents modification of sensitive files
• Protected: .env, .git/, lock files, *.pem, *.key

Configuration

Hooks are configured in hooks/hooks.json. To disable:

{
  "hooks": [
    {
      "name": "security-scan",
      "enabled": false
    }
  ]
}

Logs are written to .claude/logs/.

---

Workflows

Ralph Loop

Autonomous iterative development loop - a working alternative to the broken ralph-wiggum plugin.

Features:

• Timing statistics
• CLAUDE.md integration
• Completion promise detection
• Works with Ctrl+C (unlike the plugin)

Quick Start:

# Copy files to your project
cp workflows/ralph-loop/ralph-loop.sh /path/to/your/project/
cp workflows/ralph-loop/PROMPT_TEMPLATE.md /path/to/your/project/.claude/RALPH_PROMPT.md

# Edit the prompt
nano .claude/RALPH_PROMPT.md

# Run (50 iterations max)
./ralph-loop.sh 50

See workflows/ralph-loop/README.md for complete documentation.

---

Repository Structure