plan-triage

Sweeps unfinished change plans, verifies completeness against the live codebase, and archives completed ones.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/jakestrouse00/opencode-toolkit --skill plan-triage-jakestrouse00
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-triage
Source: https://github.com/jakestrouse00/opencode-toolkit/tree/main/skills/plan-triage
Command: npx skills add https://github.com/jakestrouse00/opencode-toolkit --skill plan-triage-jakestrouse00

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Over time a project's .opencode/plans/ folder accumulates unfinished change plans whose checkboxes no longer reflect reality — some plans are actually done but never archived, others are genuinely incomplete. Manually re-checking every plan against the live codebase is tedious and error-prone. ## Core Features & Use Cases - Batch completeness assessment: Re-verifies every unchecked step of every non-archived plan against the live tree using grep/read inspections, then runs each plan's own ## Verification block (tests, linters, or import checks documented in AGENTS.md). - Automatic archiving: Functionally complete plans get all steps ticked, Status: complete set, a Reconciled: note added, and are moved to .opencode/plans/archive/ with collision-safe naming. - Dry-run preview: A --dry-run flag reports which plans would be archived and why, without editing or moving any files. - Use Case: After a week of executing change plans, run a backlog sweep to discover that 4 of 9 open plans are actually complete, archive them, and get a table showing exactly which step or verification check failed for the remaining 5. ## Quick Start Ask the agent to triage the plan backlog with a dry run first, for example: "sweep my plans with plan-triage --dry-run and tell me which ones are done".

Frequently Asked Questions about plan-triage

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

FAQPage Schema
How do I check which change plans are already complete?

Run the plan-triage sweep, which re-verifies every unchecked step of each plan against the live codebase and runs the plan's own verification block. Plans passing both gates are reported as functionally complete and archived.

How do I preview plan archiving without changing files?

Pass the --dry-run flag, for example "plan-triage --dry-run". The skill performs the full assessment and prints the would-be-archived list with reasons, but makes no edits and moves no files.

Does plan-triage execute the edits described in a plan?

No. It only verifies whether each step's described edit is already present in the live tree and archives completed plans. Executing a plan's edits is the job of change-outline's EXECUTE mode.

Can plan-triage delete or modify source code?

No. It only edits plan markdown files and moves them into .opencode/plans/archive/. It never deletes plans, never touches source code, and never commits — archiving is a working-tree change the user commits themselves.

What happens when a plan's verification is uncertain?

The skill is conservative: if it cannot confidently judge whether an edit is present, it treats the step as failed and leaves the plan in place. The report lists it as left-incomplete with the failing gate and reason.