issue-scope

Decompose GitHub issues into scoped Markdown implementation plans.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/drdanmaggs/rocket-fuel --skill issue-scope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-scope
Source: https://github.com/drdanmaggs/rocket-fuel/tree/main/internal/plugin/skills/issue-scope
Command: npx skills add https://github.com/drdanmaggs/rocket-fuel --skill issue-scope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Brainstorm features into scoped implementation plans with test decomposition. This skill helps teams convert GitHub issues or user narratives into structured, edge-aware plan documents that align engineering work with test-driven development.

Core Features & Use Cases

  • Socratic questioning to refine requirements
  • Explore → Question → Approach → Decompose → Plan workflow that outputs a docs/plans/YYYY-MM-DD-<feature>.md
  • Generates plans that /tdd consumes directly, enabling rapid start of test-driven development

Quick Start

Provide a GitHub issue URL or user description to generate a scoped plan document at docs/plans/YYYY-MM-DD-<feature>.md for /tdd consumption.

Frequently Asked Questions about issue-scope

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

FAQPage Schema
How do I convert a GitHub issue into a testable implementation plan?

To convert a GitHub issue into a testable implementation plan, provide the issue URL or content to trigger Socratic questioning and decomposition, generating a scoped Markdown plan file at docs/plans/YYYY-MM-DD-feature.md ready for TDD.

What is issue decomposition for test-driven development?

Issue decomposition for test-driven development breaks down feature narratives into scoped, edge-aware plan documents. It uses an Explore, Question, Approach, Decompose, and Plan workflow to align engineering work with test generation.

Can I use a user description instead of a GitHub issue URL for feature planning?

Yes, you can use a user description instead of a GitHub issue URL for feature planning. The workflow accepts issue URLs, issue content, or raw user narratives to brainstorm and produce the implementation plan.

Does issue scoping output integrate directly with TDD workflows?

Yes, issue scoping output integrates directly with TDD workflows. The generated Markdown plan file is structured specifically for /tdd consumption, enabling a rapid start to test-driven development.

What is the best way to brainstorm features into scoped plan documents?

The best way to brainstorm features into scoped plan documents is applying Socratic questioning to refine requirements, which explores approaches and decomposes them into edge-aware Markdown files for engineering teams.

Do I need a specific environment to generate Markdown plan files for feature development?

You need a directory structure supporting docs/plans/ to store the generated Markdown plan files. The workflow outputs a date-stamped feature plan file directly into this path for subsequent test-driven development integration.