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…

727 ·GitHub
Hello-sdd
Что это?Это курс MoureDev о Spec-Driven Development (SDD): разработке ПО с ИИ-агентами, начиная с согласованной спецификации, вместо импровизации промптами. В репозитории лежат переиспользуемые шаблоны курса плюс полный пример проекта, построенного шаг за шагом методом 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) для записи учебных привычек и отслеживания серии подряд идущих дней.
Для кого этот курс?Для разработчиков, которые уже пишут промпты ИИ-агентам для кода и хотят заменить ситуативный «vibe coding» дисциплинированным воркфлоу «спецификация прежде всего» для создания реальных проектов.
Где запускается пример habits-cli?Это простой CLI на стандартной библиотеке Python, поэтому он работает везде, где работает Python, включая Linux, macOS и Windows.
Какой артефакт оставляет каждый шаг SDD в примере habits-cli?Constitution создаёт docs/constitution.md; Specification создаёт specs/001-habits-mvp/spec.md с нумерованными требованиями в стиле EARS; 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, beginner-friendly, agentic-ai, learning-resources
Creator
mouredev
Size
0.1 MB
Stars
727
Updated
CommitAug 27
Age
1mo
Commits · 90 Days