flow-triage

Recommends feature-dev or superpowers build flow for a ticket using a codebase scout, scorecard, and outcome ledger.

Updated Jul 19, 2026
One-click install
npx skills add https://github.com/forhas/pure-dev --skill flow-triage-forhas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flow-triage
Source: https://github.com/forhas/pure-dev/tree/main/plugins/notion-dev/skills/flow-triage
Command: npx skills add https://github.com/forhas/pure-dev --skill flow-triage-forhas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Choosing the right development workflow for a ticket is guesswork: pick too light a flow and a large task collapses under review, pick too heavy a flow and small tasks drown in ceremony. This Skill replaces that guesswork with an evidence-based recommendation grounded in the actual codebase and the repo's own history. ## Core Features & Use Cases - Codebase-aware scoring: A read-only scout agent probes the repo for affected files, existing patterns, and open questions, then a deterministic seven-dimension scorecard (blast radius, depth, ambiguity, novelty, risk, verification cost, plan shape) produces a 0–24 score mapped to feature-dev or superpowers. - Bug hard rule and forced flows: Tickets typed as bugs route unconditionally to superpowers, and callers can force a flow with --forced-flow, skipping the probe entirely. - Per-repo outcome ledger: Past triage decisions and outcomes are recorded in a JSONL ledger that breaks gray-zone ties, feeds a report-only drift check, and degrades gracefully when the scout fails. - Use Case: A developer runs "/notion-dev:flow-triage Add rate limiting to the API" and receives a scored recommendation with scout findings and a micro-plan sketch to hand to the chosen build flow. ## Quick Start Ask the assistant to triage a ticket by running /flow-triage followed by the ticket title and body, for example to decide whether a new feature should use feature-dev or superpowers.

Frequently Asked Questions about flow-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose between feature-dev and superpowers for a ticket?

Run the flow-triage skill with the ticket title and body. It probes the codebase with a read-only scout, scores seven dimensions such as blast radius and risk, and recommends feature-dev for scores of 9 or below and superpowers for 14 or above.

How does flow triage handle bug tickets?

Bug tickets route unconditionally to superpowers via a hard rule, since systematic debugging and TDD discipline matter more than speed on defects. Bug-ness comes from the --ticket-type flag when provided, otherwise it is inferred from defect language in the description.

What happens when the codebase scout agent fails?

The scout is retried once, then the run degrades: ambiguity, novelty, and risk are scored from the description alone, other dimensions become null, and the result is treated as a borderline gray zone. With --auto it recommends feature-dev and records the degradation.

Can I force a specific build flow instead of getting a recommendation?

Yes, pass --forced-flow=feature-dev or --forced-flow=superpowers to skip the scout probe and scoring entirely. The decision is still recorded in the ledger with confidence marked as forced unless --advise-only is set.

Where is the flow-triage outcome ledger stored?

The ledger lives at .claude/notion-dev/ledger.jsonl in the primary checkout of the target repository, never inside a feature worktree. It is an append-only JSONL file of decision and outcome events joined by run_id, with a self-ignoring gitignore created on first write.