agent-ctx 1.0.0

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

@@ -0,0 +1,44 @@
+---
+name: tech_context
+description: Stack técnico y dependencias - semi-estático, actualiza con cambios mayores
+---
+
+# Contexto Técnico
+
+## Stack
+
+| Capa | Tecnología | Versión |
+|------|------------|---------|
+| Lenguaje | | |
+| Framework | | |
+| Base de datos | | |
+| Cache | | |
+| Hosting | | |
+
+## Dependencias
+
+### Producción
+
+| Paquete | Propósito |
+|---------|-----------|
+| | |
+
+### Desarrollo
+
+| Paquete | Propósito |
+|---------|-----------|
+| | |
+
+## Decisiones de Arquitectura
+
+### [Decisión 1]
+
+**Contexto:** 
+**Decisión:** 
+**Consecuencias:** 
+
+## Puntos de Integración
+
+- **API:** 
+- **Servicios Externos:** 
+- **Terceros:** 

package/src/templates/es/rules/rule-coding-standards.md

@@ -0,0 +1,22 @@
+# Estándares de Código y Reglas
+
+## 1. Principios Generales
+- **DRY (Don't Repeat Yourself):** Extrae lógica repetida a hooks o utilidades.
+- **KISS (Keep It Simple, Stupid):** Prefiere la solución más legible a la más "inteligente".
+- **Composición:** Prefiere componentes pequeños y compuestos sobre monolitos.
+
+## 2. TypeScript & Tipado
+- **Prohibido:** Usar `any`. Si no sabes el tipo, usa `unknown` y haz narrowing.
+- **Requerido:** Definir interfaces/tipos para todas las Props de componentes.
+- **Preferencia:** Usa `type` para definiciones de objetos y `interface` si necesitas extenderlas.
+
+## 3. Estilos y Naming
+- **Componentes:** `PascalCase` (ej: `UserProfile.tsx`).
+- **Funciones/Variables:** `camelCase` (ej: `getUserData`).
+- **Constantes:** `UPPER_SNAKE_CASE` (ej: `MAX_RETRY_COUNT`).
+- **CSS:** Usamos [Tailwind CSS]. Evita estilos en línea (`style={{...}}`).
+
+## 4. Gestión de Errores
+- Envuelve llamadas asíncronas en bloques `try/catch`.
+- Usa componentes `ErrorBoundary` para fallos de UI.
+- Nunca dejes un `catch` vacío. Loguea el error.

package/src/templates/es/skills/skill-agents.md

@@ -0,0 +1,74 @@
+---
+name: managing-agents
+description: Configurar y actualizar el archivo AGENTS.md de contexto para agentes AI. Usar cuando se configura contexto de agente o se modifican instrucciones.
+---
+
+# Gestionando Contexto de Agentes
+
+Configurar el archivo AGENTS.md que orienta a los agentes AI en tu proyecto.
+
+## Cuándo usar
+
+- Configurar contexto de agente AI para un nuevo proyecto
+- Actualizar instrucciones de agente
+- Añadir nuevas fuentes de conocimiento para agentes
+- Cambiar cómo deben comportarse los agentes en tu proyecto
+
+## Propósito de AGENTS.md
+
+El archivo AGENTS.md es el punto de entrada para agentes AI. Les dice:
+- Qué hace el proyecto
+- Dónde encontrar información crítica
+- Cómo comportarse y qué reglas seguir
+
+## Plantilla Estándar
+
+```markdown
+# Contexto de Agente AI
+
+Eres un desarrollador senior uniéndote a este proyecto.
+Tu objetivo es ayudar a construir, refactorizar y mantener código siguiendo nuestra arquitectura.
+
+## Índice de Conocimiento
+
+Antes de escribir código, carga contexto de:
+
+- **Arquitectura:** `.context/architecture.md`
+- **Reglas:** `.context/rules/coding-standards.md`
+- **Skills:** `.context/skills/`
+
+## Estado Actual
+
+Consulta `.context/project_state.md` para el estado actual del trabajo.
+```
+
+## Mejores prácticas
+
+### ✅ Hacer
+
+- Mantener AGENTS.md conciso (menos de 50 líneas)
+- Apuntar a archivos detallados en vez de duplicar contenido
+- Actualizar cuando cambia la estructura del proyecto
+- Incluir ruta a reglas y convenciones
+
+### ❌ Evitar
+
+- Poner documentación detallada en AGENTS.md
+- Rutas de archivo desactualizadas
+- Instrucciones genéricas sin especificidad del proyecto
+- Información conflictiva entre archivos
+
+## Ubicación
+
+AGENTS.md debe estar en la raíz del proyecto:
+
+```
+proyecto/
+├── AGENTS.md           # Punto de entrada para agentes AI
+├── .context/           # Contexto detallado
+│   ├── architecture.md
+│   ├── project_state.md
+│   ├── rules/
+│   └── skills/
+└── src/
+```

package/src/templates/es/skills/skill-api.md

@@ -0,0 +1,117 @@
+---
+name: api-design
+description: Diseña APIs REST con patrones consistentes, códigos HTTP apropiados y validación. Usar cuando se crean endpoints, manejo de errores o versionado de APIs.
+---
+
+# API Design
+
+Patrones y mejores prácticas para diseñar APIs REST.
+
+## Cuándo usar
+
+- Diseñar endpoints REST
+- Manejar errores de forma consistente
+- Versionado de APIs
+- Validación de requests
+
+## Convenciones REST
+
+### Estructura de URLs
+
+```
+GET    /api/v1/users          # Listar usuarios
+GET    /api/v1/users/:id      # Obtener usuario
+POST   /api/v1/users          # Crear usuario
+PUT    /api/v1/users/:id      # Actualizar completo
+PATCH  /api/v1/users/:id      # Actualizar parcial
+DELETE /api/v1/users/:id      # Eliminar usuario
+```
+
+### Query Parameters
+
+```
+GET /api/v1/users?
+  page=1&                     # Paginación
+  limit=20&                   # Items por página
+  sort=createdAt:desc&        # Ordenamiento
+  filter[status]=active       # Filtros
+```
+
+## Respuestas Estándar
+
+### Éxito (200, 201)
+
+```json
+{
+  "success": true,
+  "data": { "id": "123", "name": "John Doe" },
+  "meta": { "page": 1, "total": 100 }
+}
+```
+
+### Error (400, 404, 500)
+
+```json
+{
+  "success": false,
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Email is required",
+    "details": [{ "field": "email", "message": "Required" }]
+  }
+}
+```
+
+## Códigos HTTP
+
+| Código | Significado | Uso |
+|--------|-------------|-----|
+| 200 | OK | GET, PUT/PATCH exitoso |
+| 201 | Created | POST exitoso |
+| 204 | No Content | DELETE exitoso |
+| 400 | Bad Request | Validación fallida |
+| 401 | Unauthorized | No autenticado |
+| 403 | Forbidden | Sin permisos |
+| 404 | Not Found | Recurso no existe |
+| 500 | Server Error | Error interno |
+
+## Ejemplo de Validación
+
+```typescript
+import { z } from 'zod';
+
+const userSchema = z.object({
+  email: z.string().email(),
+  name: z.string().min(2),
+  role: z.enum(['admin', 'user'])
+});
+
+export function validate(schema: z.ZodSchema) {
+  return (req, res, next) => {
+    const result = schema.safeParse(req.body);
+    if (!result.success) {
+      return res.status(400).json({
+        success: false,
+        error: { code: 'VALIDATION_ERROR', details: result.error.issues }
+      });
+    }
+    req.body = result.data;
+    next();
+  };
+}
+```
+
+## Mejores prácticas
+
+### ✅ Hacer
+
+- Usar HTTPS siempre
+- Versionado en URL (`/api/v1/`)
+- Rate limiting
+- Respuestas consistentes
+
+### ❌ Evitar
+
+- Verbos en URLs (`/getUsers`, `/deleteUser`)
+- Exponer IDs internos
+- Respuestas sin formato estándar

package/src/templates/es/skills/skill-architecture.md

@@ -0,0 +1,87 @@
+---
+name: documenting-architecture
+description: Documentar arquitectura de proyecto, tech stack y flujo de datos. Usar cuando se configura o actualiza documentación de arquitectura.
+---
+
+# Documentando Arquitectura
+
+Crear y mantener documentación de arquitectura para agentes AI y desarrolladores.
+
+## Cuándo usar
+
+- Iniciar un nuevo proyecto
+- Cambios importantes en tech stack
+- Añadir nuevos servicios o integraciones
+- Onboarding de nuevos miembros o agentes AI
+
+## Estructura del Documento de Arquitectura
+
+```markdown
+# Arquitectura del Proyecto
+
+## Objetivo del Proyecto
+[2-3 líneas describiendo el propósito de la aplicación]
+
+## Tech Stack
+
+### Frontend
+| Tecnología | Versión | Propósito |
+|------------|---------|-----------|
+| React      | 18.x    | UI        |
+
+### Backend
+| Tecnología | Versión | Propósito |
+|------------|---------|-----------|
+| Node.js    | 20.x    | API       |
+
+## Estructura de Directorios
+[Árbol mostrando directorios clave]
+
+## Flujo de Datos
+[Diagrama o descripción de cómo fluyen los datos]
+
+## Variables de Entorno
+| Variable | Descripción | Requerida |
+|----------|-------------|-----------|
+| API_KEY  | Clave de servicio | ✅  |
+```
+
+## Secciones Clave
+
+1. **Tech Stack**: Todas las tecnologías con versiones
+2. **Estructura de Directorios**: Carpetas clave y su propósito
+3. **Flujo de Datos**: Cómo se mueven los datos por el sistema
+4. **Variables de Entorno**: Configuración requerida
+5. **Dependencias Críticas**: Paquetes importantes
+
+## Triggers de Actualización
+
+Actualizar architecture.md cuando:
+- Se añaden nuevos frameworks o librerías
+- Cambia la estructura de directorios
+- Se añaden nuevos servicios o APIs
+- Se modifica el flujo de datos
+
+## Mejores prácticas
+
+### ✅ Hacer
+
+- Incluir versiones específicas
+- Documentar el POR QUÉ no solo el QUÉ
+- Mantener actualizado con el codebase
+- Usar tablas para escaneo rápido
+
+### ❌ Evitar
+
+- Números de versión desactualizados
+- Integraciones críticas faltantes
+- Demasiado detalle (enlazar a docs)
+- Detalles de implementación (poner en comentarios de código)
+
+## Ubicación del Archivo
+
+```
+proyecto/
+└── .context/
+    └── architecture.md  # Documento principal de arquitectura
+```

package/src/templates/es/skills/skill-generating.md

@@ -0,0 +1,116 @@
+---
+name: generating-skills
+description: Crear nuevos skills de agente siguiendo las mejores prácticas de SKILL.md. Usar cuando se crean, validan o mejoran archivos de skills para consumo de agentes AI.
+---
+
+# Generando Skills
+
+Crear skills efectivos que los agentes AI puedan descubrir y usar.
+
+## Cuándo usar
+
+- Crear un nuevo skill desde cero
+- Validar formato de skill existente
+- Mejorar la descubribilidad de skills
+- Convertir documentación a formato de skill
+
+## Estructura de Carpetas Estándar
+
+```
+nombre-skill/
+├── SKILL.md        # Requerido: instrucciones + metadata
+├── scripts/        # Opcional: utilidades ejecutables
+├── references/     # Opcional: documentación detallada
+└── assets/         # Opcional: plantillas, recursos
+```
+
+Para skills simples, un solo archivo `SKILL.md` es suficiente.
+
+## Requisitos de YAML Frontmatter
+
+```yaml
+---
+name: nombre-skill
+description: Qué hace el skill y cuándo usarlo. Tercera persona. Max 1024 chars.
+---
+```
+
+### Validación de Nombre
+
+- Máximo 64 caracteres
+- Solo letras minúsculas, números, guiones
+- Sin guiones consecutivos (`--`)
+- No puede empezar/terminar con guión
+- Patrón: `^[a-z0-9]+(-[a-z0-9]+)*$`
+
+**Buenos nombres**: `api-design`, `git-workflow`, `processing-pdfs`
+**Malos nombres**: `APIDesign`, `git--workflow`, `-api-design`
+
+### Guías de Descripción
+
+- Escribir en tercera persona
+- Incluir QUÉ hace Y CUÁNDO usarlo
+- Ser específico con términos de activación
+- Máximo 1024 caracteres
+
+**Bueno**: `Diseña APIs REST con patrones consistentes. Usar cuando se crean endpoints o manejo de errores.`
+**Malo**: `Ayuda con APIs`
+
+## Plantilla SKILL.md
+
+```markdown
+---
+name: nombre-skill
+description: Descripción breve en tercera persona. Incluir cuándo usar.
+---
+
+# Nombre del Skill
+
+Breve descripción.
+
+## Cuándo usar
+
+- Condición de activación 1
+- Condición de activación 2
+
+## Inicio rápido
+
+Ejemplo mínimo para empezar.
+
+## Pasos de implementación
+
+1. Paso 1
+2. Paso 2
+
+## Mejores prácticas
+
+### ✅ Hacer
+- Buena práctica
+
+### ❌ Evitar
+- Anti-patrón
+
+## Referencias
+
+- [Enlace](url)
+```
+
+## Eficiencia de Tokens
+
+- Mantener SKILL.md bajo 500 líneas
+- Dividir contenido en archivos separados para skills complejos
+- Usar revelación progresiva (archivos referenciados cargados bajo demanda)
+- Asumir que Claude conoce patrones comunes
+
+## Checklist de Workflow
+
+Copia y sigue el progreso:
+
+```
+- [ ] Nombre sigue formato lowercase-hyphen
+- [ ] Descripción es específica e incluye triggers
+- [ ] Sección "Cuándo usar" presente
+- [ ] Ejemplo de inicio rápido incluido
+- [ ] Mejores prácticas documentadas
+- [ ] Menos de 500 líneas
+```

package/src/templates/es/skills/skill-git.md

@@ -0,0 +1,108 @@
+---
+name: git-workflow
+description: Convenciones Git, estrategias de branching y formato de commits. Usar cuando se crean commits, branches, PRs o se resuelven conflictos.
+---
+
+# Git Workflow
+
+Convenciones Git, commits y patrones de flujo de trabajo.
+
+## Cuándo usar
+
+- Escribir mensajes de commit
+- Crear feature branches
+- Gestionar pull requests
+- Resolver conflictos o hacer rebase
+
+## Commits (Conventional Commits)
+
+### Formato
+
+```
+<type>(<scope>): <description>
+
+[cuerpo opcional]
+
+[footer opcional]
+```
+
+### Tipos
+
+| Tipo | Descripción |
+|------|-------------|
+| `feat` | Nueva funcionalidad |
+| `fix` | Corrección de bug |
+| `docs` | Solo documentación |
+| `style` | Formato (sin cambio de código) |
+| `refactor` | Refactorización |
+| `test` | Añadir/modificar tests |
+| `chore` | Mantenimiento, deps |
+| `perf` | Mejora de rendimiento |
+
+### Ejemplos
+
+```bash
+feat(auth): añadir login con Google OAuth
+fix(api): manejar respuesta null en fetch de usuario
+docs: actualizar guía de instalación
+
+# Breaking change
+feat(api)!: cambiar formato de respuesta
+
+BREAKING CHANGE: Response ahora devuelve datos en `result` en vez de `data`
+```
+
+## Estrategia de Branching (Git Flow)
+
+```
+main (producción)
+  │
+  └── develop (desarrollo)
+        │
+        ├── feature/nueva-funcionalidad
+        ├── bugfix/corregir-bug
+        └── release/v1.2.0
+```
+
+### Crear Feature Branch
+
+```bash
+git checkout develop
+git pull origin develop
+git checkout -b feature/nombre-descriptivo
+```
+
+## Comandos Útiles
+
+```bash
+# Stash
+git stash                    # Guardar cambios
+git stash pop                # Restaurar cambios
+
+# Rebase interactivo
+git rebase -i HEAD~3         # Últimos 3 commits
+
+# Cherry Pick
+git cherry-pick abc123       # Aplicar commit específico
+
+# Bisect (encontrar bug)
+git bisect start
+git bisect bad               # Commit actual tiene bug
+git bisect good abc123       # Commit bueno conocido
+```
+
+## Mejores prácticas
+
+### ✅ Hacer
+
+- Commits atómicos (un cambio lógico por commit)
+- PRs pequeños y enfocados
+- Rebase antes de merge
+- Squash commits WIP
+
+### ❌ Evitar
+
+- Commits con solo "fix" o "update"
+- PRs gigantes (>500 líneas)
+- Force push a branches compartidas
+- Mezclar refactors con features

package/src/templates/es/skills/skill-project-state.md

@@ -0,0 +1,99 @@
+---
+name: tracking-project-state
+description: Gestionar documentación de estado del proyecto para contexto de agentes AI. Usar cuando se actualiza estado de trabajo, prioridades o fase del proyecto.
+---
+
+# Seguimiento del Estado del Proyecto
+
+Mantener un documento vivo del estado actual del proyecto para agentes AI.
+
+## Cuándo usar
+
+- Iniciar o completar tareas importantes
+- Cambiar prioridades del proyecto
+- Surgen bloqueos
+- Transiciones de sprint o fase
+
+## Estructura del Estado del Proyecto
+
+```markdown
+# Estado del Proyecto
+
+## Fase Actual
+[Desarrollo / Testing / Mantenimiento / etc.]
+
+## Trabajo Activo
+
+### En Progreso
+- [ ] Feature X - [estado breve]
+- [ ] Bug fix Y - [estado breve]
+
+### Bloqueado
+- Issue Z - [razón] - [responsable]
+
+## Completados Recientes
+- ✅ Feature A (fecha)
+- ✅ Bug fix B (fecha)
+
+## Próximas Prioridades
+1. Tarea prioritaria 1
+2. Tarea prioritaria 2
+
+## Issues Conocidos
+- Descripción del issue - [severidad]
+```
+
+## Frecuencia de Actualización
+
+Actualizar project_state.md cuando:
+- Se inicia trabajo significativo
+- Se completan features o fixes
+- Se encuentran bloqueos
+- Cambian prioridades
+- Comienza nuevo sprint/fase
+
+## Mejores prácticas
+
+### ✅ Hacer
+
+- Mantenerlo actual (actualizar mismo día)
+- Ser específico sobre el estado
+- Incluir bloqueos y responsables
+- Fechar completados recientes
+- Limitar a prioridades principales
+
+### ❌ Evitar
+
+- Información desactualizada (>1 semana)
+- Demasiado detalle (enlazar a issues)
+- Log histórico (mantener solo reciente)
+- Actualizaciones de estado vagas
+
+## Integración con Agentes AI
+
+Los agentes AI consultan project_state.md para:
+- Entender en qué se está trabajando
+- Evitar cambios conflictivos
+- Priorizar sus sugerencias
+- Proporcionar ayuda contextual
+
+## Ubicación del Archivo
+
+```
+proyecto/
+└── .context/
+    └── project_state.md  # Estado actual del proyecto
+```
+
+## Plantilla de Actualización Rápida
+
+Al actualizar, usa este formato:
+
+```markdown
+## Actualización [Fecha]
+
+**Completado**: [qué se terminó]
+**En Progreso**: [en qué se está trabajando]
+**Siguiente**: [próxima prioridad]
+**Bloqueado**: [bloqueos] (si aplica)
+```