Triage

Move request files under .scratch/ through a small state machine of triage roles. There is no external issue tracker — every artifact is a markdown file. Read the layout from .agents/issue-tracker.md (written by /setup) when the repo has one (docs/agents/issue-tracker.md is the legacy path).

External pull requests can still be a request surface: a PR is input that produces a markdown triage file under .scratch/ (same roles, same states, same machine, with a few deltas marked "for a PR" below). Notes, briefs, and state live in that file — never on the PR host as the system of record.

Every triage note appended to a markdown file must start with this disclaimer:

> *This was generated by AI during triage.*

Reference docs

• AGENT-BRIEF.md — how to write durable agent briefs
• OUT-OF-SCOPE.md — how the .out-of-scope/ knowledge base works

Roles