Empieza aquí: tu primera feature
Propósito
Llevar una feature pequeña desde una carpeta vacía hasta un build verificado, un paso por página, para que aprendas el orden de los pasos de DIXI haciéndolos. Cada paso dice qué haces, qué deberías ver y qué viene después, y enlaza la referencia de cada comando que usa.
Qué vas a construir
Una herramienta de línea de comandos que guarda notas cortas con etiquetas, el mismo ejemplo de la guía de comandos. El repositorio tiene una versión terminada en examples/notes: ábrela cuando quieras comparar tu resultado.
Antes de empezar
- Python 3.11 o superior, en macOS o Linux. En Windows, usa WSL 2 con el proyecto bajo
~(matriz de soporte). - Uno de los agentes que DIXI soporta, o ninguno: los comandos se muestran para Claude Code, y cada paso dice cómo ejecutarlos con los demás adaptadores.
- Git, para hacer commit de tu trabajo. El agente nunca firma, empuja ni integra por ti.
| Adaptador | Agente | Cómo se ejecuta una operación |
|---|---|---|
--agent claude | Claude Code | /dixi.specify añadir una nota con etiquetas |
--agent codex | Codex CLI | $dixi-specify añadir una nota con etiquetas |
--agent skills | OpenCode, y otros agentes que leen Agent Skills (no verificados) | @dixi-specify añadir una nota con etiquetas |
--agent none | Cualquier agente o editor | dixi workflow prepare imprime el procedimiento y tú se lo das a tu agente |
Pasos
- Instalar el kit: instalar
dixiy comprobar su versión. - Crear el proyecto: la base documental y los comandos del agente.
- Especificar la feature: una historia y criterios de aceptación numerados con un ID.
- Planificarla: el contrato, el plan de pruebas y las decisiones que hay que validar.
- Dividirla en tareas: tareas pequeñas enlazadas a los criterios que cubren.
- Construir una tarea: primero pruebas que fallan, luego el código y luego
make verify. - Verificar la feature: cada criterio con la prueba que lo cubre.
Con un agente lleva más o menos una hora. Puedes parar después de cualquier paso y retomarlo más tarde: /dixi.status dice dónde lo dejaste.