oliver-kriska/claude-elixir-phoenix / targets/pi/skills/phx-triage
phx-triage
VerifiedTriage review findings interactively — approve, skip, or prioritize each issue. Use after /skill:phx-review to filter findings before fixing.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.6 KB |
| references/triage-patterns.md | markdown | 2.7 KB |
SKILL.md
View on GitHub---
name: phx-triage
description: Triage review findings interactively — approve, skip, or prioritize each
issue. Use after /skill:phx-review to filter findings before fixing.
---
# Triage — Interactive Review Resolution
Walk through review findings one by one for human decision before
committing to fixes.
## Usage
```
/skill:phx-triage .claude/plans/user-auth/reviews/user-auth-review.md
/skill:phx-triage # Uses most recent review
```
## Why Triage
After `/skill:phx-review` produces findings, you have three options:
1. **Fix everything** — `/skill:phx-plan .claude/plans/{slug}/reviews/...`
2. **Triage first** — `/skill:phx-triage` (filter, then fix what matters)
3. **Handle manually** — Read review, pick what to fix yourself
Best when review has 5+ findings and you want to prioritize.
## Workflow
### Step 1: Load Review
Read the review file. Parse all findings with severity.
**Iron Law violations first**: list findings that match an Iron Law at the
top, recommended as "Fix it". The user still makes the call (Iron Law 6).
### Step 2: Present ALL Findings for Batch Selection
Use `AskUserQuestion` with `multiSelect: true`. Start with
severity shortcuts, then list individual findings:
```
AskUserQuestion:
question: "Which findings do you want to fix? (Iron Law violations auto-included)"
header: "Triage"
multiSelect: true
options:
- label: "All BLOCKERs ({count})"
description: "Fix all critical issues"
- label: "All WARNINGs ({count})"
description: "Fix all should-fix issues"
- label: "[BLOCKER] {title 1}"
description: "{file}:{line} — {brief description}"
- label: "[WARNING] {title 2}"
description: "{file}:{line} — {brief description}"
```
If >4 options, batch into groups of 4 with severity shortcuts in
the first batch. Severity shortcuts select all findings of that
level — user can mix shortcuts with individual picks.
**AskUserQuestion discipline**: decisions only — never use it to
narrate progress. Every option carries `{file}:{line}` + counts so
the user decides without opening the review file.
### Step 3: Gather Context on Selected Items
For selected items, ask ONE batch follow-up: "Any specific
approach for any of these?" If they say "just fix them", proceed.
### Step 4: Generate Triage Summary
Write to `.claude/plans/{slug}/reviews/{slug}-triage.md` with Fix Queue
(approved items with checkboxes), Skipped, and Deferred sections.
### Step 5: Present Next Steps
```
Triage complete: {n} to fix, {n} skipped, {n} deferred.
1. Plan fixes — /skill:phx-plan .claude/plans/{slug}/reviews/{slug}-triage.md
2. Fix directly — /skill:phx-work (for simple fixes)
3. Review deferred items later
4. Capture solutions — /skill:phx-compound (if patterns were solved)
```
## Iron Laws
1. **Batch selection over one-by-one** — Use multiSelect for efficiency
2. **User decides, not the agent** — Present facts, don't push
3. **BLOCKERs cannot be skipped silently** — Warn if user tries
4. **Capture user context** — Every "fix it" should include
any user guidance for better fixes
5. **Suggest compound after triage** — If triage reveals solved patterns
(root cause identified, fix known), mention `/skill:phx-compound`
6. **NEVER auto-decide severity or auto-dismiss findings** — the human assigns final priority; present the agent's severity as a recommendation, not a verdict
## Integration with Workflow
```text
/skill:phx-review
|
/skill:phx-triage ← YOU ARE HERE (interactive filtering)
|
/skill:phx-plan (with triage file) → /skill:phx-work → /skill:phx-compound
```
## References
- `references/triage-patterns.md` — Common triage decisions
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |