Triage

Move issues on the project issue tracker through a small state machine of triage roles.

If this repo treats external pull requests as a request surface (see the issue-tracker config), triage covers them too: a PR is an issue with attached code, using the same roles, same states, and same machine, with a few deltas marked "for a PR" below. Resolve a bare #42 to an issue or PR per the tracker config.

Every comment or issue posted to the issue tracker during triage 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

Two category roles:

• bug: something is broken
• enhancement: new feature or improvement

Five state roles:

• needs-triage: maintainer needs to evaluate
• needs-info: waiting on reporter for more information
• ready-for-agent: fully specified, ready for an AFK agent
• ready-for-human: needs human implementation
• wontfix: will not be actioned

For a PR, the same states read against the attached code: `ready-for-a…