Handyman

Install, analyze, create, migrate, or operate a Handyman harness: an operating layer around a repo where agents work through explicit roles, disk state, one feature at a time, and executable verification. The pattern: AGENTS.md, feature_list.json, progress/, memory/, CHECKPOINTS.md, init.sh, and role files.

Handyman supersedes harness-subagents (Foreman).

Quick Start

1. Pick a mode: analyze, bootstrap, run-feature, review, migrate-global, or upgrade.
2. Resolve HARNESS_WORKSPACE: harness.config.json, then feature_list.json config, then PROJECT_ROOT/.handyman/, then the legacy PROJECT_ROOT fallback.
3. To create a harness, run bootstrap.
4. To work, run one feature: lowest-id pending, mark in_progress, delegate implement then review, close only after a green verifier.
5. Reports live in $HARNESS_WORKSPACE/backlog/; the chat carries only short file references.

Walkthroughs: references/examples.md.

Operating Modes