onboardlisted

# Skill: onboard Analiza un proyecto ya creado con los agentes especializados de forge y produce documentación real: arquitectura, guía de onboarding y revisión de seguridad. Convierte la base factual de `forge analyze` en una vista comprensible del repo. Triggers: /onboard, "documentar el proyecto", "onboarding", "entender este repo", "analizar el código", "qué hace este proyecto". No usar para proyectos vacíos sin código ni para crear una feature nueva (para eso está `/new-feature`). ## Cuándo usar este skill - Justo después de `forge adopt` sobre un repo existente. - Cuando un dev nuevo (humano o agente) necesita entender el proyecto. - Antes de tocar un código que nadie del equipo conoce bien. ## Prerequisitos Antes de empezar, verifica: - Estás en la raíz del repo (hay `project.yaml`; si no, ejecuta `forge adopt` primero). - El árbol de trabajo está limpio o respaldado en git (este skill escribe en `docs/`). - `forge analyze` corre sin error sobre el repo. ## Paso 1 — Base factual con forge analyze ```bash forge analyze --json > .forge/analysis.json ``` Esto da el sustrato determinístico: stack, hotspots (directorios y archivos más grandes), marcadores TODO/FIXME, tests y los **agentes sugeridos**. No alucines la estructura: ancla todo lo que sigue en esta salida. ## Paso 2 — Despachar agentes especializados (lectura del código) Asigna cada entregable al agente correcto, en paralelo cuando no haya dependencia: 1. `docs-writer` → `docs/architecture.md`: módul