spec

Convert BA session outputs into structured SDD documents with file schemas.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/anhtrinh919/claude-code-sdd --skill spec-anhtrinh919
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/anhtrinh919/claude-code-sdd/tree/main/skills/spec
Command: npx skills add https://github.com/anhtrinh919/claude-code-sdd --skill spec-anhtrinh919

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translates BA session outputs into structured SDD documents to establish a repeatable, verifiable contract for development teams.

Core Features & Use Cases

  • Three modes: New Project — creates mission.md, tech-stack.md, and roadmap.md and scaffolds living docs.
  • Phase Start — creates specs/YYYY-MM-DD-[feature]/ with requirements.md, plan.md, and validation.md.
  • Between-Phase — updates living docs, runs a changelog, and merges branches to reflect completed work.
  • Wiki integration reads relevant learnings from the wiki and writes new learnings at friction points to aid future sessions.

Quick Start

Provide a BA session input and run the spec workflow to generate the structured documents.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I turn BA session outputs into structured SDD documents?

You convert BA session outputs into structured SDD documents by providing the session input to the spec workflow. It processes the data and scaffolds living docs like mission.md, tech-stack.md, and roadmap.md to establish a verifiable development contract.

What is an SDD living docs workflow for phase management?

An SDD living docs workflow manages project evolution across New Project, Phase Start, and Between-Phase modes. It enforces concrete file schemas and updates documentation continuously to reflect completed work and merged branches.

How do I generate requirements and validation specs for a new feature phase?

You generate requirements and validation specs by triggering the Phase Start mode. This creates a dated feature directory containing requirements.md, plan.md, and validation.md files structured directly from your BA session data.

Does this spec-writing workflow support wiki integration for capturing learnings?

Yes, this spec-writing workflow supports wiki integration by reading relevant learnings before sessions and writing new learnings at friction points. This aids future BA sessions by maintaining a continuously updated knowledge base.

Can I use this to update living docs and run changelogs between development phases?

Yes, you can use the Between-Phase mode to update living docs and run a changelog. It automatically merges branches to reflect completed work, ensuring your project documentation stays aligned with the current codebase state.

What file schemas are enforced when creating SDD documentation?

The enforced file schemas include mission.md, tech-stack.md, and roadmap.md for new projects. For phase starts, it requires requirements.md, plan.md, and validation.md within a structured dated feature directory.