Danny019283

TDD Sdd — Development skill for Claude Code

Development community

Use-case-driven (SDD) and TDD harness for Claude Code and opencode.

How to install TDD Sdd

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Danny019283/tdd-sdd and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What TDD Sdd does

Use-case-driven (SDD) and TDD harness for Claude Code and opencode. Human-approved specs, red → green → review enforced by hooks, and specialized agents for drafting, developing, reviewing and troubleshooting.

Alternatives in Development

  • Developing — Developing Prisma Next skills 47.6k ★
  • Project-Level Skills — This directory contains skills for developing and maintaining the claude-mem project itself, not skills that a 39.3k ★
  • Writing — Writing — Figure Generation + Paper Drafting 613 ★

README

tdd-sdd

Harness para desarrollar con Claude Code (y opencode) guiado por **casos de uso (SDD)** y **TDD**, con bloqueo real por hooks.

Idea

  • El humano define un caso de uso (plantilla de 9 secciones) de forma interactiva → spec.md.
  • De la spec aprobada sale un plan.md con una checklist; cada check declara qué cubre y qué archivos puede tocar.
  • Por cada check: rojo → verde → parada de revisión → aprobación del revisor → commit. Los checks (refactor) parten de tests en verde y los (verificación) solo añaden pruebas; ver "Tipos de check".
  • Al completar la checklist y recibir /approve final, se permite el push.

La IA no puede aprobar nada: `/approve`, `/override` y `/refactor` solo los procesa el hook `UserPromptSubmit` (mensajes del humano).

Estructura

Paquete Rol
packages/core Lógica pura: validación de spec, plan.md, ciclo, reglas allow/deny
packages/cli Estado en disco, comandos (init, test, review…), manejador de hooks, build del binario
packages/adapter-claude Plugin de Claude Code: hooks, comandos, skills, binario empaquetado
packages/adapter-opencode Plugin de opencode sobre el mismo núcleo

Reglas que hace cumplir

Regla Qué bloquea
PRODUCTION_REQUIRES_RED_TEST Editar código de producción sin test en rojo
OUT_OF_SCOPE Editar archivos fuera de la lista del check actual
TESTS_FROZEN_AFTER_GREEN / TESTS_FROZEN_IN_REFACTOR Tocar tests tras verde o durante refactor
SPEC_FROZEN / PLAN_FROZEN / CONFIG_FROZEN / HARNESS_FILE_PROTECTED Editar spec/plan/config aprobados o el estado del harness
ROLE_NOT_ALLOWED approve-check fuera del agente revisor, o amend-files fuera del solucionador
COMMIT_REQUIRES_APPROVAL Commit sin check aprobado por el humano
STOP_REQUIRES_REVIEW Terminar en verde sin la parada de revisión
PUSH_REQUIRES_COMPLETE_PLAN / PUSH_REQUIRES_FINAL_APPROVAL Push anti