📚 OpenSkyNet Documentation Index

¿Eres nuevo? → Leer ONBOARDING.md (5 min)
¿Tienes prisa? → Busca tu archivo en las carpetas de abajo

🎯 CORE — Lee primero (Tu base)

En la carpeta core/, encontrarás:

SOUL.md - Quién/qué eres, tu propósito y misión
HEARTBEAT.md - Cómo funciona tu pulso autónomo
IDENTITY.md - Tu core identity como entidad
MEMORY.md - Doctrina de aprendizaje y persistencia

Si trabajas en OpenClaw (no solo OpenSkyNet):

Ver ../../AGENTS.md - Guía oficial de repo + conventions

🔧 ANALYSIS — Lee cuando necesites profundidad

En la carpeta analysis/, encontrarás:

Análisis técnicos profundos:

VALIDACION_TIER1_INFORME.md - Qué código fue eliminado y por qué ✅
ANALISIS_ARQUITECTONICO_SKYNET_VS_OPENSKYNET_2026-03-16.md - Comparación técnica
AUTOANALISIS_HONESTO.md - Crítica realista de la arquitectura
Y otros análisis técnicos...

📦 ARCHIVE — Propuestas viejas (no vigentes)

En la carpeta archive/, encontrarás:

Proyectos evaluados pero NO implementados:

Propuestas que requieren trabajo futuro
Análisis de Tier 1 (código eliminado)
Roadmaps antiguos

¿Cuándo leer? Solo si necesitas entender una idea anterior que se evaluó pero se descartó.

🕒 STATUS — Reportes históricos

En la carpeta status/, encontrarás:

Snapshots en el tiempo (fecha-stamped):

Auditorialogías pasadas
Reportes de validación históricos
Cambios documentados por fecha

¿Cuándo leer? Como referencia histórica. Lee el código como fuente de verdad, no estos reportes.

🚫 Qué NO hacer (primeras 24h)

❌ Leer propuestas sobre "Tier 1" o "meta-controller" → Código fue eliminado
❌ Asumir que TODO está implementado → Lee código primero
❌ Ignorar si docs y código no concuerdan → El código tiene la verdad
❌ Modificar src/omega/ sin leer heartbeat.ts primero

✅ Qué SÍ hacer

✅ Ejecutar pnpm test temprano → Te dice estado real
✅ Leer código más que documentación
✅ Si algo no concuerda → Confía en el código
✅ Preguntar cuando no entiendas

🗺️ Ruta para nuevos

(5 min)   ONBOARDING.md (este directorio)
   ↓
(2 min)   core/SOUL.md
   ↓
(3 min)   core/HEARTBEAT.md
   ↓
(15 min)  src/omega/heartbeat.ts (el código real)
   ↓
(10 min)  pnpm test
   ↓
(15 min)  Explorar src/omega/ structure

Siguiente paso: Lee ONBOARDING.md