CAMAYOC

AI Engineering Framework

El método antes que el código.

Camayoc (quechua): el especialista responsable de una función. El quipucamayoc custodiaba el registro del estado del imperio.

Qué es

CAMAYOC es un framework de ingeniería de software asistida por IA. No genera código: gobierna el proceso por el cual se decide qué construir, se especifica con precisión, y recién entonces se implementa.

Se instala una vez y queda disponible en todos tus proyectos.

npm i -g @usuario/camayoc
camayoc init

CAMAYOC reconoce el proyecto —stack, si es nuevo o existente, qué convenciones ya tiene— y te lleva por el ciclo.

Por qué

Cuando escribir código era caro, el cuello de botella era teclear. Con IA teclear es gratis, y el cuello de botella se mudó a decidir qué construir y expresarlo sin ambigüedad.

Una especificación precisa la implementa cualquier agente. Una ambigua la implementan mal todos.

El ciclo

/dominio      glosario y modelo de dominio — la base de todo
    │
    ├─► /iterar        candidatos ordenados por riesgo · TÚ eliges el tajo
    │   /definir       reglas de negocio y casos de uso del tajo
    │   /disenar       arquitectura y diseño     ═══ compuerta ═══
    │   /spec          especificación con superficies declaradas
    │                  → revisor-consistencia    ═══ compuerta ═══
    │   /implementar   código contra la spec  → qa · seguridad
    │   /cerrar        corte: consolida decisiones
    └───────────────── siguiente iteración

/continuar    en cualquier momento: deriva dónde quedaste y qué sigue

Principios

| | | |---|---| | El humano decide | Ninguna compuerta se abre sola. La IA propone y ordena por riesgo; eliges tú. | | Iterativo, nunca cascada | No se define todo al inicio. Cada vuelta ataca el tajo más riesgoso. | | El estado se deriva | Dónde vamos se calcula mirando los artefactos. Un estado calculado no se desactualiza. | | Una superficie, una spec dueña | Cada spec declara qué posee. Nadie redefine lo ajeno. | | Se escribe en los cortes | Cero guardado por evento. CAMAYOC no te interrumpe para administrarse a sí mismo. | | Lo automático es determinista | Los hooks corren scripts, no modelos. Invocar la IA es siempre una decisión explícita. |

Los artefactos

camayoc/
├── dominio.md              glosario y modelo de dominio
├── superficies.json        índice: superficie → spec dueña
├── decisiones.md           qué se decidió y por qué
└── iteraciones/003-cupones/
    ├── tajo.md · definicion.md · diseno.md · spec.md · estado.json

Archivos planos, versionados con git. La existencia del archivo es el estado.

El problema de las specs que chocan

Dos specs que describen lo mismo con palabras distintas producen implementaciones que se contradicen. CAMAYOC lo previene por estructura: cada spec declara las superficies que posee (endpoints, tablas, módulos), una superficie tiene una sola dueña, y el agente revisor-consistencia bloquea el solapamiento antes de que llegue al código.

⚠ CHOQUE DE SUPERFICIE
  `tabla: cupones` ya la posee iteraciones/002-descuentos/spec
  → ¿editas la spec dueña, o acotas el alcance de esta?

Estado

En desarrollo · Fase 0 (contenido del kit). Ver docs/DEFINICION.md para el diseño completo.