reversa-spec-sdd

Decompose PRDs into component-level SDD markdown files with quality scores.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-spec-sdd-afsjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-spec-sdd
Source: https://github.com/afsjr/secretaria_escola_csm/tree/main/.agents/skills/reversa-spec-sdd
Command: npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-spec-sdd-afsjr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill converts a PRD into component-level SDD (Spec-Driven Development) documents, reducing ambiguity and rework by making requirements, acceptance criteria, edge cases, and quality gaps explicit before implementation.

Core Features & Use Cases

  • SDD decomposition from a PRD: Reads _reversa_sdd/prd.md, proposes logical components, and iterates until the decomposition is confirmed.
  • Spec drafting per component: Generates one SDD markdown file per confirmed component into _reversa_sdd/sdd/.
  • Automatic quality scoring and iteration: Runs scripts/spec_scorer.py when Python is available to score specs (0–100) and drive fixes until the score meets the threshold.
  • Optional modes (avulso): Can evaluate an existing spec or generate a single spec from user-provided input outside the main /reversa-new pipeline.
  • Strict formatting expectations: Ensures all spec items are marked with the required 🟡 PLANEJADO selo, and writes a final evaluation report into each generated file.

Quick Start

Run reversa-spec-sdd after generating a PRD with reversa-drafter (so that _reversa_sdd/prd.md exists), and then follow the component confirmation prompts until the specs are generated and scored.

Frequently Asked Questions about reversa-spec-sdd

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

FAQPage Schema
How do I decompose a PRD into spec-driven development documents?

Spec-driven development decomposition works by reading a product requirements document, proposing logical components, and iterating until confirmed. It then generates individual SDD markdown files with explicit acceptance criteria, edge cases, and quality gap analysis.

What is spec-driven development decomposition for product requirements?

Spec-driven development decomposition works by reading a product requirements document, proposing logical components, and iterating until confirmed. It then generates individual SDD markdown files with explicit acceptance criteria, edge cases, and quality gap analysis.

How do I generate SDD specs and score their quality automatically?

To generate SDD specs from a PRD, run the skill after your product requirements document exists at the required input path. Follow the component confirmation prompts to approve the decomposition, and the tool will draft, format, and score the specs automatically.

Can I evaluate an existing spec outside of the full project pipeline?

Yes, you can evaluate an existing spec or generate a single spec from provided input in standalone mode. This optional mode operates outside the main project pipeline, allowing you to independently score and analyze individual spec documents.

Do I need Python to run the spec quality scoring?

Python is required to run the spec quality scoring script, which evaluates specs on a 0–100 scale. If Python is not available, the skill will still generate the SDD markdown files but will skip the automated quality scoring and iteration loop.

What are the formatting requirements for SDD markdown files in this workflow?

SDD markdown files must include mandatory PLANEJADO markers for all spec items and contain a final evaluation report. This strict formatting ensures all requirements, edge cases, and quality gaps are explicitly tracked before handing off to the next development stage.