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.