skills.rest
nico0695
nico0695COMMUNITY
Explore all skills by this author →
GitHub

sddl-spec

Formalizes proposal.md into spec.md with scope boundaries and acceptance criteria.

Updated Apr 2, 2026
Search Tags:#state management#specification#acceptance criteria#spec-driven development#sdd-lite#scope boundary#proposal formalization
One-click install
npx skills add https://github.com/nico0695/ai-tools --skill sddl-spec-nico0695
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sddl-spec
Source: https://github.com/nico0695/ai-tools/tree/main/sdd/sdd-lite/skills/sddl-spec
Command: npx skills add https://github.com/nico0695/ai-tools --skill sddl-spec-nico0695

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough change proposal into a contract that design, execution, and QA stages can validate against is error-prone when done ad hoc. This Skill formalizes proposal.md into a definitive spec.md with firm scope boundaries, acceptance criteria, and tracked open questions. ## Core Features & Use Cases - Inbound Contract Enforcement: Validates proposal_status, Readiness Check gates, and migrates every Open Questions For Spec row into the spec before formalizing. - Proportional Specification: Produces a minimal spec when all readiness gates are clear and the change touches a single surface, otherwise a full artifact. - State Synchronization: Updates state.yaml with stage status, open risks, checkpoints, and the next safe action toward sddl-design. - Use Case: After the sddl-proposal stage approves a change framing, run this stage to produce a compact spec.md that sddl-design can consume without re-reading broad evidence. ## Quick Start Run the sddl-spec stage to formalize the current change's proposal.md into spec.md with scope boundaries and acceptance criteria.

Frequently Asked Questions about sddl-spec

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

FAQPage Schema
How do I turn a change proposal into a formal specification?▼

Run the sddl-spec stage after sddl-proposal marks proposal_status as ready. It reads proposal.md, migrates open questions, defines scope boundaries and acceptance criteria, and writes spec.md plus an updated state.yaml.

What happens if the proposal is not ready for specification?▼

The stage returns blocked when proposal_status is needs-input or blocked, or when a high-severity readiness gate is still raised. It names the blocking precondition instead of formalizing an unstable framing.

When does sddl-spec produce a minimal spec instead of a full one?▼

A minimal spec with only scope boundary and acceptance criteria is produced when all three Readiness Check gates are clear and the scope sketch touches a single surface such as one module, endpoint, or form.

Does sddl-spec handle open questions from the proposal stage?▼

Yes. Every row in the proposal's Open Questions For Spec table must appear in the spec's Open Questions And Decisions section, either marked resolved or assigned a Needed Before value of design or execution.

What are the limitations of the sddl-spec stage?▼

It does not redefine problem framing, produce technical designs, or create execution plans. It only writes spec.md and state.yaml inside the sdd-lite directory and cannot make a change execution-ready on its own.

Related Skills

Explore More Software Engineering Skills→
nico0695nico0695

sddl-proposal

Generates a lightweight proposal.md framing problem, scope, and feasibility for spec-driven changes.

Community
Advanced
sofersofer

spec

Generate precise specifications with contracts, schemas, and acceptance criteria for a user story.

Community
Advanced
a35506322a35506322

grill-with-docs

Stress-test project plans against domain documentation, codebase, and ADRs.

Community
Intermediate
rbaumierrbaumier
4

brainstorming

Guide teams through structured ideation and design validation with formal specifications.

Community
Advanced