# SIMCO: REFERENCIA RÁPIDA

**Versión:** 1.0.0 | **Fecha:** 2025-12-08 | **Uso:** Consulta rápida sin cargar archivos extensos

---

## FLUJO DE INICIALIZACIÓN (CCA) - 7 PASOS

```
PASO_0 → Identificar NIVEL (workspace/proyecto/vertical)
PASO_1 → Identificar perfil, proyecto, tarea, operación
PASO_2 → Cargar CORE (@CATALOG, principios, _INDEX)
PASO_3 → Cargar PROYECTO (CONTEXTO, PROXIMA-ACCION, inventarios)
PASO_4 → Cargar OPERACIÓN (SIMCO según tarea)
PASO_5 → Cargar TAREA (docs/, dependencias)
PASO_6 → Verificar dependencias
→ READY_TO_EXECUTE
```

---

## CICLO CAPVED - 6 FASES

```
C → Contexto   : Vincular HU, cargar SIMCO, verificar @CATALOG
A → Análisis   : Mapear objetos, dependencias, riesgos
P → Planeación : Desglosar subtareas, asignar agentes
V → Validación : ⚠️ NO DELEGAR - verificar A vs P
E → Ejecución  : docs/ PRIMERO, delegar, build+lint
D → Documentar : GATE - inventarios, trazas, lecciones
```

---

## NIVELES JERÁRQUICOS

| Nivel | Tipo | Propaga a |
|-------|------|-----------|
| 0 | Workspace Root | - |
| 1 | Core | 0 |
| 2A | Standalone | 0 |
| 2B | Suite | 0 |
| 2B.1 | Suite Core | 2B → 0 |
| 2B.2 | Vertical | 2B → 0 |
| 3 | Catálogo | 1 → 0 |

---

## ALIAS ESENCIALES

```yaml
# Operaciones
@CREAR @MODIFICAR @VALIDAR @DOCUMENTAR @BUSCAR @DELEGAR @REUTILIZAR

# Dominio
@OP_DDL @OP_BACKEND @OP_FRONTEND

# Niveles
@NIVELES @PROPAGACION

# Catálogo
@CATALOG @CATALOG_INDEX

# Proyecto
@INVENTORY @CONTEXTO @PROXIMA
```

---

## PRINCIPIOS (5 FUNDAMENTALES)

1. **CAPVED**: Toda tarea pasa por 6 fases
2. **DOC-PRIMERO**: Consultar docs/ antes de código
3. **ANTI-DUP**: Verificar @INVENTORY + @CATALOG antes de crear
4. **VALIDACIÓN**: Build + Lint DEBEN pasar
5. **ECONOMÍA-TOKENS**: Desglosar tareas grandes, prompts <2000 tokens

---

## DELEGACIÓN - CHECKLIST MÍNIMO

```yaml
INCLUIR_SIEMPRE:
  - nivel_actual + orchestration_path + propagate_to
  - variables_resueltas (NO placeholders)
  - criterios_aceptacion (verificables)
  - archivos_referencia (rutas exactas)
  - validaciones_requeridas (comandos)

LIMITES:
  - Max 5 subagentes paralelos
  - Max 3 niveles anidación
  - Prompt < 2000 tokens
```

---

## VALIDACIÓN RÁPIDA

```bash
# Database
cd @DB_SCRIPTS && ./{RECREATE_CMD}

# Backend
cd @BACKEND_ROOT && npm run build && npm run lint

# Frontend
cd @FRONTEND_ROOT && npm run build && npm run lint
```

---

## CUÁNDO USAR CADA SIMCO

| Situación | SIMCO |
|-----------|-------|
| HU/Tarea completa | SIMCO-TAREA |
| Crear archivo nuevo | SIMCO-CREAR + SIMCO-{DOMINIO} |
| Modificar existente | SIMCO-MODIFICAR + SIMCO-{DOMINIO} |
| Validar código | SIMCO-VALIDAR |
| Documentar trabajo | SIMCO-DOCUMENTAR |
| Buscar información | SIMCO-BUSCAR |
| Asignar a subagente | SIMCO-DELEGACION |
| Funcionalidad común | SIMCO-REUTILIZAR |

---

## ERRORES COMUNES

| Error | Solución |
|-------|----------|
| Referencia rota | Verificar @ALIASES |
| Duplicado creado | Consultar @INVENTORY primero |
| Build falla | No marcar como completo |
| Propagación olvidada | Ejecutar SIMCO-PROPAGACION |
| Token overload | Desglosar en subtareas más pequeñas |

---

**Archivo:** SIMCO-QUICK-REFERENCE.md | **~100 líneas** | **Optimizado para tokens**
