The Agents

Purpose-built AI agents for every phase. Each agent has a specific role, defined capabilities, and clear outputs.

Specialist Agents

Called in when a feature needs deep expertise in a specific area.

Test Specialist

sdlc-test

Deep-dive testing for complex features.

Security Specialist

sdlc-security

Security review and vulnerability assessment.

Performance Specialist

sdlc-perf

Performance profiling and optimization.

Database Specialist

sdlc-database

Schema design and query optimization.

Root Cause Analyst

sdlc-root-cause

Diagnoses failures and broken behavior. Dual-mode: on-demand diagnosis and Phase 4 failure analysis.

Code Linter

code-linter

Hybrid linting — runs ESLint/ShellCheck for deterministic checks, then Claude analysis for logic errors and security issues.

Codebase Auditor

codebase-auditor

Audits against OWASP Top 10, CWE, SANS/CIS benchmarks, and engineering hygiene frameworks.

Firecrawl Specialist

firecrawl

Web scraping, crawling, and structured data extraction via the Firecrawl API.

Hotfix Agent

sdlc-hotfix

Structured bug fix workflow outside the feature SDLC for production issues.

Tech Consultant

tech-consultant

Passive pattern enforcer active during all coding, reviewing, and architecture tasks. Prevents over-engineering and ensures existing codebase patterns are followed.

Context Engineer

context-engineering

Meta-skill for managing agent context effectively. Defines context hierarchy, packing strategies, and anti-starvation rules.

Deprecation & Migration

deprecation-and-migration

Safe removal of code, dependencies, and features. Prevents breaking changes from careless removal with Chesterton's Fence principle.

Code Simplification

code-simplification

Active refactoring workflow for simplifying existing code. Rule of 500, structured simplification patterns, and complexity reduction.

Browser Testing

browser-testing-with-devtools

Live browser inspection via Chrome DevTools MCP — DOM, console, network, performance traces. Treats browser content as untrusted; constrains JavaScript execution.

Source-Driven Development

source-driven-development

Grounds framework-specific code in official documentation with citations. Detect stack → fetch docs → implement → cite. Prevents stale-training-data drift.

Documentation & ADRs

documentation-and-adrs

Architecture Decision Records and inline documentation patterns. ADR template + lifecycle (Proposed → Accepted → Superseded). Comment the why, not the what.

Pipeline Agents

One agent per phase, working in sequence through the pipeline.

0

Discovery Agent

sdlc-discover

Interviews you about the problem, challenges assumptions, and produces a scoped Problem Brief with clear success criteria.

  • Scope definition and constraint setting
  • Success criteria extraction
  • Risk identification
  • Feature sizing (S / M / L)
1

Architecture Agent

sdlc-architect

Reads your codebase, analyzes existing patterns, and produces a Technical Design Document that fits what's already there.

  • Codebase analysis and pattern detection
  • Schema and API design
  • Component specification
  • Technical Design Document generation
1.5

Design Agent

sdlc-design

Creates UI/UX specifications for UI-heavy features. Component specs, layout mockups, and interaction patterns.

  • Component specification
  • Layout and spacing design
  • Interaction pattern definition
  • Responsive design considerations
2

Planning Agent

sdlc-plan

Decomposes the Technical Design Document into ordered, verifiable code prompts with failure recovery strategies.

  • Task decomposition
  • Dependency ordering
  • Verification step definition
  • Failure recovery planning
3

Build Agent

sdlc-build

Executes code prompts sequentially — writes code, runs checks, handles errors, and commits with conventional messages.

  • Code generation and editing
  • Automated check execution
  • Error recovery and retry
  • Conventional commit creation
3+

Compliance Agent

sdlc-compliance

Validates code against 23 rules during build and verification. Catches issues before they reach production.

  • Code standards enforcement
  • Security pattern validation
  • API route validation
  • Type safety checks
4

Verification Agent

sdlc-verify

Runs the full QA suite — type checks, lint, tests, security review — and produces a comprehensive QA report.

  • Test execution and reporting
  • Security audit
  • Compliance audit
  • QA report generation
5

Ship Agent

sdlc-ship

Handles post-merge deployment verification, updates CLAUDE.md architecture docs, and creates release notes.

  • Deployment verification
  • CLAUDE.md update
  • Release note generation
  • Production health check
6

Retro Agent

sdlc-retro

Reviews the build cycle, identifies patterns, proposes improvements to skills and process, and tracks tech debt.

  • Build cycle analysis
  • Pattern identification
  • Skill improvement proposals
  • Tech debt tracking

Review Subagents v8

Read-only specialists for a second opinion on changed code. Invoked by other agents during verification, or directly by the user.

TypeScript Reviewer

typescript-reviewer

Second-opinion reviewer for TS/Next.js code. Runs tsc --noEmit and lint, then ranks findings BLOCK/WARN/NIT against a stack-specific priority ladder (security → type safety → async → error handling → Next.js → React → style).

Silent Failure Hunter

silent-failure-hunter

Hunts swallowed errors, floating promises, empty catches, JSON.parse without try/catch, non-Error throws, and similar patterns. Produces numbered findings with severity, impact, and remediation hints. Read-only.

Slash Commands

Operations triggered by typing /name in Claude Code. Grouped by purpose.

SDLC Flow

/new-feature

Start a new feature in Phase 0 (Discovery).

/status

Print current SDLC state — active feature, phase, branch, in-flight items.

/gate-check

Verify the current phase's gate checklist before advancing.

/resume-feature

Resume work on a previously started feature.

/skip-phase

Mark a phase complete without running it. Use sparingly.

/rollback

Revert a feature to a prior phase.

Authoring

/skill-createv8

Standardized workflow for authoring new skills — frontmatter, profile registration, CLAUDE.md update.

Session

/checkpointv8

Snapshot the current session to .claude/snapshots/checkpoint-<ts>-<label>/ with state, git context, and resume notes.

Git

/prv8

Ad-hoc PR creation outside the Phase 5 flow. Title from commits, body from SDLC artifacts.

Lifecycle Hooks v8

Non-blocking Node scripts that fire on Claude Code events. Warnings go to stdout where the agent sees them; never blocks your work. Ships with the full install profile.

SessionStartsession-start

Prints active feature, phase, branch, and in-flight features so each session resumes with full SDLC context.

PostToolUsepost-edit-format

Silently runs Prettier on edited TS/JS/MD/CSS/JSON files when prettier is available.

PostToolUsepost-edit-console-warn

Warns when console.log/debug/info appears in production source. Skips test/scripts/config files.

PreToolUsepre-bash-commit-guard

Before any git commit, runs npm run lint + tsc --noEmit and emits a warning if either fails. Never blocks the commit.

PreCompactpre-compact

Snapshots .claude/sdlc-state.json to .claude/snapshots/sdlc-state-<ts>.json before context summarization.

Stopstop-pattern-extract

Rate-limited (5min) extractor that diffs commits since the last run and appends fix/revert pattern candidates to .claude/snapshots/pattern-candidates.md for Phase 6 retros.