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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams convert informal notes and requirements into a structured Spec Driven Development (SDD) specification that can be implemented by an AI agent.

Core Features & Use Cases

  • Converts informal notes and requirements into an executable SDD specification with explicit triggers, domains, and acceptance criteria.
  • Enforces atomicity of requirements, maintains traceability through EXG/CA/CL identifiers, and supports a formal changelog.
  • Provides a guided workflow for cadrage, design, and documentation, including architecture and reference documents.

Quick Start

Provide a complete SPEC.md draft by answering cadrage questions, outlining functional domains, and drafting initial CA/CL entries.

Frequently Asked Questions about sdd-spec-write

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

FAQPage Schema
How do I convert informal notes into an executable AI spec?

You can convert informal notes into an executable AI spec by answering cadrage questions to outline functional domains, which generates a complete SPEC.md draft with explicit triggers and acceptance criteria.

What is Spec Driven Development and when do I need it?

Spec Driven Development is a methodology that transforms informal requirements into precise, testable specifications with traceability. You need it when building projects that require formal triggers, constraints, and acceptance criteria for AI agents.

How do I maintain traceability across SDD requirements?

You maintain traceability across SDD requirements by enforcing atomicity and using formal EXG, CA, and CL identifiers alongside a structured changelog to track specification updates.

Does SDD spec writing work without external dependencies?

Yes, SDD spec writing works without external dependencies, as it operates independently to generate structured specifications from your notes using internal grammar references like GRAMMAR.md.

What's the best way to draft acceptance criteria for AI agents?

The best way to draft acceptance criteria for AI agents is to use a guided cadrage workflow that enforces requirement atomicity and maps clear constraints across functional domains.

Why does my AI agent fail to execute unstructured project notes?

Your AI agent fails to execute unstructured notes because they lack precise triggers, constraints, and atomic acceptance criteria required for reliable implementation.