CocinaME Constitution

Core Principles

I. Autoridad de las fuentes académicas

El comportamiento y el diseño del producto se definen en los artefactos académicos del submódulo academic/si525-assignments/:

Requisitos y restricciones del producto: los artefactos del SRS en academic/si525-assignments/degree-project/chapters/ch-4-segments/.
Comportamiento de los casos de uso: academic/si525-assignments/degree-project/chapters/ch-5-segments/use-cases/.
Interacciones y diseño UML: academic/si525-assignments/degree-project/assets/uml/puml/.
Decisiones de arquitectura e integración: los artefactos pertinentes del capítulo V en academic/si525-assignments/degree-project/chapters/ch-5-segments/.
academic/si525-assignments/ROADMAP-V1.md: la línea base aprobada de V1, con sus invariantes, su secuencia y sus decisiones pendientes.

II. Trazabilidad

Toda funcionalidad implementada DEBE poder rastrearse hasta los requisitos, casos de uso y artefactos de diseño que cubre.
Las specs DEBEN citar sus fuentes académicas por ruta e identificador, en lugar de copiarlas.
La cobertura parcial de un requisito o caso de uso DEBE registrarse como parcial.
Una funcionalidad terminada DEBE seguir siendo verificable frente a las fuentes que cita.

III. Sin invención silenciosa

Los agentes NO DEBEN inventar reglas de negocio, operaciones de dominio, relaciones, restricciones ni políticas para cubrir vacíos de las fuentes.
Si un comportamiento requerido está subespecificado, es contradictorio o no está resuelto, el trabajo sobre esa parte DEBE detenerse y la decisión DEBE plantearse de forma explícita. Las partes no afectadas pueden continuar.
Una spec con una pregunta abierta que cambia un resultado de negocio no está lista para implementar ese comportamiento.
Las decisiones pendientes de ROADMAP-V1.md NO DEBEN resolverse por conveniencia.

IV. Gestión de conflictos

Una spec, un plan o una implementación NO DEBE anular en silencio un requisito, un caso de uso, un artefacto UML ni un invariante aprobado del roadmap.
Ante un conflicto entre artefactos, DEBEN identificarse las fuentes en conflicto, registrarse una decisión humana y actualizarse los artefactos que esa decisión modifique antes de implementar la regla afectada.
El submódulo académico NO DEBE modificarse solo para justificar una decisión de implementación.

V. Spec primero

Cada incremento significativo DEBE contar con un spec.md aprobado antes de iniciar su implementación.
spec.md describe el comportamiento esperado, los actores, las restricciones, los criterios de aceptación y las exclusiones pertinentes.
Las decisiones técnicas de implementación corresponden a plan.md.
Las decisiones propias de una funcionalidad permanecen en su spec o su plan, nunca en esta constitución.

VI. Verificación antes de dar por terminado

Que exista código no significa que una funcionalidad esté terminada.
Darla por terminada exige la evidencia que define la spec: pruebas, verificación de contratos, migraciones, builds u otra verificación.
Los escenarios alternativos y de fallo que afectan la corrección DEBEN verificarse, no solo el camino feliz.

VII. Supervisión humana

El código, las specs, los planes y la documentación generados por agentes DEBEN ser revisados por una persona antes de aceptarse.
Los agentes asisten en el análisis, la implementación y la verificación. Las decisiones de arquitectura y de producto siguen siendo responsabilidad humana.

VIII. Desarrollo incremental

El trabajo DEBE avanzar en incrementos pequeños y trazables, no generando grandes partes del sistema de una sola vez.
La aplicación NO DEBE generarse directamente a partir de los artefactos UML. El UML es conceptual: una clase no equivale automáticamente a una tabla, un servicio ni una unidad desplegable.
Los incrementos DEBEN respetar el orden de dependencias y las condiciones de preparación establecidas en ROADMAP-V1.md.

IX. Artefactos históricos

Los diagramas y prototipos históricos o reemplazados NO DEBEN tratarse como autoridad vigente.
Los agentes DEBEN usar los artefactos activos que identifica ROADMAP-V1.md, no las representaciones monolíticas o de prototipo anteriores. El material histórico solo aporta contexto.

X. Secretos y sistemas externos

NO DEBEN versionarse secretos, credenciales ni llaves privadas.
El acceso a proveedores externos DEBE configurarse fuera del control de versiones.
La falta de credenciales DEBE informarse como un bloqueo; nunca se suple con configuración de producción inventada.
El acceso de agentes y herramientas a la infraestructura DEBE ser mínimo y revisado.

Flujo de trabajo

Especificar: spec.md cita sus fuentes académicas y enumera sus decisiones pendientes.
Aclarar: una persona resuelve cada decisión pendiente que cambia un resultado de negocio, o el comportamiento afectado se pospone.
Planificar: plan.md supera el Constitution Check antes de la investigación y nuevamente después del diseño.
Desglosar tareas: tasks.md incluye el trabajo de verificación que exige la spec.
Implementar y verificar: en incrementos pequeños, con revisión humana de cada resultado.

El estado de cada funcionalidad se registra en specs/README.md con los estados de seguimiento definidos en ROADMAP-V1.md. Todo cambio de estado DEBE respaldarse con evidencia. Ni el roadmap ni un contrato generado demuestran una implementación.

Governance

Esta constitución rige cómo se trabaja en este repositorio. El comportamiento del producto lo rigen las fuentes académicas (principio I).
Cada contenido tiene un único lugar de referencia y se enlaza, no se copia: el comportamiento del producto, en las fuentes académicas; el estado del producto, en specs/README.md; la memoria técnica, en AGENTS.md; y las decisiones de cada funcionalidad, en su spec o su plan.
Las enmiendas se realizan como un cambio a este archivo, con su justificación, y requieren aprobación humana.
El versionado sigue SemVer: MAJOR elimina o redefine un principio; MINOR agrega un principio o una sección, o amplía la guía de forma sustancial; PATCH aclara la redacción.
Un plan que no supera el Constitution Check requiere una decisión humana; los agentes NO DEBEN justificar la desviación por su cuenta.
AGENTS.md NO DEBE contradecir esta constitución.

Version: 1.0.0 | Ratified: 2026-10-05 | Last Amended: 2026-10-05