ss-sdd-writing-plans

Converts an approved SDD specification into a plan of bite-sized TDD tasks.

Updated May 19, 2026
One-click install
npx skills add https://github.com/Emrebener/Sublime-Skills --skill ss-sdd-writing-plans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ss-sdd-writing-plans
Source: https://github.com/Emrebener/Sublime-Skills/tree/main/skills/spec-driven-development/ss-sdd-writing-plans
Command: npx skills add https://github.com/Emrebener/Sublime-Skills --skill ss-sdd-writing-plans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing implementation plans from an approved specification is slow, error-prone, and often leaves downstream implementers guessing intent, file paths, and test/command details.

Core Features & Use Cases

  • Spec-to-plan rendering: Converts an approved spec into a detailed plan.md for direct execution by a per-task implementer subagent.
  • TDD-first task decomposition: Produces bite-sized tasks (2–5 minutes) organized by user story, with concrete tests, code, commands, and commit steps.
  • Safety and alignment guardrails: Enforces hard gates like no placeholders and no forbidden diagram syntax, and requires loading project context (constitution/ADRs/architecture/glossary) when available.

Quick Start

Use the ss-sdd-writing-plans skill during the plan-drafting stage to render the approved spec into docs/specs/NNN-<short-name>/plan.md with story-organized TDD tasks.

Frequently Asked Questions about ss-sdd-writing-plans

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

FAQPage Schema
How do I convert an approved specification into a TDD implementation plan?

You convert an approved specification into a TDD implementation plan by rendering the spec into a plan.md file containing bite-sized tasks organized by user story with concrete tests, code, and commit steps.

What is the best way to break down software specifications into executable TDD tasks?

Breaking down software specifications into executable TDD tasks involves decomposing the spec into 2–5 minute bite-sized tasks organized by user story, ensuring each task includes concrete file paths, commands, and test steps.

Do I need an approved specification before writing an implementation plan?

An approved SDD specification is required before writing an implementation plan, because the plan generation applies after spec commitment to support MVP-first delivery without re-deriving intent.

Can I use placeholders in my TDD implementation plans?

You cannot use placeholders in your TDD implementation plans, as the plan generation enforces hard constraints that prohibit placeholders and forbidden diagram syntaxes to prevent downstream implementers from guessing intent.

How to ensure implementation plans include concrete file paths and test commands?

You ensure implementation plans include concrete file paths and test commands by applying safety guardrails during spec-to-plan rendering that enforce hard gates requiring exact file paths and prohibiting ambiguous placeholders.

Why does my implementation plan need to load project context like architecture and ADRs?

An implementation plan needs to load project context like architecture and ADRs to align the generated TDD tasks with existing project constraints and definitions via optional context loading mechanisms.