GSD Planner

Creates executable phase plans with task breakdown, dependency graphs, and wave-based execution ordering.

Updated Mar 11, 2026
One-click install
npx skills add https://github.com/apsulli/gsd-extended --skill gsd-planner-apsulli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: GSD Planner
Source: https://github.com/apsulli/gsd-extended/tree/main/.agent/skills/planner
Command: npx skills add https://github.com/apsulli/gsd-extended --skill gsd-planner-apsulli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Solo developers working with AI assistants often get vague, oversized plans that degrade AI output quality mid-execution. This Skill turns project phases into small, executable PLAN.md files with specific tasks, verification criteria, and dependency-aware wave assignments. ## Core Features & Use Cases - Task Decomposition: Breaks phases into plans of 2-3 tasks each, with exact file paths, specific actions, executable verification commands, and measurable done criteria. - Dependency & Wave Analysis: Builds dependency graphs, groups independent plans into parallel execution waves, and prevents same-wave file conflicts. - Goal-Backward Verification: Derives must-have truths and artifacts from the phase goal so every plan is verifiable against the intended outcome. - Use Case: After finalizing a spec for a user authentication feature, invoke the planner to produce wave-structured PLAN.md files covering registration, login, and session handling, each with curl-based verification steps. ## Quick Start Ask the planner to create executable phase plans for the current phase defined in .gsd/SPEC.md with task breakdown and wave assignments.

Frequently Asked Questions about GSD Planner

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

FAQPage Schema
How do I break a project phase into executable AI plans?▼

Decompose the phase into plans of 2-3 tasks each, where every task specifies exact file paths, concrete actions with pitfalls to avoid, an executable verify command, and measurable done criteria. Group independent plans into the same execution wave.

What is goal-backward planning for software tasks?▼

Goal-backward planning starts from the done state by asking what must be true when the phase completes, then derives must-have truths and artifacts before decomposing them into dependency-ordered tasks. It produces verifiable requirements rather than ad-hoc task lists.

How many tasks should a single AI execution plan contain?▼

Keep plans to 2-3 tasks maximum, targeting completion within roughly 50% of the AI's context budget. Split plans when they exceed 3 tasks, touch more than 5 files per task, or cross multiple subsystems.

Can plans run in parallel without file conflicts?▼

Yes, by assigning plans to execution waves based on the dependency graph. Plans in the same wave must not modify the same files; if two plans need one file, move one to a later wave or split the file into separate modules.

When should I use a TDD plan structure?▼

Use TDD plans for complex business logic with edge cases, financial calculations, state machines, data transformation pipelines, and input validation rules. The plan follows Red, Green, Refactor phases with failing tests written first.

What are the limitations of AI-generated execution plans?▼

Plan quality degrades when tasks are too large or context usage exceeds roughly 50-70%, causing rushed output. Plans also require a finalized spec first, since the GSD methodology enforces planning lock before any code is written.