sdd-spec
Skill4 starsChanged 22 days agoMITView on GitHub
Redacta la especificación de una funcionalidad. Entrevista al usuario y produce specs/NNN-nombre/spec.md con requisitos RF en notación EARS, casos límite y lo que queda fuera. Usar cuando haya que definir qué se construye antes de planificarlo.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- svg153/skillstheir own version, first seen Nov 1, 2026
- PedroMosquera/squadaitheir own version, first seen Oct 13, 2026
- felipefontoura/pi-sdd-kittheir own version, first seen Oct 13, 2026
- khangpqvn/SDDADDtheir own version, first seen Sep 29, 2026
- callingcard1973/claude-skillstheir own version, first seen Apr 17, 2026
- Maicololiveras/praxisgenai-agent-orchestratortheir own version, first seen Mar 16, 2026
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- felipefontoura/pi-sdd-kit★ 36same name
- khangpqvn/SDDADD★ 12same name
- PedroMosquera/squadai★ 10same name
- Maicololiveras/praxisgenai-agent-orchestrator★ 1same name
- svg153/skills★ 1same name
- callingcard1973/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- core/AGENTS.mdAGENTS.md
- skills/sdd-init/templates/AGENTS.mdAGENTS.md
- skills/sdd-init/templates/CLAUDE.mdCLAUDE.md
- nombre-de-la-skillSkill
- handoffSkill
- sdd-changeSkill
- sdd-implementSkill
- sdd-initSkill
- sdd-planSkill
- sdd-validateSkill
The file
Files
<!-- Basado en hello-sdd de MoureDev (Apache-2.0), adaptado. Ver NOTICE. -->Especificar una funcionalidad
La spec es el contrato: lo que no está aquí, no se implementa. No escribas código. Una spec por funcionalidad.
Plantilla: spec-template.md en la carpeta de esta skill.
Proceso
- Lee las specs previas de
specs/para no contradecir lo ya acordado. - Entrevista sobre lo que falte: de una pregunta en una, máximo 6. Casos límite, errores y qué queda fuera. Si el usuario pregunta "¿cómo lo harías?", vuelve al qué: el cómo va en el plan.
- Número: el siguiente libre con tres dígitos,
specs/NNN-<nombre>/spec.md. - Redacta con la plantilla. Requisitos en EARS, numerados RF-1, RF-2… Cada uno verificable: si no sabes cómo comprobarlo, está mal escrito.
- Lo que no sepas se marca
[NECESITA ACLARACIÓN: pregunta]y se resuelve con el usuario antes de aprobar. Nunca se rellena inventando. - Aprobación. Con el sí del usuario, escribe
Estado: aprobada ◆1 (fecha)en la cabecera. Siguiente fase:sdd-plan.
Reglas
- Qué y por qué. Nada de stack, ficheros, esquemas ni funciones.
- Siempre una sección "Fuera de alcance".
- Un requisito, una frase. Sin adjetivos que no se puedan medir: "rápido" no es un requisito; "en menos de 200 ms", sí.
EARS
| Patrón | Forma |
| Ubicuo | EL SISTEMA <hará> |
| Evento | CUANDO <disparador>, EL SISTEMA <hará> |
| Estado | MIENTRAS <estado>, EL SISTEMA <hará> |
| Opcional | DONDE <característica>, EL SISTEMA <hará> |
| No deseado | SI <condición>, ENTONCES EL SISTEMA <hará> |
RF-4: SI el nombre ya existe, ENTONCES EL SISTEMA no creará un duplicado e informará del conflicto.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.