terry-mao/aicodingflow/triage-issue-repo

Repo-specific triage guidance

This file is a companion to the core triage-issue skill. It does not redefine the triage output schema, safety rules, or follow-up-question contract. It only specializes the override categories the core skill marks as overridable.

Heuristics

• Distinguish observed symptoms from reporter hypotheses and proposed fixes.
• Before asking any follow-up question, first try to answer it yourself through code inspection, documentation lookup, or web search. Only ask questions that you cannot resolve on your own and that only the reporter would know.
• Ask targeted follow-up questions only for details the agent cannot derive itself and that materially improve triage confidence.
• Prefer issue-specific questions over generic "please share more info" requests.
• For concrete workflow, skill, documentation, or test failures/improvements that already contain enough detail for a product/spec pass, consider ready-to-spec during triage. Maintainers repeatedly added this lifecycle label on issues #251, #239, and #134 after initial triage.
• Treat ready-to-implement as a later lifecycle label, not a default initial-triage label. Only include it during triage when the issue already has an approved or clearly complete spec/plan, or the maintainer-provided issue context explicitly says implementation is approved. Maintainers added it after spec-readiness signals on issues #239 and #134.

Label taxonomy

The label taxonomy for this repository is managed in .github/issue-triage/config.json. Prefer labels from that configuration, and avoid inventing new labels unless the prompt explicitly allows it.

Recurring follow-up patterns

No repo-specific follow-up patterns have been captured for this repository yet. Future updates may add concise, evidence-backed patterns when maintainer overrides reveal recurring follow-up needs that are actually specific to this repository.

Self-Evolution Boundary

The update-triage workflow may propose concise updates to this companion skill when repeated maintainer correction signals across independent issues reveal stable repo-specific triage guidance. Those updates must stay within the override categories allowed by the core triage-issue skill and cannot change the core triage contract, output schema, reserved label rules, safety rules, or duplicate/follow-up exclusivity.