Bienvenido a CodexSpec¶
Un kit de herramientas de Spec-Driven Development (SDD) para Claude Code
CodexSpec es un kit de herramientas que te ayuda a construir software de alta calidad utilizando un enfoque estructurado basado en especificaciones. Invierte el script del desarrollo tradicional haciendo que las especificaciones sean artefactos ejecutables que guían directamente la implementación.
Por que CodexSpec?¶
Por que usar CodexSpec ademas de Claude Code? He aqui la comparacion:
| Aspecto | Solo Claude Code | CodexSpec + Claude Code |
|---|---|---|
| Soporte multilingue | Interaccion por defecto en ingles | Configura el idioma del equipo para mejor colaboracion |
| Trazabilidad | Dificil rastrear decisiones despues de la sesion | Todos los specs, planes y tareas guardados en .codexspec/specs/ |
| Recuperacion de sesion | Dificil recuperar de interrupciones en plan mode | Division en multiples comandos + docs persistentes = facil recuperacion |
| Gobernanza de equipo | Sin principios unificados, estilos inconsistentes | constitution.md aplica estandares y calidad del equipo |
Colaboracion Humano-AI¶
CodexSpec se basa en la creencia de que el desarrollo asistido por AI efectivo requiere participacion humana activa en cada etapa.
| Problema | Solucion |
|---|---|
| Requisitos poco claros | Q&A interactivo para aclarar antes de construir |
| Especificaciones incompletas | Comandos de revision dedicados con puntuacion |
| Planes tecnicos desalineados | Validacion basada en la constitucion |
| Desgloses de tareas vagos | Generacion de tareas con TDD aplicado |
Caracteristicas Clave¶
- Basado en Constitucion - Establece principios de proyecto que guian todas las decisiones
- Clarificacion Interactiva - Refinamiento de requisitos basado en Q&A
- Comandos de Revision - Valida artefactos en cada etapa
- Preparado para TDD - Metodologia test-first integrada en las tareas
- Soporte i18n - Mas de 13 idiomas mediante traduccion LLM
Inicio Rapido¶
# Instalar
uv tool install codexspec
# Crear un nuevo proyecto
codexspec init my-project
# O inicializar en un proyecto existente
codexspec init . --ai claude
Resumen del Flujo de Trabajo¶
Idea -> Clarificar -> Revisar -> Planificar -> Revisar -> Tareas -> Revisar -> Implementar
^ ^ ^
Chequeos humanos Chequeos humanos Chequeos humanos
Cada artefacto tiene un comando de revision correspondiente para validar la salida de AI antes de continuar.
Licencia¶
Licencia MIT - ver LICENSE para mas detalles.