workspace-v1/orchestration/directivas/simco/SIMCO-INICIALIZACION.md

SIMCO: INICIALIZACION DE AGENTES

Version: 1.3.0 Sistema: SIMCO + CAPVED + Economia de Tokens + Context Engineering Proposito: Definir el proceso de bootstrap y recovery para cualquier agente Actualizado: 2026-01-03

---

PRINCIPIO FUNDAMENTAL

Un agente inicializado correctamente NO alucina porque tiene TODO el contexto necesario antes de actuar. Un agente que detecta compactacion ejecuta RECOVERY antes de continuar.

---

PROMPT DE INICIALIZACION (Template Universal)

Seras {PERFIL_AGENTE} trabajando en el proyecto {PROYECTO}
para realizar: {DESCRIPCION_TAREA}

Antes de actuar, ejecuta el protocolo CCA (Carga de Contexto Automatica).

Ejemplo real:

Seras Backend-Agent trabajando en el proyecto trading-platform
para realizar: Crear el modulo de notificaciones con endpoints CRUD

Antes de actuar, ejecuta el protocolo CCA (Carga de Contexto Automatica).

---

PROTOCOLO CCA: CARGA DE CONTEXTO AUTOMATICA

Fase 0: IDENTIFICACION (Automatica)

Al recibir prompt de inicializacion, extraer:
  PERFIL: {tipo de agente mencionado}
  PROYECTO: {nombre del proyecto}
  TAREA: {descripcion de la tarea}
  OPERACION: {inferir: CREAR | MODIFICAR | VALIDAR | INVESTIGAR}
  DOMINIO: {inferir: DDL | BACKEND | FRONTEND | MIXTO}

Fase 1: CARGA NIVEL CORE (Obligatorio - ~5 min)

LEER EN ORDEN ESTRICTO:

1. PRINCIPIOS FUNDAMENTALES (6 archivos)
   └── core/orchestration/directivas/principios/
       ├── PRINCIPIO-CAPVED.md              # Ciclo de vida de tareas
       ├── PRINCIPIO-DOC-PRIMERO.md
       ├── PRINCIPIO-ANTI-DUPLICACION.md
       ├── PRINCIPIO-VALIDACION-OBLIGATORIA.md
       ├── PRINCIPIO-ECONOMIA-TOKENS.md     # Desglose de tareas
       └── PRINCIPIO-NO-ASUMIR.md           # No asumir, preguntar

2. MI PERFIL
   └── core/orchestration/agents/perfiles/PERFIL-{MI-TIPO}.md
       Extraer:
       - Que SI hago
       - Que NO hago (delegar)
       - Directivas SIMCO que debo seguir
       - Context Requirements (si existe)

3. INDICE SIMCO
   └── core/orchestration/directivas/simco/_INDEX.md
       Entender estructura del sistema

4. SISTEMA DE ALIASES
   └── core/orchestration/referencias/ALIASES.yml
       Cargar resolucion de @ALIAS

Fase 2: CARGA NIVEL PROYECTO (Obligatorio - ~5 min)

LEER EN ORDEN:

5. CONTEXTO DEL PROYECTO
   └── projects/{PROYECTO}/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
       Extraer:
       - Variables resueltas (DB_NAME, BACKEND_ROOT, etc.)
       - Alias resueltos (@DDL, @BACKEND, etc.)
       - Stack tecnologico
       - Estructura del proyecto

6. PROXIMA ACCION
   └── projects/{PROYECTO}/orchestration/PROXIMA-ACCION.md
       Verificar:
       - ¿Mi tarea es la proxima prioridad?
       - ¿Hay dependencias previas?
       - ¿Hay contexto de sesiones anteriores?

7. INVENTARIO RELEVANTE
   └── Segun mi dominio:
       - DDL: @INV_DB (DATABASE_INVENTORY.yml)
       - Backend: @INV_BE (BACKEND_INVENTORY.yml)
       - Frontend: @INV_FE (FRONTEND_INVENTORY.yml)
       - Mixto: MASTER_INVENTORY.yml

Fase 3: CARGA NIVEL OPERACION (Segun tarea - ~3 min)

LEER SIMCO DE OPERACION:

8. SIMCO-TAREA.md (Si es HU que genera commit)
   └── Proceso CAPVED completo: C→A→P→V→E→D

9. SIMCO BASE (segun operacion inferida)
   └── Crear algo nuevo → SIMCO-CREAR.md
       Modificar existente → SIMCO-MODIFICAR.md
       Validar/revisar → SIMCO-VALIDAR.md
       Buscar/investigar → SIMCO-BUSCAR.md
       Documentar → SIMCO-DOCUMENTAR.md

10. SIMCO DE DOMINIO (si aplica)
   └── Base de datos → SIMCO-DDL.md
       Backend NestJS → SIMCO-BACKEND.md
       Frontend React → SIMCO-FRONTEND.md

Fase 4: CARGA NIVEL TAREA (Especifico - ~5 min)

LEER DOCUMENTACION RELEVANTE:

11. DOCUMENTACION DEL PROYECTO
    └── projects/{PROYECTO}/docs/
        Buscar especificaciones relacionadas con mi tarea:
        - Diseno de entidades
        - Especificaciones de API
        - Wireframes/mockups
        - ADRs relevantes

12. CODIGO EXISTENTE RELACIONADO
    └── Buscar patrones similares ya implementados:
        - ¿Existe modulo similar? → Usar como referencia
        - ¿Existe tabla similar? → Seguir convenciones
        - ¿Existe componente similar? → Reutilizar patrones

13. DEPENDENCIAS DE LA TAREA
    └── Identificar que debe existir ANTES:
        - ¿Necesito tabla que no existe? → Crear primero o delegar
        - ¿Necesito endpoint que no existe? → Crear primero o delegar
        - ¿Necesito tipo que no existe? → Crear primero

---

DETECCION DE COMPACTACION

Senales de Contexto Compactado

El agente DEBE sospechar compactacion si:

SENALES_CRITICAS:
  - "No recuerdo haber ejecutado las fases anteriores del CCA"
  - "Recibo un resumen de 'conversacion anterior' del sistema"
  - "No puedo resolver un @ALIAS que deberia conocer"
  - "Desconozco variables que deberia tener resueltas"
  - "No puedo identificar mi fase CAPVED actual"

SENALES_MODERADAS:
  - "Desconozco el estado de la tarea en curso"
  - "Confundo archivos o rutas del proyecto"
  - "Olvido detalles de implementacion reciente"

CONFIRMACION:
  pregunta: "Recuerdo mi PERFIL, PROYECTO, TAREA y FASE CAPVED?"
  si_falta_algo: "Ejecutar RECOVERY inmediatamente"

Accion Inmediata

Si_detecta_compactacion:
  accion: "Ejecutar RECOVERY antes de continuar"
  referencia: "@CONTEXT_RECOVERY"
  prioridad: "CRITICA - No ejecutar tarea sin recovery"
  notificar: "Informar al usuario que se esta ejecutando recovery"

---

PROTOCOLO DE RECOVERY

Cuando Ejecutar

• Despues de detectar compactacion
• Al inicio de sesion nueva con tarea pendiente
• Cuando el usuario indica "continua donde quedaste"
• Cuando se pierde tracking de la sesion

Proceso de Recovery en 3 Fases

RECOVERY_FASE_1_CRITICO:
  tiempo: "~2 min"
  tokens: "~3000"
  objetivo: "Restaurar identidad y ubicacion"
  cargar:
    - Mi perfil: "agents/perfiles/PERFIL-{TIPO}.md"
    - Ultimo mensaje del usuario o PROXIMA-ACCION.md
    - PRINCIPIO-CAPVED.md (resumen operativo)
  validar:
    - "Se quien soy"
    - "Se en que proyecto estoy"
    - "Se que tarea tengo"

RECOVERY_FASE_2_OPERATIVO:
  tiempo: "~2 min"
  tokens: "~2000"
  objetivo: "Restaurar capacidad de ejecucion"
  cargar:
    - SIMCO-TAREA.md (si tarea genera commit)
    - SIMCO-{DOMINIO}.md (segun tarea)
    - Inventario relevante
  validar:
    - "Se como proceder"
    - "Conozco estado del proyecto"

RECOVERY_FASE_3_PROYECTO:
  tiempo: "~2 min"
  tokens: "~2000"
  objetivo: "Restaurar contexto especifico"
  cargar:
    - CONTEXTO-PROYECTO.md
    - docs/ especificos de la tarea
    - Estado de archivos modificados
  validar:
    - "Tengo variables del proyecto"
    - "Conozco specs de mi tarea"

Notificacion al Usuario

[RECARGA DE CONTEXTO]

Detecte perdida de contexto. Ejecutando recovery:

1. [x] Perfil recuperado: {PERFIL}
2. [x] Proyecto identificado: {PROYECTO}
3. [x] Tarea actual: {TAREA_ID}
4. [x] Fase CAPVED: {FASE}
5. [x] Directivas SIMCO cargadas

Recovery completado (~{X} tokens).

Continuando desde: {descripcion del punto de continuacion}

Siguiente accion: {accion inmediata}

---

VALIDACION POST-RECOVERY

Checklist de Validacion

## Recovery Validation - {FECHA}

### Identidad
- [ ] Conozco mi perfil: {PERFIL}
- [ ] Conozco mi proyecto: {PROYECTO}
- [ ] Conozco mi tarea: {TAREA_ID}
- [ ] Conozco mi fase CAPVED: {FASE}

### Operacion
- [ ] Tengo SIMCO de operacion cargado
- [ ] Tengo SIMCO de dominio cargado (si aplica)
- [ ] Tengo inventario relevante

### Contexto Especifico
- [ ] Puedo resolver @ALIASES esenciales
- [ ] Conozco archivos modificados en sesion
- [ ] Tengo documentacion de tarea

Estado: [ ] RECOVERED | [ ] NECESITA_MAS_CONTEXTO

Si Validacion Falla

Si_recovery_incompleto:
  accion: "Solicitar contexto adicional al usuario"
  mensaje: |
    Mi recovery fue parcial. No pude recuperar:
    - {item faltante 1}
    - {item faltante 2}

    ¿Puedes indicarme:
    - {pregunta especifica 1}?
    - {pregunta especifica 2}?    

---

MAPA DE CARGA POR PERFIL

Database-Agent

CORE (siempre):
  - principios/*.md (6, incluyendo CAPVED y Tokens)
  - PERFIL-DATABASE.md
  - ALIASES.yml

PROYECTO (siempre):
  - CONTEXTO-PROYECTO.md
  - PROXIMA-ACCION.md
  - DATABASE_INVENTORY.yml

OPERACION (segun tarea):
  crear_tabla: [SIMCO-CREAR.md, SIMCO-DDL.md]
  modificar_tabla: [SIMCO-MODIFICAR.md, SIMCO-DDL.md]
  crear_funcion: [SIMCO-CREAR.md, SIMCO-DDL.md]
  crear_indice: [SIMCO-CREAR.md, SIMCO-DDL.md]

TAREA:
  - docs/{especificacion-entidad}.md
  - DDL existente del schema
  - Convenciones SQL del proyecto

Backend-Agent

CORE (siempre):
  - principios/*.md (6, incluyendo CAPVED y Tokens)
  - PERFIL-BACKEND.md
  - ALIASES.yml

PROYECTO (siempre):
  - CONTEXTO-PROYECTO.md
  - PROXIMA-ACCION.md
  - BACKEND_INVENTORY.yml
  - DATABASE_INVENTORY.yml (para alinear con DDL)

OPERACION (segun tarea):
  crear_modulo: [SIMCO-CREAR.md, SIMCO-BACKEND.md]
  crear_entity: [SIMCO-CREAR.md, SIMCO-BACKEND.md]
  crear_endpoint: [SIMCO-CREAR.md, SIMCO-BACKEND.md]
  modificar_service: [SIMCO-MODIFICAR.md, SIMCO-BACKEND.md]

TAREA:
  - docs/{especificacion-api}.md
  - DDL de tabla relacionada
  - Entities similares existentes
  - Services similares existentes

Frontend-Agent

CORE (siempre):
  - principios/*.md (6, incluyendo CAPVED y Tokens)
  - PERFIL-FRONTEND.md
  - ALIASES.yml

PROYECTO (siempre):
  - CONTEXTO-PROYECTO.md
  - PROXIMA-ACCION.md
  - FRONTEND_INVENTORY.yml
  - BACKEND_INVENTORY.yml (para conocer endpoints)

OPERACION (segun tarea):
  crear_componente: [SIMCO-CREAR.md, SIMCO-FRONTEND.md]
  crear_pagina: [SIMCO-CREAR.md, SIMCO-FRONTEND.md]
  crear_hook: [SIMCO-CREAR.md, SIMCO-FRONTEND.md]
  modificar_componente: [SIMCO-MODIFICAR.md, SIMCO-FRONTEND.md]

TAREA:
  - docs/{wireframe-mockup}.md
  - DTOs del backend relacionados
  - Componentes similares existentes
  - Hooks similares existentes

Orquestador (Tech-Leader)

CORE (siempre):
  - principios/*.md (6, incluyendo CAPVED y Tokens)
  - PERFIL-ORQUESTADOR.md
  - ALIASES.yml

PROYECTO (siempre):
  - CONTEXTO-PROYECTO.md
  - PROXIMA-ACCION.md
  - MASTER_INVENTORY.yml (vision completa)

OPERACION (segun tarea):
  planificar: [SIMCO-BUSCAR.md, SIMCO-DELEGACION.md]
  delegar: [SIMCO-DELEGACION.md, @TPL_HERENCIA_CTX]
  validar: [SIMCO-VALIDAR.md]
  coordinar: [SIMCO-DELEGACION.md]

TAREA:
  - docs/ completo del proyecto
  - Estado de todas las capas
  - Dependencias entre tareas

---

CHECKLIST DE INICIALIZACION

## CHECKLIST CCA - {PERFIL} en {PROYECTO}

### Fase 1: Core
- [ ] Lei PRINCIPIO-CAPVED.md (Ciclo de vida)
- [ ] Lei PRINCIPIO-DOC-PRIMERO.md
- [ ] Lei PRINCIPIO-ANTI-DUPLICACION.md
- [ ] Lei PRINCIPIO-VALIDACION-OBLIGATORIA.md
- [ ] Lei PRINCIPIO-ECONOMIA-TOKENS.md (Desglose tareas)
- [ ] Lei PRINCIPIO-NO-ASUMIR.md
- [ ] Lei mi PERFIL-{TIPO}.md
- [ ] Lei _INDEX.md de SIMCO
- [ ] Lei ALIASES.yml

### Fase 2: Proyecto
- [ ] Lei CONTEXTO-PROYECTO.md
- [ ] Lei PROXIMA-ACCION.md
- [ ] Lei inventario relevante

### Fase 3: Operacion
- [ ] Identifique si es HU → Lei SIMCO-TAREA.md
- [ ] Identifique operacion: {CREAR|MODIFICAR|VALIDAR|...}
- [ ] Lei SIMCO-{operacion}.md
- [ ] Lei SIMCO-{dominio}.md (si aplica)

### Fase 4: Tarea
- [ ] Consulte docs/ relevante
- [ ] Busque patrones existentes
- [ ] Identifique dependencias

### READY TO EXECUTE
- [ ] Tengo TODO el contexto necesario
- [ ] Se que debo hacer
- [ ] Se que NO debo hacer
- [ ] Se que delegar si es necesario

---

REPORTE DE CONTEXTO CARGADO

Al completar CCA, generar reporte interno:

REPORTE_CONTEXTO_CARGADO:
  agente: "{PERFIL}"
  proyecto: "{PROYECTO}"
  tarea: "{DESCRIPCION}"

  contexto_core:
    principios: [capved, doc-primero, anti-dup, validacion, tokens, no-asumir]
    perfil: "PERFIL-{TIPO}.md"
    simco_index: true
    aliases: true

  contexto_proyecto:
    contexto_proyecto: true
    proxima_accion: true
    inventarios: ["{inventarios_leidos}"]

  contexto_operacion:
    operacion: "{CREAR|MODIFICAR|...}"
    simco_operacion: "SIMCO-{op}.md"
    simco_dominio: "SIMCO-{dom}.md"

  contexto_tarea:
    docs_consultados: ["{lista}"]
    patrones_encontrados: ["{lista}"]
    dependencias_identificadas: ["{lista}"]

  estado: "READY_TO_EXECUTE"

  restricciones:
    no_hacer: ["{lista de lo que NO debo hacer}"]
    delegar_a: ["{agentes para delegar}"]

  validaciones_requeridas:
    - "{validacion 1}"
    - "{validacion 2}"

---

ANTI-PATRONES (QUE NO HACER)

NUNCA:
  - Empezar a codificar sin completar CCA
  - Asumir que algo existe sin verificar inventario
  - Crear sin consultar docs/ primero
  - Ignorar principios porque "es una tarea simple"
  - Saltarse validaciones "para ir mas rapido"
  - Modificar sin analizar impacto
  - Continuar tras compactacion sin ejecutar recovery

ERRORES_COMUNES:
  - "Ya se como hacerlo" → Verificar docs/ de todas formas
  - "Es igual al otro modulo" → Verificar diferencias en specs
  - "Despues documento" → Documentar durante, no despues
  - "El build puede fallar temporalmente" → NUNCA dejar build roto
  - "El contexto esta bien" → Verificar si hubo compactacion

---

TIEMPO ESTIMADO

Fase	Tiempo	Archivos
Core	~5 min	8 archivos
Proyecto	~5 min	3-4 archivos
Operacion	~3 min	1-2 archivos
Tarea	~5 min	Variable
TOTAL CCA	~18 min	~15 archivos
Recovery Critico	~2 min	~3 archivos
Recovery Completo	~6 min	~7 archivos

INVERSION: 18 minutos de lectura inicial, 6 minutos max de recovery RETORNO: Cero alucinaciones, cero retrabajos, codigo correcto desde el inicio

---

INTEGRACION CON SUBAGENTES

Cuando delegas a un subagente, este DEBE ejecutar CCA tambien. Ver: SIMCO-DELEGACION.md para template de delegacion con contexto heredado. Ver: @TPL_HERENCIA_CTX para formato de herencia de contexto.

---

REFERENCIAS DE CONTEXT ENGINEERING

Documento	Alias	Proposito
SIMCO-CONTEXT-ENGINEERING.md	@CONTEXT_ENGINEERING	Principios de ingenieria de contexto
TEMPLATE-RECOVERY-CONTEXT.md	@TPL_RECOVERY_CTX	Template detallado de recovery
TEMPLATE-HERENCIA-CONTEXTO.md	@TPL_HERENCIA_CTX	Herencia de contexto a subagentes
PRINCIPIO-CAPVED.md	@CAPVED	Ciclo de vida de tareas
PRINCIPIO-ECONOMIA-TOKENS.md	@ECONOMIA	Principio de economia de tokens
SIMCO-QUICK-REFERENCE.md	@QUICK_REF	Referencia rapida optimizada

---

Version: 1.3.0 | Sistema: SIMCO + CAPVED + Context Engineering | Tipo: Directiva de Inicializacion