project-bootstrap

Project Bootstrap

Use this the first time the harness runs in a project, or whenever the owner asks you to set it up, tailor it, or figure out which conventions apply here.

The deterministic work is done by agentharness bootstrap. Your job is the conversation — the tool inventories the repository and lists the decisions that need making; you ask the owner about them, one at a time, and feed the answers back.

Check the command exists first: agentharness bootstrap plan --help. If it is unavailable, this repository has not installed the harness CLI — fall back to tools/setup/harness-link.sh and assess the project conversationally rather than claiming a bootstrap flow exists.

---

The loop

# 1. Inventory (read-only — writes nothing, safe to run any time)
agentharness bootstrap plan --json

# 2. Feed answers back as you collect them
agentharness bootstrap plan --answer rigor.tier=production

# 3. Apply, only with the hash of the plan the owner approved
agentharness bootstrap apply --answer ... --confirm <plan_hash>

plan is safe to re-run at any point. Re-run it after every answer — the question set and the proposed actions both change as answers come in.

---

Reading the plan

{
  "detected":  [{"capability": "test", "present": true,
                 "detail": "pytest", "evidence": ["pyproject.toml"]}],
  "questions": [{"id": "rigor.tier", "prompt": "...", "default": "production"}],
  "actions":   [{"path": "ruff.toml", "summary": "Create ruff.toml"}],
  "is_resolved": false,
  "plan_hash": "..."
}

Field	What it means
detected	Verified facts. present: true means a config file says so, and evidence names it.
questions	Decisions only the owner can make. Unanswered ones block apply.
actions	Exactly what apply would create. Empty until answers ask for something.
is_resolved	False while any question is unanswered.
plan_hash	Changes whenever the repo or the answers change.