---
name: foragustin
description: Activar SOLO cuando el usuario pida explícitamente crear o actualizar un archivo FORAgustin.md - típicamente con el comando /for-agustin, frases como "documenta este proyecto como FORAgustin", "actualiza el FORAgustin", "genera el narrative del repo", o equivalente. NO activar proactivamente. NO proponer crear FORAgustin.md sin que se pida, incluso en repos nuevos donde no exista. Esta skill gobierna el estilo de escritura de ese archivo markdown únicamente - no cambia cómo responder en chat ni cómo escribir código.
---

# FORAgustin.md — Project Narrative

## Cuándo aplica esta skill
- El usuario ejecuta `/for-agustin` o `/for-agustin --apply`
- El usuario pide explícitamente crear, actualizar o extender `FORAgustin.md`
- El usuario pide un "narrative", "narrativa del proyecto" o "documento de onboarding personal" refiriéndose a este archivo

Si no se cumple ninguno: no hacer nada. No mencionar la existencia o ausencia de FORAgustin.md de forma espontánea.

## Ubicación y propósito
`FORAgustin.md` vive en la raíz del repo. Es la narrativa personal de Agustín — un documento estilo "senior onboarding a un compañero listo". NO es sustituto del README ni de ARCHITECTURE.md. No asumas que está checked-in: revisa `.gitignore` si hay duda.

## Contenido requerido (en este orden)
1. **Executive overview** — qué hace el proyecto y a quién sirve
2. **Arquitectura técnica** — componentes/servicios principales, flujos request/response y de datos
3. **Mapa del codebase** — directorios/módulos clave y cómo encontrar cosas
4. **Tecnologías** — frameworks, tooling, infra, y el porqué (cita evidencia del repo; si es inferencia, etiquétala)
5. **Decisiones y trade-offs** — el porqué, no el qué
6. **Lecciones aprendidas** — bugs encontrados y cómo se arreglaron (solo desde evidencia: git log, PRs, issues), pitfalls, prácticas reforzadas
7. **Onboarding práctico** — run, build, test, lint, workflows comunes

## Estilo de escritura (SCOPE: SOLO ESTE ARCHIVO)
- Crisp, memorable, práctico — no parecer libro de texto
- Analogías y modelos mentales son bienvenidos **pero deben estar fundamentados en evidencia del repo**, nunca inventados
- Anécdotas cortas del git history son válidas; historias ficticias no
- Si algo no se puede saber desde el repo, dilo y sugiere cómo confirmarlo

**Importante**: este estilo aplica ÚNICAMENTE a FORAgustin.md. No trasladar esta voz a respuestas en chat, comentarios de código, mensajes de commit u otros docs.

## Reglas de evidencia
- Fuentes válidas: README, código, configs, git log, descripciones de PR, links a issues, comentarios
- Nunca inventar historias de bugs, decisiones o trade-offs
- Si infieres algo (p. ej. "el equipo probablemente eligió X por Y"), etiquétalo como inferencia

## Actualizaciones
Proponer actualizar FORAgustin.md SOLO cuando el usuario lo pida. No insistir tras cambios arquitectónicos — si Agustín lo quiere refrescar, lo pedirá o ejecutará `/for-agustin`.