claude-workflow-v2

Expert code review specialist. Use PROACTIVELY after writing or modifying code, before commits, when asked to review changes, PR review, code quality check, lint, or standards audit. Focuses on quality, security, performance, and maintainability.

Expert debugging specialist for errors, test failures, crashes, segmentation faults, memory leaks, timeouts, race conditions, deadlocks, and unexpected behavior. Use PROACTIVELY when encountering any error, exception, or failing test. Performs systematic root cause analysis.

Technical documentation specialist. Use for creating README files, API documentation, architecture docs, inline comments, user guides, changelogs, migration guides, release notes, FAQs, and troubleshooting docs. MUST BE USED when documentation is needed or when code changes require doc updates.

Master coordinator for complex multi-step tasks. Use PROACTIVELY when a task involves 2+ modules, requires delegation to specialists, needs architectural planning, or involves GitHub PR workflows. MUST BE USED for open-ended requests like "improve", "enhance", "build", "scale", "refactor", "add feature", "system design", "architecture", "complex task", or when implementing features from GitHub issues.

Code refactoring specialist for improving code quality, reducing technical debt, eliminating code smells, reducing complexity, and applying design patterns. Use PROACTIVELY when code needs restructuring, simplification, tech debt reduction, or when applying DRY/SOLID principles.

Security specialist for vulnerability detection, secure coding review, and security hardening. Use PROACTIVELY when handling authentication, authorization, encryption, secrets, credentials, OAuth, JWT, CORS, headers, user input, API keys, or sensitive data. Checks for OWASP Top 10 and common vulnerabilities.

Testing strategy specialist for designing test suites, writing tests, and ensuring comprehensive coverage. Use PROACTIVELY when adding new features, fixing bugs, improving test coverage, creating test plans, mocking strategies, handling flaky tests, or writing integration/E2E tests.

Add tests for recently changed files or specified code

System design and architecture planning mode. Focuses on high-level design, trade-offs, and technical decisions before implementation.

Explore the repository with 10 parallel subagents to create comprehensive documentation. Creates CODEBASE.md with full architecture analysis.

Simplifies code after implementation. Reviews recent changes and suggests/applies simplifications while preserving behavior.

Commit staged changes, push to remote, and create a pull request

Create a conventional commit with auto-generated message

Safe, one-at-a-time dependency upgrades with verification after each. Detects package manager automatically.

Runs linting and code quality checks. Catches style issues, potential bugs, and enforces project standards.

Auto-fix all linting and formatting issues

Educational mode that explains concepts, teaches patterns, and guides learning. Ideal when learning a new codebase, technology, or programming concept.

View agent performance metrics and session history. Shows usage patterns, files changed, and session summaries.

Multi-perspective analysis using parallel subagents. Analyzes code from architecture, security, performance, and testing viewpoints simultaneously.

Run parallel code review across multiple directories or files. Uses N subagents simultaneously for faster analysis.

Create and maintain a structured PLAN.md for persistent task tracking. Supports phases, dependencies, and progress tracking.

Quickly fix lint errors, type errors, or simple bugs

Fast-paced development mode for quick iterations. Minimal ceremony, maximum speed. Best for prototypes, MVPs, and time-sensitive tasks.

Systematic, safety-first refactoring with verification at each step. Never refactors and adds features simultaneously.