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**, 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](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:20260930.0a9e31d, 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_kqx2wcm42zwe2qiv
GET https://markdownregistry.com/api/v1/resolve?ref=fabiandistler/agents/triage
GET https://markdownregistry.com/api/v1/blob/917b0baf74be583e74f110857ed45df2766617f75c00baf61fd136d7af515edf
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.
fabiandistler/agents · .claude/skills/code-review/SKILL.md · Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code…
fabiandistler/agents · .claude/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…
fabiandistler/agents · .claude/skills/diagnosing-bugs/SKILL.md · Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports…
fabiandistler/agents · .claude/skills/domain-modeling/SKILL.md · Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md…
fabiandistler/agents · .claude/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.
fabiandistler/agents · .claude/skills/grilling/SKILL.md · Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or…
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…