[feature-runner] `docs/agents/feature-runner.md` reference document

[orioltf]

This was generated by AI during triage.

Parent

docs/issues/feature-runner/PRD.md

What to build

Write docs/agents/feature-runner.md — the agent reference document for the Feature Runner. It must describe the full lifecycle as implemented (not as planned), and document the historical cleanup convention. It must not duplicate content from docs/agents/issue-tracker.md, which is overwritten by setup-matt-pocock-skills.

The document should cover:

• The Feature Runner lifecycle: feature selected → worktree created → issues implemented in topological order → PR opened → issues marked closed on merge
• The context bundle injected into each /tdd invocation (what it contains and why)
• The ## Blocked by sequencing rule and what happens on conflict
• The historical cleanup convention: when a Spec in docs/plans/ is marked done and a corresponding docs/issues/<slug>/ folder exists, manually mark all issue files closed and append a note referencing the Spec

Acceptance criteria

• docs/agents/feature-runner.md exists
• It documents the full Feature Runner lifecycle with all phases named correctly using domain vocabulary from CONTEXT.md
• It documents the context bundle contents (issue, PRD, siblings, scoped CONTEXT.md, scoped ADRs, recent commits)
• It documents the ## Blocked by sequencing rule and conflict behaviour
• It documents the historical cleanup convention with a concrete example of the note to append
• It does not duplicate content from docs/agents/issue-tracker.md

Blocked by

• [feature-runner] PR creation and worktree cleanup #82
• [feature-runner] Progress reporting #83
• [feature-runner] Full context bundle for /tdd sub-agent invocations #84
• [feature-runner] Dependency graph and topological ordering #85
• [feature-runner] Auto-selection and LOOP_COMPLETE #86

---

PRD: docs/issues/feature-runner/PRD.md
Migrated from: docs/issues/feature-runner/08-feature-runner-docs.md (source removed after migration)
Touched by PRs: #25, #32