agent-foreman

Scan codebase and generate ARCHITECTURE.md documentation

Initialize task harness with ai/tasks/ directory structure

Get next task and implement with TDD workflow

Auto-complete all pending tasks or work on specific task

Multi-Expert Council for transforming requirements into fine-grained task files

Show task completion status and progress summary

Spec breakdown agent for foreman-spec workflow. Reads all spec files (PM, UX, TECH, QA), synthesizes OVERVIEW.md, creates BREAKDOWN task files for all modules, and updates index.json. Returns structured result to orchestrator.

Task management orchestrator for agent-foreman CLI. Analyzes user intent and delegates to skills - feature-next (single task), feature-run (batch processing), init-harness (project setup), project-analyze (codebase analysis). Handles TDD mode detection and verification. Triggers on 'agent-foreman', 'next task', 'run tasks', 'check task', 'TDD workflow', 'task status'.

Task implementation agent for feature-run workflow. Executes the next-implement-check cycle for a single task. Handles TDD workflow (RED-GREEN-REFACTOR) when strict mode is active. Returns structured results for orchestrator to process.

Product Manager agent for spec workflow. Clarifies WHAT and WHY of requirements. Identifies target users, business goals, success metrics, scope boundaries, and assumptions. First analyst in the serial workflow - insights inform all subsequent roles.

QA Manager agent for spec workflow. Designs HOW to verify the system. Defines test strategy, risk assessment, quality gates, and acceptance criteria verification. Fourth (final) analyst in serial workflow - has complete context from PM, UX, and Tech.

Technical Architect agent for spec workflow. Reviews PRD for technical clarity issues, then designs HOW to build the system. Identifies unclear requirements that could cause implementation confusion. Defines modules, APIs, data models, tech stack decisions, and architectural constraints. Third analyst in serial workflow - implements UX's screens and flows within PM's scope.

UX/UI Designer agent for spec workflow. Designs HOW users interact with the system. Creates user journeys, screen definitions with ASCII wireframes, interactions, error handling, and accessibility requirements. Second analyst in serial workflow - builds on PM's defined scope and personas.

Implements a single task following the next → implement → check → done workflow with TDD support. Use when working on one specific task, implementing a single feature from the backlog, or following TDD red-green-refactor cycle. Triggers on 'next task', 'next feature', 'implement feature', 'work on feature', 'single task mode', 'what should I work on'.

Executes unattended batch processing of all pending tasks with autonomous decision-making. Use when running all tasks automatically, batch processing without supervision, completing entire feature backlog, or working on a specific task by ID. Triggers on 'run all tasks', 'complete all features', 'batch processing', 'unattended mode', 'auto-complete tasks', 'run feature'.

Multi-role requirement analysis and task breakdown workflow using 4 specialized AI agents (PM, UX, Tech, QA). Each agent conducts web research before analysis to gather industry best practices, case studies, and current trends. Supports Quick Mode (parallel, ~3 min, one Q&A session) and Deep Mode (serial, ~8 min, Q&A after EACH agent so answers inform subsequent analysis). Triggers on 'foreman-spec', 'spec feature', 'break down requirement', 'define tasks', 'spec this'.

Creates AI agent task management structure with feature backlog (ai/tasks/), TDD enforcement, and progress tracking. Use when setting up agent-foreman, initializing feature-driven development, creating task backlog, or enabling TDD mode. Triggers on 'init harness', 'setup feature tracking', 'create feature backlog', 'enable strict TDD', 'initialize agent-foreman'.

Scans codebases to generate architecture documentation (ARCHITECTURE.md). Use when joining an existing project, understanding codebase structure, exploring project architecture, or preparing for agent-foreman init. Triggers on 'analyze project', 'understand codebase', 'explore architecture', 'scan project structure', 'survey project'.