Modelado de Dominio
Construye y afina activamente el modelo de dominio del proyecto mientras diseñas. Esta es la disciplina activa: desafiar términos, inventar escenarios límite y escribir el glosario y las decisiones en el momento en que se cristalizan. (Simplemente leer CONTEXT.md para vocabulario no es esta habilidad — es un hábito de una línea que cualquier habilidad puede hacer. Esta habilidad es para cuando estás cambiando el modelo, no solo consumiéndolo.)
Estructura de archivos
La mayoría de los repositorios tienen un solo contexto:
/
├── CONTEXT.md
├── docs/
│ └── adr/
│ ├── 0001-ordenes-basadas-en-eventos.md
│ └── 0002-postgres-para-el-modelo-de-escritura.md
└── src/
Si existe un CONTEXT-MAP.md en la raíz, el repositorio tiene múltiples contextos. El mapa indica dónde vive cada uno:
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← decisiones de todo el sistema
├── src/
│ ├── ordering/
│ │ ├── CONTEXT.md
│ │ └── docs/adr/ ← decisiones específicas del contexto
│ └── billing/
│ ├── CONTEXT.md
│ └── docs/adr/
Crea archivos de forma perezosa — solo cuando tengas algo que escribir. Si no existe CONTEXT.md, créalo cuando se resuelva el primer término. Si no existe docs/adr/, créalo cuando se necesite la primera ADR.
Durante la sesión
Desafía contra el glosario
Cuando el usuario use un término que entre en conflicto con el lenguaje existente en CONTEXT.md, señálalo de inmediato. "Tu glosario define 'cancelación' como X, pero pareces referirte a Y — ¿cuál es?"
Afina el lenguaje vago
Cuando el usuario use términos vagos o sobrecargados, propón un término canónico preciso. "Estás diciendo 'cuenta' — ¿te refieres al Cliente o al Usuario? Son cosas diferentes."
Discute escenarios concretos
Cuando se discutan relaciones de dominio, pruébalas con escenarios específicos. Inventa escenarios que exploren casos límite y obliguen al usuario a ser preciso sobre los límites entre conceptos.
Cruza referencias con el código
Cuando el usuario indique cómo funciona algo, verifica si el código está de acuerdo. Si encuentras una contradicción, sácala a la luz: "Tu código cancela Órdenes completas, pero acabas de decir que es posible la cancelación parcial — ¿cuál es la correcta?"
Actualiza CONTEXT.md en línea
Cuando se resuelva un término, actualiza CONTEXT.md en ese momento. No los acumules — captúralos a medida que ocurren. Usa el formato en CONTEXT-FORMAT.md.
CONTEXT.md debe carecer por completo de detalles de implementación. No trates CONTEXT.md como una especificación, un bloc de notas ni un repositorio para decisiones de implementación. Es únicamente un glosario y nada más.
Ofrece ADRs con moderación
Solo ofrece crear una ADR cuando se cumplan las tres condiciones:
- Difícil de revertir — el costo de cambiar de opinión más tarde es significativo
- Sorprendente sin contexto — un lector futuro se preguntará "¿por qué lo hicieron así?"
- El resultado de una compensación real — hubo alternativas genuinas y elegiste una por razones específicas
Si falta alguna de las tres, omite la ADR. Usa el formato en ADR-FORMAT.md.