Move issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 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** — same roles, same states, 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](AGENT-BRIEF.md) — how to write durable agent briefs
- [OUT-OF-SCOPE.md](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
…
The line at the top of this page pins the label git:20260622.889f27e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_wvnt6l6hsaecrygg
GET https://markdownregistry.com/api/v1/resolve?ref=coder/agent-tty/triage
GET https://markdownregistry.com/api/v1/blob/d99a2a9c300521392a2bc811166543073d8b1369121da9ada4a7036cecb0ce3f
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
coder/agent-tty · .agents/skills/codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
coder/agent-tty · .agents/skills/diagnosing-bugs/SKILL.md · Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports…
coder/agent-tty · .agents/skills/domain-modeling/SKILL.md · Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous…
coder/agent-tty · .agents/skills/grill-with-docs/SKILL.md · A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
coder/agent-tty · .agents/skills/grilling/SKILL.md · Interview the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building…
coder/agent-tty · .agents/skills/improve-codebase-architecture/SKILL.md · Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you…
coder/agent-tty · .agents/skills/improve/SKILL.md · Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER…
coder/agent-tty · .agents/skills/release-maintainer/SKILL.md · Internal maintainer SOP for version bumps, release PRs, tagging, publishing, and post-publish verification in this…
coder/agent-tty · .agents/skills/to-issues/SKILL.md · Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet…
coder/agent-tty · .agents/skills/to-prd/SKILL.md · Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of…
qwenlm/qwen-code · .qwen/skills/triage/SKILL.md · Gatekeep and review GitHub issues and pull requests for Qwen Code maintainers. Use for GitHub Action issue triage, PR…
nightly-labs/openbot · .agents/skills/triage/SKILL.md · Triage one GitHub issue or bug report. Decide if it is valid, find the root cause, and fix it. Push back with evidence…
hashgraph-online/awesome-codex-plugins · plugins/AgiFlow/ai-plugin/skills/triage/SKILL.md · Diagnose stalled, blocked, overloaded, or unhealthy Agiflow projects and recommend specific corrective actions. Use for…
sethgammon/citadel · skills/triage/SKILL.md · GitHub issue and PR investigator. Pulls open issues/PRs, classifies them, searches the codebase for root cause or…
oliver-kriska/claude-elixir-phoenix · plugins/elixir-phoenix/skills/triage/SKILL.md · Triage review findings interactively — approve, skip, or prioritize each issue. Use after /phx:review to filter…
boshu2/agentops · skills/triage/SKILL.md · Turn incoming reports, external PRs and alerts into evidence-based decisions and agent-ready briefs. Use when: intake…
boshu2/agentops · plugin/skills/triage/SKILL.md · Turn incoming reports, external PRs and alerts into evidence-based decisions and agent-ready briefs. Use when: intake…
