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…

714 ·GitHub
Hello-sdd
这是什么？这是 MoureDev 的规格驱动开发（SDD）课程：用 AI 智能体构建软件时，从商定好的规格出发，而不是临时拼凑提示词。仓库保存了课程的可复用模板，外加一个用 SDD 方法逐步构建的完整示例项目。
这是课程、模板套件，还是一个能用的应用？三者都是：samples/ 提供可复用模板（AGENTS.md、spec.md、prompts.md），habits-cli/ 是一个真实完整的 Python CLI，作为 SDD 流程的教学示例现场构建而成。
如何借助这个仓库走完 SDD 流程？把 samples/ 中的模板（AGENTS.md、spec.md、prompts.md）复制到你自己的项目，然后依次推进各个阶段：Constitution、Spec、Clarification、Plan、Tasks、Implementation、Validation、Change，每一步使用 prompts.md 中对应的提示词。
需要先看课程视频吗？需要。README 指出必须观看课程才能理解这个仓库，因为模板和 habits-cli 示例都是在课程中讲解的，README 里并没有完整文档。
habits-cli 到底是做什么的？它是一个只使用标准库的极简 Python CLI，提供三个命令（habits add、habits done、habits list），用于记录学习习惯并追踪连续打卡的天数。
这门课面向谁？面向已经在用提示词驱动 AI 编程智能体、希望用规范优先的严谨工作流取代随性的“氛围编程”（vibe coding）、从而构建真实项目的开发者。
habits-cli 示例能在哪里运行？它是一个纯 Python 标准库 CLI，所以凡是能运行 Python 的地方都能运行，包括 Linux、macOS 和 Windows。
在 habits-cli 示例中，每个 SDD 步骤各留下什么产物？Constitution 产出 docs/constitution.md；Specification 产出带 EARS 风格编号需求的 specs/001-habits-mvp/spec.md；Planning 产出 plan.md；Tasks 产出带复选框的 tasks.md；Implementation 产出 habits/ 代码和 tests/；Validation 则是逐条需求审查，把每条 RF 与其测试一一对应。
spec-generator 技能是什么？一个可复用的 Claude/opencode 技能（.claude/skills/spec-generator/，在 .opencode/skill/ 下也有链接），它会就需求对你进行访谈，并按照课程的模板生成 spec.md 文件。
What are similar projects?pstack, shuohao-skills, OpenSpec, pstack-claude, ouroboros, chinese-novelist-skill, Manware-s-AI-Learning-Toolkit, explainer
Which topics is it in?spanish, spec-driven-development, specification, templates, claude-code-skill, curriculum, opencode, prompt-engineering, skill, agentic-ai, beginner-friendly, learning-resources
Creator
mouredev
Size
0.1 MB
Stars
714
Updated
CommitAug 27
Age
1mo
Commits · 90 Days