agent-ctx 1.0.0

package/src/templates/es/base/_architecture.md

@@ -0,0 +1,90 @@
+# Arquitectura del Proyecto
+
+## Objetivo del Proyecto
+
+[Describe en 2-3 líneas qué hace tu aplicación y cuál es su propósito principal.]
+
+## Tech Stack
+
+### Frontend
+| Tecnología | Versión | Propósito |
+|------------|---------|-----------|
+| [Framework] | vX.X | [Propósito] |
+| [UI Library] | vX.X | [Propósito] |
+| [State Mgmt] | vX.X | [Propósito] |
+
+### Backend
+| Tecnología | Versión | Propósito |
+|------------|---------|-----------|
+| [Runtime/Framework] | vX.X | [Propósito] |
+| [ORM/DB Client] | vX.X | [Propósito] |
+| [Auth] | vX.X | [Propósito] |
+
+### Base de Datos
+| Tipo | Tecnología | Propósito |
+|------|------------|-----------|
+| Principal | [PostgreSQL/MySQL/MongoDB] | Datos de la app |
+| Cache | [Redis] | Sesiones, cache |
+
+### Infraestructura
+| Servicio | Propósito |
+|----------|-----------|
+| [Vercel/AWS/etc] | Hosting |
+| [Cloudflare/etc] | CDN |
+
+## Estructura de Directorios
+
+```
+proyecto/
+├── src/               # [Describe qué contiene]
+│   ├── components/    # [Describe]
+│   ├── lib/           # [Describe]
+│   ├── pages/         # [Describe]
+│   └── styles/        # [Describe]
+├── public/            # Assets estáticos
+├── tests/             # Tests
+└── config/            # Configuraciones
+```
+
+## Flujo de Datos
+
+```
+[Usuario] → [UI] → [API/Actions] → [DB] → [Response] → [UI Update]
+```
+
+1. El usuario interactúa con [componente/página]
+2. Se dispara [acción/API call]
+3. [Servicio/ORM] procesa la solicitud
+4. [Mecanismo de actualización de UI]
+
+## Autenticación y Autorización
+
+- **Método**: [JWT/Session/OAuth/etc]
+- **Provider**: [Auth0/Clerk/NextAuth/Custom]
+- **Roles**: [Admin, User, Guest, etc]
+
+## APIs y Endpoints
+
+| Método | Endpoint | Descripción |
+|--------|----------|-------------|
+| GET | `/api/xxx` | Descripción |
+| POST | `/api/xxx` | Descripción |
+
+## Dependencias Críticas
+
+| Paquete | Por qué es importante |
+|---------|----------------------|
+| `nombre-paquete` | Razón por la que es crítico |
+
+## Variables de Entorno
+
+| Variable | Descripción | Requerida |
+|----------|-------------|-----------|
+| `DATABASE_URL` | Conexión a DB | Sí |
+| `API_KEY` | Key de servicio X | Sí |
+
+## Convenciones del Proyecto
+
+- **Branches**: `main`, `develop`, `feature/*`, `fix/*`
+- **Commits**: Conventional Commits
+- **Código**: Ver `.context/rules/coding-standards.md`

package/src/templates/es/base/_bootstrap.md

@@ -0,0 +1,89 @@
+# Prompt de Configuración IA
+
+> **ELIMINA ESTE ARCHIVO** después de que tu agente IA haya completado la configuración.
+> Este es un ayudante de configuración de una sola vez.
+
+---
+
+## Tu Misión
+
+Estás ayudándome a configurar el contexto de IA para este proyecto. Tu objetivo es **analizar el código existente** y **poblar los archivos `.context/`** con información precisa.
+
+---
+
+## Tareas
+
+Por favor completa las siguientes tareas en orden:
+
+### 1. Analizar el Proyecto
+
+Escanea el código e identifica:
+- [ ] Lenguajes de programación utilizados
+- [ ] Frameworks y librerías (revisa `package.json`, `requirements.txt`, `go.mod`, etc.)
+- [ ] Estructura de directorios y su propósito
+- [ ] Puntos de entrada y archivos principales
+- [ ] Base de datos y servicios externos
+- [ ] Comandos de build y test
+
+### 2. Actualizar `.context/architecture.md`
+
+Basándote en tu análisis, completa:
+- **Objetivo del Proyecto**: ¿Qué hace esta aplicación?
+- **Stack Tecnológico**: Completa las tablas con las tecnologías reales
+- **Estructura de Directorios**: Reemplaza el ejemplo con la estructura real
+- **Flujo de Datos**: ¿Cómo fluyen las peticiones por el sistema?
+- **APIs**: Documenta los endpoints principales
+- **Variables de Entorno**: Lista las vars de entorno requeridas
+
+### 3. Actualizar `.context/rules/coding-standards.md`
+
+Analiza el estilo de código existente y documenta:
+- Convenciones de naming realmente usadas
+- Patrones TypeScript/JavaScript
+- Formateo de código (tabs vs espacios, longitud de línea, etc.)
+- Patrones de testing
+- Cualquier regla de linting (configuración ESLint, Prettier)
+
+### 4. Actualizar `.context/project_state.md`
+
+Busca TODOs, FIXMEs y trabajo pendiente:
+- Prioridades actuales
+- Issues o bugs conocidos
+- Deuda técnica
+- Features planificadas
+
+### 5. Poblar el Memory Bank
+
+Actualiza los archivos en `.context/memory/`:
+- `project_brief.md` — Resume el proyecto en unos párrafos
+- `tech_context.md` — ¿Por qué se eligieron estas tecnologías?
+- `active_context.md` — ¿En qué se está trabajando ahora?
+- `progress.md` — ¿Qué ya está hecho?
+
+---
+
+## Checklist de Completado
+
+Cuando termines, verifica:
+
+- [ ] `AGENTS.md` tiene instrucciones específicas del proyecto añadidas
+- [ ] `.context/architecture.md` refleja el stack real
+- [ ] `.context/rules/coding-standards.md` coincide con el estilo del código
+- [ ] `.context/project_state.md` tiene los TODOs actuales
+- [ ] Los archivos `.context/memory/` están poblados
+- [ ] Todo el texto `[placeholder]` ha sido reemplazado
+
+---
+
+## Después de Completar
+
+Una vez terminada la configuración:
+
+1. Revisa todos los archivos generados
+2. Haz los ajustes manuales necesarios
+3. **Elimina este archivo** (`AI_BOOTSTRAP.md`)
+4. Haz commit del directorio `.context/` al control de versiones
+
+---
+
+*Este archivo fue generado por agent-ctx. Es un ayudante de una sola vez y debe eliminarse después de usarlo.*

package/src/templates/es/base/_doc.md

@@ -0,0 +1,65 @@
+---
+type: doc-template
+target: .context/docs/{name}.md
+---
+
+# AI Guide
+
+Estás ayudando al usuario a crear un archivo de documentación. Sigue estos pasos:
+1. Pregunta al usuario sobre el tema que quiere documentar
+2. Determina el tipo de documentación (README, docs de API, guía, etc.)
+3. Recopila la información necesaria
+4. Completa la plantilla apropiada
+
+# Questions to Ask
+
+1. ¿Cuál es el propósito de esta documentación?
+2. ¿Quién es la audiencia objetivo (desarrolladores, usuarios, ops)?
+3. ¿Cuáles son las secciones principales que quieres incluir?
+4. ¿Hay ejemplos de código o comandos para incluir?
+5. ¿Hay prerrequisitos o dependencias que mencionar?
+
+# Template Output - Estilo README
+
+```markdown
+# {Nombre del Proyecto/Feature}
+
+> {Descripción breve}
+
+## Visión General
+
+{Descripción detallada de qué es esto y por qué existe}
+
+## Prerrequisitos
+
+- {Prerrequisito 1}
+- {Prerrequisito 2}
+
+## Instalación
+
+{Pasos de instalación}
+
+## Uso
+
+{Ejemplos básicos de uso}
+
+## Configuración
+
+| Opción | Tipo | Default | Descripción |
+|--------|------|---------|-------------|
+| `opcion1` | string | - | Descripción |
+
+## Ejemplos
+
+{Ejemplos de código con explicaciones}
+
+## Solución de Problemas
+
+### Problema Común 1
+{Solución}
+
+## Documentación Relacionada
+
+- [Enlace 1](url)
+- [Enlace 2](url)
+```

package/src/templates/es/base/_mcp.md

@@ -0,0 +1,81 @@
+---
+type: mcp-template
+target: .context/mcp/{name}.md
+---
+
+# AI Guide
+
+Estás ayudando al usuario a documentar una configuración de servidor MCP (Model Context Protocol). Sigue estos pasos:
+1. Pregunta sobre el servidor MCP que está usando o creando
+2. Recopila las herramientas/recursos que proporciona
+3. Documenta patrones de uso y ejemplos
+
+# Questions to Ask
+
+1. ¿Cuál es el nombre del servidor MCP?
+2. ¿Qué capacidades proporciona (tools, resources, prompts)?
+3. ¿Cómo se configura/inicializa?
+4. ¿Cuáles son los comandos o herramientas principales disponibles?
+5. ¿Se necesitan variables de entorno o secretos?
+
+# Template Output
+
+```markdown
+# 🔌 Servidor MCP: {nombre}
+
+> {Descripción breve de lo que hace este servidor}
+
+## Visión General
+
+{Qué proporciona este servidor MCP y por qué es útil}
+
+## Instalación
+
+{Cómo instalar o habilitar este servidor}
+
+## Configuración
+
+```json
+{
+  "mcpServers": {
+    "{nombre}": {
+      "command": "{comando}",
+      "args": ["{args}"],
+      "env": {
+        "VAR_NAME": "value"
+      }
+    }
+  }
+}
+```
+
+## Herramientas Disponibles
+
+| Herramienta | Descripción | Parámetros |
+|-------------|-------------|------------|
+| `nombre_tool` | Qué hace | `param1`, `param2` |
+
+## Recursos Disponibles
+
+| Recurso | Patrón URI | Descripción |
+|---------|------------|-------------|
+| `nombre_recurso` | `protocol://path` | Qué proporciona |
+
+## Ejemplos de Uso
+
+### Ejemplo 1: {Descripción}
+{Cómo usar una herramienta o recurso específico}
+
+### Ejemplo 2: {Descripción}
+{Otro ejemplo de uso}
+
+## Mejores Prácticas
+
+- {Mejor práctica 1}
+- {Mejor práctica 2}
+
+## Solución de Problemas
+
+### {Problema Común}
+{Solución}
+```

package/src/templates/es/base/_project_state.md

@@ -0,0 +1,48 @@
+# Estado del Proyecto (Memoria)
+
+> Este archivo se actualiza manualmente para que la IA sepa en qué punto se quedó en la última sesión.
+> **Última actualización:** [FECHA]
+
+## Contexto Actual
+
+[Describe brevemente en qué fase está el proyecto: MVP, desarrollo activo, mantenimiento, etc.]
+
+## Completado Recientemente
+
+- [x] Tarea completada 1
+- [x] Tarea completada 2
+- [x] Tarea completada 3
+
+## En Progreso (Sprint Actual)
+
+- [ ] Tarea en progreso 1
+- [ ] Tarea en progreso 2
+- [ ] Tarea en progreso 3
+
+## Próximo a Hacer
+
+- [ ] Tarea pendiente 1
+- [ ] Tarea pendiente 2
+
+## Bugs Conocidos / Deuda Técnica
+
+| Bug/Issue | Prioridad | Notas |
+|-----------|-----------|-------|
+| Descripción del bug | Alta/Media/Baja | Contexto adicional |
+
+## Decisiones Importantes
+
+- **Decisión 1**: [Qué se decidió y por qué]
+- **Decisión 2**: [Qué se decidió y por qué]
+
+## Notas para la Próxima Sesión
+
+> Escribe aquí cualquier cosa importante que la IA deba saber antes de empezar a trabajar:
+
+- Nota 1
+- Nota 2
+
+## Restricciones Actuales
+
+- No modificar [X] porque [razón]
+- Evitar [Y] hasta que [condición]

package/src/templates/es/base/_rule.md

@@ -0,0 +1,56 @@
+---
+type: rule-template
+target: .context/rules/{name}.md
+---
+
+# AI Guide
+
+Estás ayudando al usuario a crear un nuevo documento de regla/estándar de código. Sigue estos pasos:
+1. Pregunta al usuario sobre la regla o estándar específico que quiere documentar
+2. Recopila ejemplos de uso correcto e incorrecto
+3. Completa la plantilla con la información
+
+# Questions to Ask
+
+1. ¿Cuál es el nombre/título de esta regla?
+2. ¿Qué problema resuelve o previene esta regla?
+3. ¿Cuáles son los requisitos o restricciones específicas?
+4. ¿Puedes proporcionar ejemplos de uso correcto?
+5. ¿Puedes proporcionar ejemplos de qué evitar?
+6. ¿Hay excepciones a esta regla?
+
+# Template Output
+
+```markdown
+# ⚖️ Regla: {nombre}
+
+> {descripción breve de la regla}
+
+## Por qué existe esta regla
+
+{Explica el problema que previene o el beneficio que proporciona}
+
+## Requisitos
+
+- {Requisito 1}
+- {Requisito 2}
+- {Requisito 3}
+
+## ✅ Ejemplos Correctos
+
+{código o ejemplos mostrando uso correcto}
+
+## ❌ Ejemplos Incorrectos
+
+{código o ejemplos mostrando qué evitar}
+
+## Excepciones
+
+{Lista las excepciones válidas, o "Sin excepciones" si no hay ninguna}
+
+## Aplicación
+
+- [ ] Regla de linter: {nombre de regla si aplica}
+- [ ] Item de checklist de code review
+- [ ] Test automatizado
+```

package/src/templates/es/base/_skill.md

@@ -0,0 +1,60 @@
+---
+name: nombre-del-skill
+description: Descripción breve de lo que hace este skill y cuándo usarlo. Escribe en tercera persona. Sé específico sobre disparadores y casos de uso.
+---
+
+# Nombre del Skill
+
+Breve descripción del propósito del skill.
+
+## Cuándo usar
+
+- Cuando el usuario pide [tarea específica]
+- Cuando se detecta [patrón o disparador]
+- Cuando se trabaja con [tecnología o dominio]
+
+## Inicio rápido
+
+Ejemplo mínimo para comenzar inmediatamente:
+
+```typescript
+// Ejemplo conciso y funcional
+import { example } from 'library';
+
+const result = example.process(input);
+```
+
+## Pasos de implementación
+
+1. **Paso 1**: Descripción breve
+2. **Paso 2**: Descripción breve
+3. **Paso 3**: Descripción breve
+
+## Mejores prácticas
+
+### ✅ Hacer
+
+- Buena práctica 1
+- Buena práctica 2
+
+### ❌ Evitar
+
+- Anti-patrón 1
+- Anti-patrón 2
+
+## Referencias
+
+- [Documentación oficial](link)
+- [Guía de mejores prácticas](link)
+
+## Checklist de verificación
+
+Copia y sigue el progreso:
+
+```
+- [ ] Dependencias instaladas
+- [ ] Configuración completa
+- [ ] Lógica principal implementada
+- [ ] Manejo de errores añadido
+- [ ] Tests escritos
+```

package/src/templates/es/docs/doc-readme.md

@@ -0,0 +1,43 @@
+# 📚 Documentación Externa (Vendorizing)
+
+Esta carpeta contiene documentación de librerías y APIs externas para que los agentes AI puedan consultarla localmente sin depender de internet.
+
+## 🎯 Propósito
+
+Muchos LLMs tienen conocimiento desactualizado o limitado sobre librerías específicas. Al colocar la documentación aquí, el agente puede:
+
+1. Consultar APIs actualizadas
+2. Ver ejemplos de código recientes
+3. Evitar sugerir código deprecado
+
+## 📥 ¿Qué colocar aquí?
+
+- **`llms.txt`**: Archivos especiales de documentación para LLMs (ej: `mui-llms.txt`, `vercel-llms.txt`)
+- **API References**: Exportaciones de documentación de APIs que usas
+- **Changelogs**: Notas de cambios importantes de dependencias críticas
+- **Guías de migración**: Si estás migrando de una versión a otra
+
+## 💡 Ejemplos de archivos útiles
+
+```
+docs/
+├── mui-llms.txt           # Docs de Material UI para LLMs
+├── nextjs-app-router.md   # Guía del App Router de Next.js
+├── prisma-schema-guide.md # Referencia de schemas de Prisma
+├── tailwind-v4-changes.md # Cambios de Tailwind v3 a v4
+└── api-internal.md        # Documentación de tu API interna
+```
+
+## 🔍 Cómo obtener llms.txt
+
+Muchas librerías modernas publican archivos `.txt` optimizados para LLMs:
+
+- **Vercel**: `https://vercel.com/docs/llms.txt`
+- **Material UI**: Buscar en su repositorio
+- **Otros**: Revisar `/llms.txt` o `/docs/llms.txt` en el sitio oficial
+
+## ⚠️ Notas
+
+- Mantén solo lo esencial para no sobrecargar el contexto
+- Actualiza periódicamente cuando actualices dependencias
+- Prioriza las librerías que más usas en el proyecto

package/src/templates/es/docs/mcp-readme.md

@@ -0,0 +1,21 @@
+# 🔌 Servidores MCP Recomendados
+
+Este archivo mantiene una lista de los servidores MCP (Model Context Protocol) recomendados para este proyecto.
+Mantener herramientas consistentes en el equipo asegura una mejor colaboración y asistencia de IA.
+
+## 📋 Lista de Servidores
+
+| Servidor | Descripción | Propósito | Comando de Instalación / Fuente |
+|----------|-------------|-----------|----------------------------------|
+| `context7` | Actualizador de documentación | Mantiene la documentación actualizada en contexto | `npm install -g context7` |
+| `filesystem`| Acceso al Sistema de Archivos | Permite a la IA leer/escribir archivos | Nativo en la mayoría de clientes MCP |
+
+## 📦 Cómo Instalar
+
+La mayoría de los servidores MCP se instalan a través de la configuración de tu editor (ej. Cursor, VS Code).
+Consulta la documentación de tu editor sobre cómo agregar estos servidores.
+
+## 📝 Notas
+
+- Agrega nuevos servidores aquí cuando el equipo acuerde una nueva herramienta estándar.
+- Mantén actualizados los comandos de instalación.

package/src/templates/es/memory/active_context.md

@@ -0,0 +1,38 @@
+---
+name: active_context
+description: Estado actual de la sesión - dinámico, se actualiza frecuentemente
+---
+
+# Contexto Activo
+
+> Última actualización: [FECHA]
+
+## Foco Actual
+
+[En qué se está trabajando actualmente]
+
+## Cambios Recientes
+
+- [Cambio 1]
+- [Cambio 2]
+
+## Preguntas Abiertas
+
+- [ ] Pregunta 1
+- [ ] Pregunta 2
+
+## Bloqueos
+
+| Bloqueo | Impacto | Estado |
+|---------|---------|--------|
+| | | |
+
+## Próximos Pasos
+
+1. [ ] Paso 1
+2. [ ] Paso 2
+3. [ ] Paso 3
+
+---
+
+*Este archivo es actualizado dinámicamente por el agente AI durante las sesiones de desarrollo.*

package/src/templates/es/memory/progress.md

@@ -0,0 +1,35 @@
+---
+name: progress
+description: Seguimiento de progreso - dinámico, se actualiza con cada hito
+---
+
+# Progreso
+
+## Hitos
+
+### Fase 1: [Nombre]
+
+| Tarea | Estado | Notas |
+|-------|--------|-------|
+| | ⬜ No iniciado | |
+| | 🔄 En progreso | |
+| | ✅ Completo | |
+
+## Changelog
+
+### [FECHA]
+
+- Añadido: 
+- Cambiado: 
+- Corregido: 
+
+## Métricas
+
+| Métrica | Valor | Objetivo |
+|---------|-------|----------|
+| Cobertura de Tests | | |
+| Rendimiento | | |
+
+---
+
+*Este archivo rastrea el progreso general del proyecto y es actualizado por el agente AI.*

package/src/templates/es/memory/project_brief.md

@@ -0,0 +1,34 @@
+---
+name: project_brief
+description: Visión y objetivos del proyecto - estático, rara vez cambia
+---
+
+# Resumen del Proyecto
+
+## Visión
+
+[Describe la visión general de este proyecto]
+
+## Objetivos
+
+- [ ] Objetivo 1
+- [ ] Objetivo 2
+- [ ] Objetivo 3
+
+## Criterios de Éxito
+
+1. [Criterio 1]
+2. [Criterio 2]
+
+## Restricciones
+
+- [Restricción técnica]
+- [Restricción de negocio]
+- [Restricción de tiempo]
+
+## Stakeholders
+
+| Rol | Nombre | Responsabilidad |
+|-----|--------|-----------------|
+| Propietario | | |
+| Desarrollador | | |