@kal-elsam/kairo-runtime 0.1.0

package/repo-template/docs/ai/ui.md

@@ -0,0 +1,17 @@
+# UI
+
+## Sistema de diseño
+
+- Componentes base: [BASE_COMPONENTS]
+- Design system: [DESIGN_SYSTEM]
+- Estilos: [STYLING_APPROACH]
+
+## Reglas
+
+- Mobile-first.
+- Accesibilidad obligatoria.
+- No colores hardcodeados si existen tokens.
+- No estilos inline salvo justificación.
+- Usar componentes base.
+- Separar UI de lógica de negocio.
+- Estados: loading, empty, error, success.

package/repo-template/docs/skills/adapter-parity-review.md

@@ -0,0 +1,46 @@
+# Adapter Parity Review
+
+## Cuándo usar
+
+Cuando agregues, modifiques o evalúes soporte para OpenCode, Cursor, Codex, Claude, Gemini, Pi o cualquier otro adapter.
+
+## Fuente de verdad
+
+- `docs/ai/adapter-parity.md`
+- `docs/ai/tool-adapters.md`
+- `docs/ai/governance.md`
+- `AGENTS.md`
+
+## Procedimiento
+
+1. Verificar que el core universal no se duplique.
+2. Verificar que el adapter apunte a `AGENTS.md`.
+3. Confirmar soporte para SDD.
+4. Confirmar soporte para TDD.
+5. Confirmar soporte para evals si aplica.
+6. Confirmar soporte para checkpoint/review.
+7. Confirmar soporte para loop engineering si aplica.
+8. Confirmar que el adapter no se declara fuente principal.
+9. Documentar limitaciones.
+
+## Checklist
+
+- [ ] No contradice `AGENTS.md`
+- [ ] No duplica reglas largas
+- [ ] Tiene path claro para SDD
+- [ ] Tiene path claro para TDD
+- [ ] Tiene path claro para evals
+- [ ] Tiene path claro para checkpoint
+- [ ] Tiene path claro para model routing
+- [ ] Tiene path claro para human approval
+- [ ] Limitaciones documentadas
+
+## Output
+
+```txt
+Adapter:
+Capabilities:
+Missing capabilities:
+Conflicts:
+Recommended changes:
+```

package/repo-template/docs/skills/api-design.md

@@ -0,0 +1,37 @@
+# API Design
+
+## Cuándo usar
+
+Endpoints, contratos e integraciones.
+
+## Fuente de verdad
+
+`docs/ai/api.md`
+
+## Procedimiento
+
+1. Leer fuente de verdad.
+2. Identificar alcance.
+3. Crear/actualizar spec si el cambio no es trivial.
+4. Crear test/eval si cambia comportamiento.
+5. Implementar solo el scope necesario.
+6. Validar pipeline.
+7. Reportar riesgos y cambios.
+
+## Checklist
+
+- [ ] Contexto mínimo leído
+- [ ] Scope claro
+- [ ] Tests/evals aplican o se justifica omisión
+- [ ] Pipeline validado
+- [ ] Riesgos reportados
+
+## Output esperado
+
+```txt
+Contexto leído:
+Cambios realizados:
+Validación:
+Riesgos:
+Siguiente acción:
+```

package/repo-template/docs/skills/architecture.md

@@ -0,0 +1,37 @@
+# Architecture
+
+## Cuándo usar
+
+Cambios estructurales, ADRs, límites de módulos.
+
+## Fuente de verdad
+
+`docs/ai/architecture.md`
+
+## Procedimiento
+
+1. Leer fuente de verdad.
+2. Identificar alcance.
+3. Crear/actualizar spec si el cambio no es trivial.
+4. Crear test/eval si cambia comportamiento.
+5. Implementar solo el scope necesario.
+6. Validar pipeline.
+7. Reportar riesgos y cambios.
+
+## Checklist
+
+- [ ] Contexto mínimo leído
+- [ ] Scope claro
+- [ ] Tests/evals aplican o se justifica omisión
+- [ ] Pipeline validado
+- [ ] Riesgos reportados
+
+## Output esperado
+
+```txt
+Contexto leído:
+Cambios realizados:
+Validación:
+Riesgos:
+Siguiente acción:
+```

package/repo-template/docs/skills/code-review.md

@@ -0,0 +1,37 @@
+# Code Review
+
+## Cuándo usar
+
+Revisión técnica antes de merge o checkpoint.
+
+## Fuente de verdad
+
+`docs/ai/conventions.md`
+
+## Procedimiento
+
+1. Leer fuente de verdad.
+2. Identificar alcance.
+3. Crear/actualizar spec si el cambio no es trivial.
+4. Crear test/eval si cambia comportamiento.
+5. Implementar solo el scope necesario.
+6. Validar pipeline.
+7. Reportar riesgos y cambios.
+
+## Checklist
+
+- [ ] Contexto mínimo leído
+- [ ] Scope claro
+- [ ] Tests/evals aplican o se justifica omisión
+- [ ] Pipeline validado
+- [ ] Riesgos reportados
+
+## Output esperado
+
+```txt
+Contexto leído:
+Cambios realizados:
+Validación:
+Riesgos:
+Siguiente acción:
+```

package/repo-template/docs/skills/context-graph.md

@@ -0,0 +1,38 @@
+# Context Graph
+
+## Cuándo usar
+
+Uso de Engram/Graphify, memoria y grafo contextual.
+
+## Fuente de verdad
+
+- Grafo/Graphify: `docs/ai/context-graph.md`
+- Memoria/Engram: `docs/ai/memory.md`
+
+## Procedimiento
+
+1. Leer fuente de verdad.
+2. Identificar alcance.
+3. Crear/actualizar spec si el cambio no es trivial.
+4. Crear test/eval si cambia comportamiento.
+5. Implementar solo el scope necesario.
+6. Validar pipeline.
+7. Reportar riesgos y cambios.
+
+## Checklist
+
+- [ ] Contexto mínimo leído
+- [ ] Scope claro
+- [ ] Tests/evals aplican o se justifica omisión
+- [ ] Pipeline validado
+- [ ] Riesgos reportados
+
+## Output esperado
+
+```txt
+Contexto leído:
+Cambios realizados:
+Validación:
+Riesgos:
+Siguiente acción:
+```

package/repo-template/docs/skills/debugging.md

@@ -0,0 +1,37 @@
+# Debugging
+
+## Cuándo usar
+
+Bugs, errores, fallas y comportamiento inesperado.
+
+## Fuente de verdad
+
+`docs/ai/testing.md`
+
+## Procedimiento
+
+1. Leer fuente de verdad.
+2. Identificar alcance.
+3. Crear/actualizar spec si el cambio no es trivial.
+4. Crear test/eval si cambia comportamiento.
+5. Implementar solo el scope necesario.
+6. Validar pipeline.
+7. Reportar riesgos y cambios.
+
+## Checklist
+
+- [ ] Contexto mínimo leído
+- [ ] Scope claro
+- [ ] Tests/evals aplican o se justifica omisión
+- [ ] Pipeline validado
+- [ ] Riesgos reportados
+
+## Output esperado
+
+```txt
+Contexto leído:
+Cambios realizados:
+Validación:
+Riesgos:
+Siguiente acción:
+```

package/repo-template/docs/skills/eval-design.md

@@ -0,0 +1,12 @@
+# eval-design
+
+Create golden, schema, tool-call and regression evals using docs/ai/eval-strategy.md.
+
+## Output
+
+```txt
+Decision:
+Evidence:
+Risks:
+Required changes:
+```

package/repo-template/docs/skills/evals.md

@@ -0,0 +1,37 @@
+# AI Evals
+
+## Cuándo usar
+
+Cambios de prompts, agentes, tool calling o RAG.
+
+## Fuente de verdad
+
+`docs/ai/evals.md`
+
+## Procedimiento
+
+1. Leer fuente de verdad.
+2. Identificar alcance.
+3. Crear/actualizar spec si el cambio no es trivial.
+4. Crear test/eval si cambia comportamiento.
+5. Implementar solo el scope necesario.
+6. Validar pipeline.
+7. Reportar riesgos y cambios.
+
+## Checklist
+
+- [ ] Contexto mínimo leído
+- [ ] Scope claro
+- [ ] Tests/evals aplican o se justifica omisión
+- [ ] Pipeline validado
+- [ ] Riesgos reportados
+
+## Output esperado
+
+```txt
+Contexto leído:
+Cambios realizados:
+Validación:
+Riesgos:
+Siguiente acción:
+```

package/repo-template/docs/skills/git-workflow.md

@@ -0,0 +1,37 @@
+# Git Workflow
+
+## Cuándo usar
+
+Commits, pipeline y checkpoint.
+
+## Fuente de verdad
+
+`docs/ai/git-workflow.md`
+
+## Procedimiento
+
+1. Leer fuente de verdad.
+2. Identificar alcance.
+3. Crear/actualizar spec si el cambio no es trivial.
+4. Crear test/eval si cambia comportamiento.
+5. Implementar solo el scope necesario.
+6. Validar pipeline.
+7. Reportar riesgos y cambios.
+
+## Checklist
+
+- [ ] Contexto mínimo leído
+- [ ] Scope claro
+- [ ] Tests/evals aplican o se justifica omisión
+- [ ] Pipeline validado
+- [ ] Riesgos reportados
+
+## Output esperado
+
+```txt
+Contexto leído:
+Cambios realizados:
+Validación:
+Riesgos:
+Siguiente acción:
+```

package/repo-template/docs/skills/look-trust-review.md

@@ -0,0 +1,12 @@
+# look-trust-review
+
+Review skills, tools, plugins, MCPs and packages using docs/ai/trust-policy.md.
+
+## Output
+
+```txt
+Decision:
+Evidence:
+Risks:
+Required changes:
+```

package/repo-template/docs/skills/loop-debugging.md

@@ -0,0 +1,16 @@
+# Loop Debugging
+
+## Cuándo usar
+
+Cuando un loop se atasca, repite fixes, incrementa errores o no converge.
+
+## Procedimiento
+
+1. Detener el loop si alcanzó límites.
+2. Revisar errores repetidos.
+3. Comparar diff entre iteraciones.
+4. Identificar si cambió el scope.
+5. Revisar tests/evals fallidas.
+6. Escalar a Debugger/modelo fuerte si aplica.
+7. Proponer rollback o cambio mínimo.
+8. Documentar causa raíz.

package/repo-template/docs/skills/loop-design.md

@@ -0,0 +1,39 @@
+# Loop Design
+
+## Cuándo usar
+
+Cuando se diseña un workflow repetible para agentes.
+
+## Fuente de verdad
+
+- `docs/ai/loops.md`
+- `docs/ai/loop-policy.md`
+- `docs/ai/provider-routing.md`
+
+## Procedimiento
+
+1. Definir objetivo del loop.
+2. Definir input y estado inicial.
+3. Definir pasos permitidos.
+4. Definir herramientas permitidas.
+5. Definir intentos máximos.
+6. Definir señales de éxito/fallo.
+7. Definir escalación.
+8. Definir rollback.
+9. Definir logs.
+10. Validar con humano si toca producción, DB, auth, pagos o seguridad.
+
+## Output esperado
+
+```txt
+Loop:
+Input:
+Steps:
+Tools:
+Max attempts:
+Success:
+Failure:
+Escalation:
+Rollback:
+Observability:
+```

package/repo-template/docs/skills/loop-retrospective.md

@@ -0,0 +1,15 @@
+# Loop Retrospective
+
+## Cuándo usar
+
+Después de loops fallidos, costosos o repetidos.
+
+## Procedimiento
+
+1. Revisar métricas del loop.
+2. Identificar patrón de fallo.
+3. Determinar si faltó contexto, spec, test, eval o permiso.
+4. Actualizar documentación si aplica.
+5. Actualizar evals si hubo fallo IA.
+6. Registrar aprendizaje para Engram.
+7. Actualizar grafo en Graphify si cambió arquitectura o dependencia.

package/repo-template/docs/skills/loop-review.md

@@ -0,0 +1,16 @@
+# Loop Review
+
+## Cuándo usar
+
+Antes de aceptar el resultado de un loop.
+
+## Procedimiento
+
+1. Revisar objetivo original.
+2. Revisar spec o task.
+3. Revisar archivos modificados.
+4. Revisar tests/evals ejecutadas.
+5. Revisar intentos y reparaciones.
+6. Revisar scope creep.
+7. Revisar riesgos.
+8. Emitir resultado: approve, changes required, rollback.

package/repo-template/docs/skills/maintainability-review.md

@@ -0,0 +1,12 @@
+# maintainability-review
+
+Review diff quality using docs/ai/maintainability-gates.md.
+
+## Output
+
+```txt
+Decision:
+Evidence:
+Risks:
+Required changes:
+```

package/repo-template/docs/skills/model-selection.md

@@ -0,0 +1,36 @@
+# Model Selection
+
+## Cuándo usar
+
+Cuando una tarea pueda ejecutarse con diferentes modelos o proveedores.
+
+## Fuente de verdad
+
+- `docs/ai/model-policy.md`
+- `docs/ai/provider-routing.md`
+
+## Procedimiento
+
+1. Clasificar riesgo de la tarea.
+2. Determinar si el resultado es verificable con tests/evals.
+3. Usar modelo económico para tareas mecánicas/verificables.
+4. Usar modelo fuerte para decisiones ambiguas, críticas o arquitectónicas.
+5. Escalar a humano si hay impacto crítico.
+
+## Checklist
+
+- [ ] Riesgo clasificado
+- [ ] Modelo seleccionado
+- [ ] Validación automática disponible
+- [ ] Escalación definida si falla
+
+## Output esperado
+
+```txt
+Tarea:
+Riesgo:
+Modelo recomendado:
+Razón:
+Validación:
+Escalación:
+```

package/repo-template/docs/skills/quality-gate-review.md

@@ -0,0 +1,12 @@
+# quality-gate-review
+
+Run quality gates from docs/ai/quality-gates.md and block on critical failure.
+
+## Output
+
+```txt
+Decision:
+Evidence:
+Risks:
+Required changes:
+```

package/repo-template/docs/skills/spec-complexity-classifier.md

@@ -0,0 +1,41 @@
+# Spec Complexity Classifier
+
+## When to use
+
+Use before creating or implementing a spec.
+
+## Source of truth
+
+- `docs/ai/spec-sizing.md`
+- `docs/ai/spec-intake.md`
+- `docs/ai/spec-escalation.md`
+
+## Procedure
+
+1. Summarize the requested change.
+2. Score the task using the complexity scoring table.
+3. Check hard triggers.
+4. Choose basic, standard or complex.
+5. Explain why.
+6. Select the right spec template.
+7. Identify validation requirements.
+8. Identify approval requirements.
+
+## Output
+
+```txt
+Requested change:
+Score:
+Hard triggers:
+Recommended spec level:
+Reason:
+Template:
+Validation required:
+Approval required:
+Next action:
+```
+
+## Rule
+
+Use the smallest safe spec.
+Escalate immediately when risk increases.

package/repo-template/docs/skills/spec-escalation-review.md

@@ -0,0 +1,34 @@
+# Spec Escalation Review
+
+## When to use
+
+Use when implementation reveals higher risk than expected.
+
+## Triggers
+
+- More files touched than expected
+- Architecture decision needed
+- API contract changed
+- Database/auth/security/AI behavior touched
+- Tests/evals are more complex than expected
+- Rollback is no longer trivial
+
+## Procedure
+
+1. Stop implementation.
+2. Compare current work to original spec level.
+3. Identify new risks.
+4. Recommend upgrade or continue.
+5. If upgraded, update spec before more implementation.
+
+## Output
+
+```txt
+Original level:
+Current risk:
+Escalation needed:
+New level:
+Reason:
+Required spec updates:
+Next action:
+```

package/repo-template/docs/skills/spec-intake.md

@@ -0,0 +1,25 @@
+# Spec Intake Skill
+
+## When to use
+
+Use at the start of any non-trivial task.
+
+## Procedure
+
+1. Read the user request.
+2. Infer likely affected system areas.
+3. Identify ambiguity.
+4. Identify risks.
+5. Run spec complexity classification.
+6. Create the appropriate spec file under `docs/specs/`.
+
+## Output
+
+```txt
+Spec path:
+Spec level:
+Reason:
+Missing information:
+Safe assumptions:
+Blocked or ready:
+```

package/repo-template/docs/skills/testing.md

@@ -0,0 +1,37 @@
+# Testing
+
+## Cuándo usar
+
+Tests, cobertura, regression tests, fixtures y mocks.
+
+## Fuente de verdad
+
+`docs/ai/testing.md`
+
+## Procedimiento
+
+1. Leer fuente de verdad.
+2. Identificar alcance.
+3. Crear/actualizar spec si el cambio no es trivial.
+4. Crear test/eval si cambia comportamiento.
+5. Implementar solo el scope necesario.
+6. Validar pipeline.
+7. Reportar riesgos y cambios.
+
+## Checklist
+
+- [ ] Contexto mínimo leído
+- [ ] Scope claro
+- [ ] Tests/evals aplican o se justifica omisión
+- [ ] Pipeline validado
+- [ ] Riesgos reportados
+
+## Output esperado
+
+```txt
+Contexto leído:
+Cambios realizados:
+Validación:
+Riesgos:
+Siguiente acción:
+```

package/repo-template/docs/skills/tool-adapter-sync.md

@@ -0,0 +1,36 @@
+# Tool Adapter Sync
+
+## Cuándo usar
+
+Cuando se agreguen o actualicen instrucciones para Cursor, Codex, Claude, Gemini, Copilot, Gentle AI, Engram o Graphify.
+
+## Fuente de verdad
+
+- `AGENTS.md`
+- `docs/ai/tool-adapters.md`
+
+## Procedimiento
+
+1. Actualizar primero el core universal.
+2. Revisar si el adapter necesita puntero, regla, skill o subagente.
+3. Evitar duplicación larga.
+4. Confirmar que no contradice `AGENTS.md`.
+5. Validar rutas y nombres esperados por la herramienta.
+
+## Checklist
+
+- [ ] Core actualizado primero
+- [ ] Adapter no contradice core
+- [ ] No hay duplicación larga
+- [ ] Punteros delgados listos
+- [ ] Rutas correctas
+
+## Output esperado
+
+```txt
+Adapter:
+Archivos modificados:
+Fuente core:
+Duplicación:
+Riesgos:
+```