agent-eng
Scaffold a structured agentic engineering workflow for AI-assisted development
Agent Pipeline
Agents own the process (decisions, planning, review). Claude Code plan mode owns execution (implementing tickets).
Architect
Asks clarifying questions and explores alternatives before any code is written. Produces Architecture Decision Records (ADRs) and detailed specs.
System Architect
Identifies components, connections, protocols, and tiers. Produces a structured architecture.yaml that documents how the system fits together.
Planner
Takes ADRs and specs as input. Decomposes work into discrete tickets scoped for a single Claude Code plan mode session.
Plan Mode
Not a custom agent — this is Claude Code's native plan mode (shift+tab). It explores the codebase, proposes a plan, gets approval, then implements. Each ticket from the Planner is executed as a separate plan mode session.
Reviewer
Automatically invoked after plan mode completes a ticket. Validates code and tests against acceptance criteria, updates ticket status, and syncs the backlog. Flags issues back for fixing via plan mode.
Code Auditor
Optional, manually invoked agent that audits code for over-abstraction, impossible-state guards, reinvented wheels, and subtly wrong assumptions. Ranks findings by severity. Does not fix — flags issues with suggested directions. Claude may proactively suggest running it after large diffs or before commits.
HTML Summarizer
Generates self-contained HTML presentations with architecture diagrams, code walkthroughs, and decision records. Opens directly in a browser.