Proyecto personal · Herramienta CLI

agentchecker

Herramienta zero-dependency que unifica las instrucciones de todos tus agentes de IA: escanea archivos locales y configs globales, señala el rule drift y propone fixes interactivos o en modo CI con --check-only.

TypeScriptCLINode.jsSvelteCursorClaude CodeGitHub Actions
agentchecker — vista principal
9+ agentes y editores soportados
4 categorías de stack analizadas
0 instalación global (npx)
CI modo --check-only listo

El reto

Cuando usas varios agentes de IA a la vez, cada uno lee reglas distintas: Cursor mira .cursor/rules, Claude Code CLAUDE.md, Copilot copilot-instructions.md y el equipo humano AGENTS.md. Con el tiempo aparece el rule drift: un agente impone pnpm y oxlint, otro npm y eslint.

El resultado son commits incoherentes, builds rotos y tokens quemados corrigiendo lo que la IA contradijo. Necesitaba una forma rápida de auditar y alinear todo desde la terminal.

Lo que hice

CLI de diagnóstico: monorepo con paquete CLI que escanea archivos del proyecto y configs globales (solo lectura en home), extrae decisiones de package manager, linter, formatter y tests, y muestra un informe claro en terminal.

Corrección guiada: modo interactivo, --dry-run, -y para aplicar fixes y generación automática de AGENTS.md si el proyecto no tiene reglas locales. Integración con Husky pre-commit y job de GitHub Actions en el propio repo.

Producto publicado: landing en Svelte, demo en asciinema/GIF, documentación bilingüe ES/EN y ejecución instantánea con npx agentchecker sin instalar nada globalmente.

agentchecker — captura secundaria 1
agentchecker — captura secundaria 2

Resultado

Una herramienta que uso en mis propios repos antes de commitear con agentes. No sustituye el criterio humano, pero evita que Cursor y Claude discutan en silencio sobre si el proyecto usa pnpm o biome.

Como proyecto personal demuestra que entiendo el ecosistema agentic AI + DX: no solo prompts, sino infraestructura para que varios asistentes trabajen con las mismas reglas. Ideal para equipos que mezclan Cursor, Copilot y Claude Code.

TypeScriptNode.jspnpm workspacesSvelteVitestoxlintHuskyGitHub ActionsasciinemaVercel