agent-ctx 1.0.0 → 2.0.0

package/package.json

@@ -1,63 +1,77 @@
-{
-  "name": "agent-ctx",
-  "version": "1.0.0",
-  "description": "CLI tool to initialize and manage AI agent context for your projects",
-  "keywords": [
-    "ai",
-    "agent",
-    "context",
-    "cursor",
-    "antigravity",
-    "claude",
-    "copilot",
-    "cline",
-    "cli"
-  ],
-  "author": "avicdro",
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "agent-ctx": "./dist/bin/agent-ctx.js"
-  },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist",
-    "src/templates"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "test": "npm run build && node --test",
-    "lint": "eslint src/",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "figlet": "^1.10.0",
-    "inquirer": "^9.2.23",
-    "ora": "^8.0.1",
-    "tar": "^7.5.7"
-  },
-  "devDependencies": {
-    "@types/figlet": "^1.7.0",
-    "@types/inquirer": "^9.0.9",
-    "@types/node": "^25.1.0",
-    "@types/tar": "^6.1.13",
-    "eslint": "^9.39.2",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/avicdro/agent-ctx"
-  },
-  "bugs": {
-    "url": "https://github.com/avicdro/agent-ctx/issues"
-  },
-  "homepage": "https://github.com/avicdro/agent-ctx#readme"
-}
+{
+  "name": "agent-ctx",
+  "version": "2.0.0",
+  "description": "CLI tool to initialize and manage AI agent context for your projects",
+  "keywords": [
+    "ai",
+    "agent",
+    "context",
+    "cursor",
+    "antigravity",
+    "claude",
+    "copilot",
+    "cline",
+    "cli"
+  ],
+  "author": "avicdro",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "agent-ctx": "./dist/bin/agent-ctx.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src/templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "npm run build && node --test",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "figlet": "^1.10.0",
+    "inquirer": "^9.2.23",
+    "ora": "^8.0.1",
+    "tar": "^7.5.7"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.4.1",
+    "@commitlint/config-conventional": "^20.4.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/figlet": "^1.7.0",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^25.1.0",
+    "@types/tar": "^6.1.13",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1",
+    "semantic-release": "^25.0.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/avicdro/agent-ctx"
+  },
+  "bugs": {
+    "url": "https://github.com/avicdro/agent-ctx/issues"
+  },
+  "homepage": "https://github.com/avicdro/agent-ctx#readme"
+}

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

@@ -1,6 +1,6 @@
 ---
 name: managing-agents
-description: Configure and update AGENTS.md context file for AI agents. Use when setting up agent context or modifying agent instructions.
+description: Configure and auto-sync AGENTS.md with .context/ files. Use when setting up agent context, modifying agent instructions, or after changes to rules/skills.
 ---
 
 # Managing Agents Context
@@ -10,16 +10,26 @@ Configure the AGENTS.md file that orients AI agents to your project.
 ## When to use
 
 - Setting up AI agent context for a new project
-- Updating agent instructions
-- Adding new knowledge sources for agents
+- After adding new rules to `.context/rules/`
+- After adding new skills to `.context/skills/`
+- After updating architecture or project state
 - Changing how agents should behave in your project
 
 ## AGENTS.md Purpose
 
-The AGENTS.md file is the entry point for AI agents. It tells them:
-- What the project does
-- Where to find critical information
-- How to behave and what rules to follow
+The AGENTS.md file is the **universal entry point** for ALL AI agents:
+- Cursor, Copilot, Claude, Gemini, Windsurf all read this file
+- It provides a single source of truth for project context
+- It indexes all content in `.context/`
+
+## Auto-Sync Trigger
+
+**After modifying any file in `.context/`**, check if AGENTS.md needs updating:
+
+1. Scan `.context/rules/` for all `.md` files
+2. Scan `.context/skills/` for all `SKILL.md` files
+3. Update the Knowledge Index section if files changed
+4. Keep AGENTS.md under 50 lines
 
 ## Standard Template
 
@@ -31,15 +41,29 @@ Your goal is to help build, refactor, and maintain code following our architectu
 
 ## Knowledge Index
 
-Before writing code, load context from:
+| Area | Path | Description |
+|------|------|-------------|
+| Architecture | `.context/architecture.md` | Project structure |
+| Rules | `.context/rules/` | Coding standards |
+| Skills | `.context/skills/` | Reusable instructions |
+| State | `.context/project_state.md` | Current work |
+| Memory | `.context/memory/` | Session persistence |
+
+## Active Rules
+
+- [coding-standards](.context/rules/coding-standards.md)
+
+## Available Skills
 
-- **Architecture:** `.context/architecture.md`
-- **Rules:** `.context/rules/coding-standards.md`
-- **Skills:** `.context/skills/`
+- [generating-skills](.context/skills/generating-skills/SKILL.md)
+- [managing-agents](.context/skills/managing-agents/SKILL.md)
+...
 
-## Current State
+## Principles
 
-Check `.context/project_state.md` for current work status.
+- Follow all rules in `.context/rules/`
+- Check project state before starting work
+- Update memory bank at session end
 ```
 
 ## Best Practices
@@ -48,15 +72,15 @@ Check `.context/project_state.md` for current work status.
 
 - Keep AGENTS.md concise (under 50 lines)
 - Point to detailed files instead of duplicating content
-- Update when project structure changes
-- Include path to rules and conventions
+- Update when `.context/` structure changes
+- Include table of contents to all context areas
 
 ### ❌ Avoid
 
 - Putting detailed documentation in AGENTS.md
 - Outdated file paths
 - Generic instructions without project specifics
-- Conflicting information between files
+- Forgetting to list new rules or skills
 
 ## Placement
 
@@ -64,11 +88,12 @@ AGENTS.md should be at the project root:
 
 ```
 project/
-├── AGENTS.md           # AI agent entry point
+├── AGENTS.md           # AI agent entry point (universal hub)
 ├── .context/           # Detailed context
 │   ├── architecture.md
 │   ├── project_state.md
 │   ├── rules/
-│   └── skills/
+│   ├── skills/
+│   └── memory/
 └── src/
 ```

package/src/templates/en/skills/skill-memory.md

@@ -0,0 +1,97 @@
+---
+name: managing-memory
+description: Maintain the Memory Bank files in .context/memory/. Use when updating project state, tracking progress, or persisting context between sessions.
+---
+
+# Managing Memory Bank
+
+Keep the Memory Bank files updated to maintain context persistence across AI sessions.
+
+## When to use
+
+- Starting a new development session (read memory files first)
+- Completing a significant task (update progress)
+- Changing project focus (update active context)
+- Major architectural decisions (update tech context)
+
+## Memory Bank Structure
+
+```
+.context/memory/
+├── project_brief.md    # Vision and goals (rarely changes)
+├── tech_context.md     # Stack and patterns (updates with tech changes)
+├── active_context.md   # Current focus (updates frequently)
+└── progress.md         # Milestones and changelog (updates per task)
+```
+
+## File Update Frequency
+
+| File | Update Frequency | Trigger |
+|------|------------------|---------|
+| `project_brief.md` | Rarely | Major goal changes |
+| `tech_context.md` | Occasionally | New tech, patterns |
+| `active_context.md` | Every session | Focus changes |
+| `progress.md` | Per task | Task completion |
+
+## Update Guidelines
+
+### active_context.md
+
+Update at the START and END of each session:
+
+```markdown
+## Current Focus
+[What you're working on NOW]
+
+## Recent Changes
+- [Most recent first]
+
+## Next Steps
+1. [ ] Immediate next action
+```
+
+### progress.md
+
+Update when completing significant work:
+
+```markdown
+### [DATE]
+- Added: [new features]
+- Changed: [modifications]
+- Fixed: [bug fixes]
+```
+
+### tech_context.md
+
+Update when adding new dependencies or patterns:
+
+```markdown
+## Stack
+| Technology | Version | Purpose |
+|------------|---------|---------|
+| [New tech] | [ver]   | [why]   |
+```
+
+## Best Practices
+
+### ✅ Do
+
+- Read ALL memory files at session start
+- Update `active_context.md` before ending work
+- Keep entries concise and scannable
+- Use tables for structured data
+- Include dates on progress entries
+
+### ❌ Avoid
+
+- Duplicating information across files
+- Leaving outdated "Current Focus"
+- Forgetting to update progress after completing tasks
+- Writing paragraphs instead of bullet points
+
+## Session Workflow
+
+1. **Start**: Read all memory files for context
+2. **Work**: Focus on current task
+3. **Complete**: Update progress.md with changes
+4. **End**: Update active_context.md with next steps

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

@@ -1,6 +1,6 @@
 ---
 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.
+description: Configurar y sincronizar AGENTS.md con los archivos de .context/. Usar al configurar contexto de agente, modificar instrucciones, o después de cambios en rules/skills.
 ---
 
 # Gestionando Contexto de Agentes
@@ -10,16 +10,26 @@ 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
+- Después de añadir nuevas reglas a `.context/rules/`
+- Después de añadir nuevas skills a `.context/skills/`
+- Después de actualizar arquitectura o estado del proyecto
 - 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
+El archivo AGENTS.md es el **punto de entrada universal** para TODOS los agentes AI:
+- Cursor, Copilot, Claude, Gemini, Windsurf todos leen este archivo
+- Proporciona una única fuente de verdad para el contexto del proyecto
+- Indexa todo el contenido de `.context/`
+
+## Disparador de Auto-Sync
+
+**Después de modificar cualquier archivo en `.context/`**, verifica si AGENTS.md necesita actualización:
+
+1. Escanear `.context/rules/` para todos los archivos `.md`
+2. Escanear `.context/skills/` para todos los archivos `SKILL.md`
+3. Actualizar la sección de Índice de Conocimiento si hay cambios
+4. Mantener AGENTS.md bajo 50 líneas
 
 ## Plantilla Estándar
 
@@ -31,15 +41,29 @@ Tu objetivo es ayudar a construir, refactorizar y mantener código siguiendo nue
 
 ## Índice de Conocimiento
 
-Antes de escribir código, carga contexto de:
+| Área | Ruta | Descripción |
+|------|------|-------------|
+| Arquitectura | `.context/architecture.md` | Estructura del proyecto |
+| Reglas | `.context/rules/` | Estándares de código |
+| Skills | `.context/skills/` | Instrucciones reutilizables |
+| Estado | `.context/project_state.md` | Trabajo actual |
+| Memoria | `.context/memory/` | Persistencia de sesión |
+
+## Reglas Activas
+
+- [coding-standards](.context/rules/coding-standards.md)
+
+## Skills Disponibles
 
-- **Arquitectura:** `.context/architecture.md`
-- **Reglas:** `.context/rules/coding-standards.md`
-- **Skills:** `.context/skills/`
+- [generating-skills](.context/skills/generating-skills/SKILL.md)
+- [managing-agents](.context/skills/managing-agents/SKILL.md)
+...
 
-## Estado Actual
+## Principios
 
-Consulta `.context/project_state.md` para el estado actual del trabajo.
+- Seguir todas las reglas en `.context/rules/`
+- Revisar estado del proyecto antes de empezar
+- Actualizar memory bank al finalizar sesión
 ```
 
 ## Mejores prácticas
@@ -48,15 +72,15 @@ Consulta `.context/project_state.md` para el estado actual del trabajo.
 
 - 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
+- Actualizar cuando cambia la estructura de `.context/`
+- Incluir tabla de contenidos hacia todas las áreas de contexto
 
 ### ❌ Evitar
 
 - Poner documentación detallada en AGENTS.md
 - Rutas de archivo desactualizadas
 - Instrucciones genéricas sin especificidad del proyecto
-- Información conflictiva entre archivos
+- Olvidar listar nuevas reglas o skills
 
 ## Ubicación
 
@@ -64,11 +88,12 @@ AGENTS.md debe estar en la raíz del proyecto:
 
 ```
 proyecto/
-├── AGENTS.md           # Punto de entrada para agentes AI
+├── AGENTS.md           # Punto de entrada (hub universal)
 ├── .context/           # Contexto detallado
 │   ├── architecture.md
 │   ├── project_state.md
 │   ├── rules/
-│   └── skills/
+│   ├── skills/
+│   └── memory/
 └── src/
 ```

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

@@ -0,0 +1,97 @@
+---
+name: managing-memory
+description: Mantiene los archivos del Memory Bank en .context/memory/. Usar al actualizar el estado del proyecto, seguir el progreso o persistir contexto entre sesiones.
+---
+
+# Gestión del Memory Bank
+
+Mantén los archivos del Memory Bank actualizados para mantener el contexto entre sesiones de IA.
+
+## Cuándo usar
+
+- Al iniciar una nueva sesión de desarrollo (leer archivos primero)
+- Al completar una tarea significativa (actualizar progreso)
+- Al cambiar el foco del proyecto (actualizar contexto activo)
+- Decisiones arquitectónicas importantes (actualizar contexto técnico)
+
+## Estructura del Memory Bank
+
+```
+.context/memory/
+├── project_brief.md    # Visión y objetivos (cambia raramente)
+├── tech_context.md     # Stack y patrones (actualiza con cambios técnicos)
+├── active_context.md   # Foco actual (actualiza frecuentemente)
+└── progress.md         # Hitos y changelog (actualiza por tarea)
+```
+
+## Frecuencia de Actualización
+
+| Archivo | Frecuencia | Disparador |
+|---------|------------|------------|
+| `project_brief.md` | Rara vez | Cambios de objetivos importantes |
+| `tech_context.md` | Ocasionalmente | Nueva tecnología, patrones |
+| `active_context.md` | Cada sesión | Cambios de foco |
+| `progress.md` | Por tarea | Completar tarea |
+
+## Guías de Actualización
+
+### active_context.md
+
+Actualizar al INICIO y FIN de cada sesión:
+
+```markdown
+## Foco Actual
+[En qué estás trabajando AHORA]
+
+## Cambios Recientes
+- [Más reciente primero]
+
+## Próximos Pasos
+1. [ ] Próxima acción inmediata
+```
+
+### progress.md
+
+Actualizar al completar trabajo significativo:
+
+```markdown
+### [FECHA]
+- Añadido: [nuevas características]
+- Cambiado: [modificaciones]
+- Arreglado: [correcciones de bugs]
+```
+
+### tech_context.md
+
+Actualizar al añadir nuevas dependencias o patrones:
+
+```markdown
+## Stack
+| Tecnología | Versión | Propósito |
+|------------|---------|-----------|
+| [Nueva tech] | [ver] | [por qué] |
+```
+
+## Mejores Prácticas
+
+### ✅ Hacer
+
+- Leer TODOS los archivos de memoria al inicio de la sesión
+- Actualizar `active_context.md` antes de terminar el trabajo
+- Mantener las entradas concisas y escaneables
+- Usar tablas para datos estructurados
+- Incluir fechas en las entradas de progreso
+
+### ❌ Evitar
+
+- Duplicar información entre archivos
+- Dejar "Foco Actual" desactualizado
+- Olvidar actualizar el progreso después de completar tareas
+- Escribir párrafos en lugar de viñetas
+
+## Flujo de Trabajo por Sesión
+
+1. **Inicio**: Leer todos los archivos de memoria para contexto
+2. **Trabajo**: Enfocarse en la tarea actual
+3. **Completar**: Actualizar progress.md con los cambios
+4. **Fin**: Actualizar active_context.md con próximos pasos

package/dist/bin/agentrc.d.ts

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-/**
- * agentrc - CLI for AI Agent Context Management
- * Entry point
- */
-export {};
-//# sourceMappingURL=agentrc.d.ts.map

package/dist/bin/agentrc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentrc.d.ts","sourceRoot":"","sources":["../../src/bin/agentrc.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/bin/agentrc.js

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-/**
- * agentrc - CLI for AI Agent Context Management
- * Entry point
- */
-import { run } from '../index.js';
-run();
-//# sourceMappingURL=agentrc.js.map

package/dist/bin/agentrc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentrc.js","sourceRoot":"","sources":["../../src/bin/agentrc.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,GAAG,EAAE,CAAC"}

package/dist/lib/wizard.d.ts

@@ -1,22 +0,0 @@
-/**
- * @fileoverview Wizard interactivo para configuración de proyectos
- * @module lib/wizard
- */
-type ProjectType = 'frontend' | 'backend' | 'fullstack' | 'library' | 'cli';
-export interface ProjectConfig {
-    type: ProjectType;
-    framework: string;
-    typescript?: boolean;
-    styling?: string;
-    features?: string[];
-}
-/**
- * Ejecuta el wizard interactivo para configurar el proyecto
- */
-export declare function runWizard(): Promise<ProjectConfig>;
-/**
- * Genera contenido de architecture.md basado en la configuración
- */
-export declare function generateArchitecture(config: ProjectConfig): string;
-export {};
-//# sourceMappingURL=wizard.d.ts.map

package/dist/lib/wizard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/lib/wizard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,KAAK,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AA4CD;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAgExD;AAuBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAiElE"}