plan-issue

Identify the highest-priority open issue and generate a detailed plan.

Updated Aug 27, 2026

Search Tags:#automation #workflow #planning #research #plan #project-management #issue-triage

Ready to run

npx skills add https://github.com/TrevorPLam/agency --skill plan-issue

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: plan-issue
Source: https://github.com/TrevorPLam/agency/tree/main/.windsurf/skills/plan-issue
Command: npx skills add https://github.com/TrevorPLam/agency --skill plan-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Researches and plans fixes for issues in the PLANNING state by producing a step-by-step resolution strategy that guards against duplication and misalignment.

Core Features & Use Cases

Automates triage by identifying the highest-priority open issue from tasks/issues.md.
Generates a detailed, prioritized plan with required context, recommended actions, and risk considerations.
Updates state and records plan artifacts to support governance and traceability.

Quick Start

Invoke plan-issue on an issue in the PLANNING state to generate a step-by-step resolution plan.

Frequently Asked Questions about plan-issue

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

FAQPage Schema

How do I automate issue triage and generate an actionable plan for my project?▼

You can automate issue triage by identifying the highest-priority open issue from tasks/issues.md and generating a detailed plan with actionable steps. The Skill conducts online research to inform the plan and creates a reasoning certificate to classify the change.

What is the best way to plan fixes for issues in a PLANNING state?▼

Planning fixes for issues in a PLANNING state involves producing a step-by-step resolution strategy that guards against duplication and misalignment. This Skill generates a prioritized plan with required context, recommended actions, and risk considerations.

Does the issue planning workflow support online research during plan generation?▼

Yes, the issue planning workflow supports online research during plan generation. It uses Cascade's web search to inform the plan, summarizes findings, and creates a reasoning certificate to classify the change as Local/Safe or Significant before updating the repository state.

How do I classify a planned change as Local/Safe or Significant in project management?▼

To classify a planned change as Local/Safe or Significant in project management, the Skill creates a reasoning certificate after generating the plan. It evaluates the issue context and recommended actions to determine the change classification and updates the repository state accordingly.

Can I use this workflow to update repository state after planning an issue?▼

Yes, you can use this workflow to update repository state after planning an issue. The Skill records plan artifacts to support governance and traceability, classifies the change, and updates the repository state to reflect the newly generated resolution strategy.

Why should I use automated issue triage instead of manual project management planning?▼

Automated issue triage identifies the highest-priority open issue and generates a detailed plan with risk considerations, guarding against duplication and misalignment. Manual project management planning lacks the integrated online research and reasoning certificate classification that ensures governance and traceability.