Issue & PR Triage Framework
Evaluate external Issues/PRs against project philosophy. The goal is not just to decide on the request — it's to discover latent work the request reveals.
Core Philosophy
- "Every issue is an opportunity" — Even declines improve documentation or reveal API gaps.
- "Think 10 from 1" — One request implies ten insights. What's missing? What should change?
- "Every contribution is a gift" — Honor the contributor's time.
- "Mentor, not gatekeeper" — Help them succeed.
Philosophy Alignment
| Dimension | Question |
|---|---|
| Core Mission Fit | Serves project's core purpose? |
| Scope Alignment | Library vs application responsibility? |
| Pattern Consistency | Consistent with existing architecture? |
| User Base Impact | Benefits majority or niche? |
Overall: High (4-5 avg) / Medium (3-3.9) / Low (1-2.9)
Issue Decision Matrix
| Philosophy HIGH | Philosophy LOW |
-----------------|-----------------|-----------------|
Feasibility HIGH | ACCEPT | REDIRECT |
Feasibility MED | ADAPT | DEFER/REDIRECT |
Feasibility LOW | DEFER | DECLINE |
PR Decision Matrix
| Quality HIGH | Quality LOW |
-----------------|----------------------|----------------------|
Philosophy HIGH | APPROVE | MERGE_WITH_FIXES |
Philosophy MED | APPROVE_WITH_NOTES | REQUEST_CHANGES |
Philosophy LOW | REDIRECT | DECLINE |
Verdicts
Issues: ACCEPT / ADAPT / DEFER / REDIRECT / DECLINE PRs: APPROVE / APPROVE_WITH_NOTES / MERGE_WITH_FIXES / REQUEST_CHANGES / REDIRECT / DECLINE
Severity (PR Review)
| 🔴 Blocker | 🟠 Major | 🟡 Minor | ✨ Praise (required) |
Bug Risk (Issue Triage)
| 🔴 Critical | 🟠 High | 🟡 Medium | 🟢 Low |
Commands
/iyu:issue <url | file | "text"> # Full triage
/iyu:issue <input> --quick # Decision only
/iyu:pr <pr-url | #number> # Full review
/iyu:pr <input> --quick # Blockers only
Converted and distributed by TomeVault — claim your Tome and manage your conversions.