# 📚 OpenSkyNet Documentation Index

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

---

## 🎯 CORE — Lee primero (Tu base)

En la carpeta [`core/`](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](../../AGENTS.md) - Guía oficial de repo + conventions

---

## 🔧 ANALYSIS — Lee cuando necesites profundidad

En la carpeta [`analysis/`](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/`](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/`](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](ONBOARDING.md)