Skip to content

oliver-kriska/claude-elixir-phoenix / targets/dsh/skills/phx-triage

phx-triage

Verified

Triage review findings interactively — approve, skip, or prioritize each issue. Use after /phx-review to filter findings before fixing.

FileKindSize
SKILL.mdskill md3.6 KB
references/triage-patterns.mdmarkdown2.7 KB
---
name: phx-triage
description: Triage review findings interactively — approve, skip, or prioritize each
  issue. Use after /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

```
/phx-triage .claude/plans/user-auth/reviews/user-auth-review.md
/phx-triage                  # Uses most recent review
```

## Why Triage

After `/phx-review` produces findings, you have three options:

1. **Fix everything** — `/phx-plan .claude/plans/{slug}/reviews/...`
2. **Triage first** — `/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 — /phx-plan .claude/plans/{slug}/reviews/{slug}-triage.md
2. Fix directly — /phx-work (for simple fixes)
3. Review deferred items later
4. Capture solutions — /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 `/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
/phx-review
       |
/phx-triage  ← YOU ARE HERE (interactive filtering)
       |
/phx-plan (with triage file) → /phx-work → /phx-compound
```

## References

- `references/triage-patterns.md` — Common triage decisions
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall