claude-superpowers

System design and architecture mode - thorough, design-first approach

Teaching and learning mode - educational, explanatory approach

Fast development mode - speed-focused, get it working first

Code review mode - strict quality evaluation and feedback

This document describes how the 9 agents in claude-superpowers work together to handle complex development tasks.

Review code quality and best practices. Triggers after code changes, before commits, on PR reviews.

Systematic bug investigation and root cause analysis. Triggers on errors, test failures, crashes, unexpected behavior.

Generate technical documentation. Triggers on README requests, API docs, guides, architecture diagrams.

Execute git operations with user's configured identity. Triggers on commit requests, branch operations, git workflows.

Coordinate complex multi-step tasks. Triggers on "improve", "refactor", multi-module changes, large features.

Improve code structure without changing behavior. Triggers on technical debt, cleanup requests, code smell identification.

Scan for security vulnerabilities. Triggers on auth code, user input handling, sensitive data, API endpoints.

Design comprehensive test strategies. Triggers on test planning, coverage gaps, new feature testing, QA strategy.

Execute and validate tests, linting, and builds. Triggers on test requests, CI validation, pre-commit checks.

REST, GraphQL, and API design best practices. Use when designing APIs, defining contracts, or reviewing API architecture.

Architectural patterns and design principles for scalable, maintainable systems. Use when designing systems, refactoring architecture, or choosing patterns.

Claude Code productivity patterns including EPCC workflow, context management, and extended thinking triggers. Use when starting sessions or managing context.

Performance profiling, optimization techniques, and bottleneck identification. Use when addressing performance issues or optimizing systems.

Enterprise-grade production readiness assessment system for comprehensive codebase evaluation. Use when (1) Evaluating a GitHub repository for production deployment, (2) Conducting pre-launch security and architecture reviews, (3) Assessing technical debt and system reliability, (4) Identifying gaps, vulnerabilities, and incomplete features, (5) Generating actionable remediation plans for engineering teams, (6) Validating scalability, observability, and operational readiness, (7) Reviewing cost optimization and resource efficiency, (8) Auditing compliance with industry standards (SOC2, GDPR, HIPAA, PCI-DSS), (9) Evaluating API contracts and integration stability, (10) Assessing team knowledge transfer and documentation completeness. Performs CTO-level multi-dimensional analysis exceeding top-tier tech company standards.

Analyze and understand codebase structure, dependencies, and patterns. Use when onboarding to a new project or auditing existing code.

Manage multi-project sprints with daily planning, progress tracking, and context switching. Use when coordinating work across multiple repositories.