hello-sdd README

The project's README from github.com/mouredev/hello-sdd. As one markdown file: README.md.

Hello SDD: Curso de Spec-Driven Development (SDD) desde cero

Curso de Spec-Driven Development

Curso de MoureDev sobre Spec-Driven Development (SDD): desarrollar software con agentes de IA partiendo de una especificación acordada, en lugar de improvisar prompts.

Es indispensable ver el curso para entender el contenido del repositorio.

Contiene dos cosas: las plantillas usadas en el curso (samples/) y un proyecto completo construido paso a paso con SDD (habits-cli/).

HelloSDD/
├── samples/            # Plantillas y material del curso
│   ├── AGENTS.md       # Plantilla de instrucciones para el agente
│   ├── spec.md         # Plantilla de especificación (RF en notación EARS)
│   ├── prompts.md      # Prompt esencial de cada fase del flujo SDD
│   └── sdd.excalidraw  # Pizarra del curso (guion por bloques y diagramas)
└── habits-cli/         # Proyecto práctico desarrollado con SDD

samples/ — plantillas

Archivo Qué es
AGENTS.md Plantilla del archivo de contexto para el agente: qué es el proyecto, comandos, estilo, reglas y verificación obligatoria al terminar. CLAUDE.md puede limitarse a @AGENTS.md.
spec.md Plantilla de especificación: contexto, usuarios, historias, requisitos funcionales numerados (RF-x) en notación EARS, casos límite, fuera de alcance, criterios de finalización y dudas abiertas.
prompts.md Tabla con el prompt esencial de cada fase: constitución, spec, clarificación, plan, tareas, implementación, validación y cambio.
sdd.excalidraw Pizarra del curso: el guion por bloques (qué es SDD, vibe coding, tipos de SDD, EARS, flujo de trabajo, práctica…) y diagramas de cómo trabaja un agente. Se abre en excalidraw.com.

habits-cli/ — el proyecto con SDD

Una CLI en Python (solo biblioteca estándar) para registrar hábitos de estudio y ver la racha de días consecutivos: habits add, habits done y habits list.

Lo importante no es la app, sino cómo se construyó. Cada paso del flujo SDD dejó su artefacto en el repo:

Paso Artefacto
1. Constitución docs/constitution.md — 6 principios innegociables del proyecto
Contexto del agente AGENTS.md + CLAUDE.md
2. Especificación specs/001-habits-mvp/spec.md — RF-1 a RF-11 en notación EARS
3. Clarificación Revisión de la spec como QA: detecta ambigüedades y huecos antes de planificar
4. Planificación specs/001-habits-mvp/plan.md — módulos, modelo de datos, algoritmo de racha, contrato CLI y decisiones técnicas
5. Tareas specs/001-habits-mvp/tasks.md — T1 a T8 con checkboxes y su "Hecho cuando:"
6. Implementación habits/ (core + storage + cli) y tests/, una tarea cada vez y tests primero
7. Validación Recorrido RF por RF comprobando qué test cubre cada uno

Incluye además una skill reutilizable, spec-generator (.claude/skills/spec-generator/), que guía la entrevista de requisitos y genera la spec siguiendo la plantilla. Está enlazada también para opencode en .opencode/skill/.

Los prompts exactos de cada paso, y cómo ejecutar la app y sus tests, están en el README de habits-cli.

El flujo SDD en una línea

Constitución → Spec → Clarificación → Plan → Tareas → Implementación (una tarea cada vez, tests primero) → Validación → Cambio (primero la spec, luego el código).

https://mouredev.com Hola, mi nombre es Brais Moure.

YouTube Channel Subscribers Discord GitHub Followers GitHub Followers

Soy ingeniero de software desde 2010. Desde 2018 combino mi trabajo como desarrollador con la creación de contenido formativo y divulgativo sobre programación e IA en diferentes redes sociales como @mouredev.

Si quieres unirte a nuestra comunidad de desarrollo y aprender programación e inteligencia artificial, puedes encontrarme en:

Pro Link

hello-sdd (mouredev/hello-sdd)

Searching Database…

719 ·GitHub
Hello-sdd
What is this?This is MoureDev's course on Spec-Driven Development (SDD): building software with AI agents starting from an agreed specification instead of improvising prompts. The repo holds the course's reusable templates plus a complete example project built step by step using the SDD method.
Is this a course, a template kit, or a working app?All three: samples/ has reusable templates (AGENTS.md, spec.md, prompts.md), and habits-cli/ is a real, complete Python CLI built live as a teaching example of the SDD flow.
How do I follow the SDD flow with this repo?Copy the templates from samples/ (AGENTS.md, spec.md, prompts.md) into your own project and move through the stages: Constitution, Spec, Clarification, Plan, Tasks, Implementation, Validation, Change, using the matching prompt from prompts.md at each step.
Do I need to watch the course video first?Yes, the README states it's essential to watch the course to understand the repo, since the templates and the habits-cli example are explained there rather than fully documented in the README.
What does habits-cli actually do?It's a minimal Python CLI using only the standard library, with three commands (habits add, habits done, habits list) to log study habits and track a streak of consecutive days.
Who is this course for?Developers who already prompt AI coding agents and want to replace ad-hoc 'vibe coding' with a disciplined spec-first workflow for building real projects.
Where does the habits-cli example run?It's a plain Python standard-library CLI, so it runs anywhere Python runs, including Linux, macOS and Windows.
What artifact does each SDD step leave in the habits-cli example?Constitution produces docs/constitution.md; Specification produces specs/001-habits-mvp/spec.md with EARS-style numbered requirements; Planning produces plan.md; Tasks produces tasks.md with checkboxes; Implementation produces the habits/ code and tests/; Validation is a requirement-by-requirement review matching each RF to its test.
What is the spec-generator skill?A reusable Claude/opencode skill (.claude/skills/spec-generator/, also linked under .opencode/skill/) that interviews you about requirements and generates the spec.md file following the course's template.
What are similar projects?pstack, shuohao-skills, OpenSpec, pstack-claude, ouroboros, chinese-novelist-skill, explainer, Manware-s-AI-Learning-Toolkit
Which topics is it in?spanish, spec-driven-development, specification, templates, claude-code-skill, curriculum, opencode, prompt-engineering, skill, beginner-friendly, agentic-ai, learning-resources
Creator
mouredev
Size
0.1 MB
Stars
719
Updated
CommitAug 27
Age
1mo
Commits · 90 Days