plan-issue

Convert GitHub issue or markdown feature specs into ordered file-level implementation checklists.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/N0K0/claude-plugins-backalley --skill plan-issue-n0k0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-issue
Source: https://github.com/N0K0/claude-plugins-backalley/tree/main/plugins/process/skills/plan-issue
Command: npx skills add https://github.com/N0K0/claude-plugins-backalley --skill plan-issue-n0k0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually converting feature specifications from GitHub issues or local markdown files into ordered, file-level implementation tasks is slow, error-prone, and often misses dependencies or correct task sequencing.

Core Features & Use Cases

  • Dual mode support: Works with both GitHub Issues (GH mode) and local markdown spec files (local mode) to match existing development workflows.
  • Built-in validation: Runs entry gate checks to avoid duplicate checklists and ensures specs are fully ready for implementation before proceeding.
  • Quality assurance: Includes an internal review loop to catch vague tasks, misordered dependencies, and missing files before presenting the checklist for approval.
  • Use case: For a GitHub issue labeled has-spec, this skill generates a step-by-step checklist of concrete file changes ordered by dependency, ready for the execute-issue skill to work through.

Quick Start

Use the plan-issue skill to break down GitHub issue 123 into an implementation checklist.

Frequently Asked Questions about plan-issue

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

FAQPage Schema
How do I convert a GitHub issue into an actionable implementation checklist?

To convert a GitHub issue into an implementation checklist, this skill reads feature specifications from issues labeled has-spec and generates ordered, file-level tasks. It outputs concrete file changes sequenced by dependency for direct execution.

Can I use local markdown spec files for codebase task generation instead of GitHub Issues?

Yes, you can use local markdown spec files for codebase task generation through local mode. This dual-mode support processes local specifications identically to GitHub Issues, producing file-level implementation checklists.

How do you break down feature specifications into ordered file-level implementation tasks?

Breaking down feature specifications relies on an internal review loop that catches vague tasks and misordered dependencies. It validates specs and generates ordered, file-level implementation tasks grouped by dependency for accurate sequencing.

Does plan-issue validate specs before generating an implementation checklist?

Yes, plan-issue validates specs before generating an implementation checklist by running entry gate checks. This prevents duplicate checklists and ensures the specification is fully ready for implementation before proceeding.

What happens if my spec contains vague tasks or misordered dependencies?

If your spec contains vague tasks or misordered dependencies, the internal quality assurance loop catches these issues. It refines the specification breakdown to ensure concrete actionable items and correct task sequencing before approval.

How do I avoid duplicate checklists when planning GitHub issues?

To avoid duplicate checklists when planning GitHub issues, the skill applies built-in entry gate validation. This mechanism checks existing checklists against the current spec before generating new file-level implementation tasks.