plan-spec

Generates structured feature specifications and implementation plans from briefs with traceability matrices.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/nixlim/claude-skill-plan-spec --skill plan-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-spec
Source: https://github.com/nixlim/claude-skill-plan-spec/tree/main/.claude/skills/plan-spec
Command: npx skills add https://github.com/nixlim/claude-skill-plan-spec --skill plan-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Planning features and writing specifications is often manual, error-prone, and disconnected from implementation. This skill provides a structured approach to produce complete, implementation-ready specs with traceability from user stories to tests.

Core Features & Use Cases

  • Generates end-to-end feature specifications with Phase-driven workflows (Discovery, User Stories, BDD Scenarios, TDD Plan, Requirements, Output).
  • Embeds BDD and TDD practices, including a traceability matrix linking requirements to tests.
  • Produces reusable templates and sample outputs to accelerate standardization.

Quick Start

Describe your feature brief or attach a Markdown brief; the skill will generate a complete spec ready to review.

Frequently Asked Questions about plan-spec

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

FAQPage Schema
How do I generate testable feature specifications from a brief?

To generate testable feature specifications, describe your feature brief or attach a Markdown file. The skill automates discovery, user stories, BDD scenarios, and TDD plans to produce an implementation-ready spec document with validation datasets.

How does BDD scenario generation work for user stories?

BDD scenario generation maps user stories into structured, behavior-driven tests. The skill embeds BDD practices within its phase-driven workflow, ensuring each scenario enforces measurable success criteria and links directly to requirements.

Can I use this to create a traceability matrix linking requirements to tests?

Yes, you can create a traceability matrix linking requirements to tests. The skill automates the matrix generation alongside TDD plans, ensuring every requirement is validated by a corresponding test and tracked through the output document.

Do I need to write Markdown briefs to start the specification planning process?

You need to provide a feature brief to start the specification planning process. You can either describe the brief directly in text or attach an existing Markdown brief, which the skill will use to drive the discovery and output phases.

What's the best way to automate TDD plan creation for new features?

The best way to automate TDD plan creation is to input your feature brief into the skill. It processes the brief through a phase-driven workflow, generating testable plans and reusable templates that enforce measurable success criteria for implementation.

Why are my feature specs disconnected from the actual implementation?

Feature specs are often disconnected from implementation when lacking traceability. This skill solves that by generating a traceability matrix linking user stories and BDD scenarios directly to TDD plans and requirements within a single document.