| name | init-harness |
| description | Creates AI agent task management structure with feature backlog (ai/feature_list.json), TDD enforcement, and progress tracking. Use when setting up agent-foreman, initializing feature-driven development, creating feature backlog, or enabling TDD mode. Triggers on 'init harness', 'setup feature tracking', 'create feature backlog', 'enable strict TDD', 'initialize agent-foreman'. |
Init Harness
One command: agent-foreman init
Quick Start
agent-foreman init
Creates: ai/feature_list.json, ai/progress.log, ai/init.sh, CLAUDE.md
TDD Mode (Default: Recommended)
During init, you'll be prompted for TDD mode. Recommended is the default (tests suggested but not required).
| User Says | TDD Mode | Effect |
|---|---|---|
| "strict TDD" / "require tests" | strict |
Tests REQUIRED - check/done fail without tests |
| "recommended" / "optional tests" / (default) | recommended |
Tests suggested but not enforced |
| "disable TDD" / "no TDD" | disabled |
No TDD guidance |
The prompt auto-skips after 10 seconds with recommended mode.
Modes
| Mode | Command | Effect |
|---|---|---|
| Merge (default) | agent-foreman init |
Keep existing + add new features |
| Fresh | agent-foreman init --mode new |
Replace all features |
| Preview | agent-foreman init --mode scan |
Show without changes |
Auto-Detection
ARCHITECTURE.mdexists → use it (fast)- Source code exists → AI scan + auto-save ARCHITECTURE.md
- Empty project → generate from goal
Pre-Init (Recommended)
For existing projects:
agent-foreman analyze # First: understand project
agent-foreman init # Then: create harness
Created Files
ai/
├── feature_list.json # Feature backlog (with tddMode)
├── progress.log # Session audit log
├── init.sh # Bootstrap script
└── capabilities.json # Detected test/lint/build
CLAUDE.md # AI agent instructions
docs/ARCHITECTURE.md # Auto-generated architecture doc