ā” Init Harness
One command: agent-foreman init
Quick Start
agent-foreman init
Creates: ai/tasks/, 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 |
Task Types
| Type |
Command |
Use Case |
| Code (default) |
agent-foreman init |
Software development |
| Ops |
agent-foreman init --task-type ops |
Operational tasks, runbooks |
| Data |
agent-foreman init --task-type data |
ETL, data pipelines |
| Infra |
agent-foreman init --task-type infra |
Infrastructure provisioning |
| Manual |
agent-foreman init --task-type manual |
Manual-only verification |
Auto-Detection
ARCHITECTURE.md exists ā 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 init --analyze # First: understand project
agent-foreman init # Then: create harness
Created Files
ai/
āāā tasks/ # Task backlog (modular markdown)
ā āāā index.json # Task index
ā āāā {module}/ # Module directories
ā āāā {id}.md # Individual tasks
āāā 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
