Herramientas de dev
Actualizado al 24-oct-2026 (main
f41235c7).
Agent Squad se desarrolla con un flujo de agentes: un cerebro que planifica y audita, manos que implementan, y un orquestador que verifica con evidencia. Para que ese flujo sea rápido y barato en tokens, el proyecto adoptó varias herramientas de desarrollo. Todas son opt-in y ninguna es parte del substrato en producción.
catalog-mcp
Sección titulada «catalog-mcp»Servidor MCP de desarrollo que expone el catálogo de operaciones como tres herramientas compactas, para consultar el catálogo sin leer los archivos completos. Lee el catálogo vivo (75 operaciones al 24-oct-2026), de modo que sus resultados siguen al código. Se registra en .mcp.json del repositorio como agent-squad-catalog y vive en tools/catalog-mcp.
catalog_search: busca operaciones y devuelve una lista corta.operation_describe: el contrato de una operación más el checklist de los cuatro touchpoints.operation_coverage_check: verifica que una operación esté registrada en los cuatro lugares, el error recurrente.
Ahorro medido en julio de 2026, cuando el catálogo era más chico: entre 64 y 90 por ciento de tokens en tareas de consulta, según cuán disciplinado sea el baseline (64 por ciento contra un grep dirigido perfecto, 90 por ciento contra leer el archivo completo). No se volvió a medir con el catálogo actual. Detalle en docs/research/2026-07-11-catalog-mcp-gate-t1-acta.md.
autoskills
Sección titulada «autoskills»Instala skills de mejores prácticas del stack real para que los agentes desarrollen mejor. Se curó un conjunto de 12 skills: accesibilidad, diseño de frontend, Hono, Playwright, el escritor de código Svelte, Svelte 5, tres de Three.js (fundamentos, geometría y materiales), TypeScript avanzado, Vitest y Zod. El skills-lock.json de la raíz del repositorio fija esas 12 y las hace reproducibles.
codebase-memory-mcp
Sección titulada «codebase-memory-mcp»Un grafo de conocimiento persistente del código (funciones, clases, imports, llamadas, arquitectura) expuesto como herramientas MCP. Sirve para que los agentes naveguen y entiendan el codebase sin recorrer archivo por archivo. Está registrado en .mcp.json.
- Ahorro medido en julio de 2026: alrededor de 88 por ciento menos tokens en preguntas del tipo dónde está o quién usa X (122 tokens contra unos 1.080 de grep más lectura), con mayor precisión que grep. Fuente:
docs/research/2026-07-11-codebase-memory-mcp-eval.md. - El índice completo del repo se armó en 1,5 a 1,8 segundos en esa evaluación, sobre el repositorio de entonces.
- Límite honesto: ayuda a encontrar y entender la estructura, no a editar. Para editar siempre se lee el código real y se corren los tests. El conocimiento tribal, las decisiones y los porqués viven en la memoria del equipo y en esta documentación, no en el grafo.
Playwright Agent CLI
Sección titulada «Playwright Agent CLI»Una CLI (playwright-cli) que conduce un navegador real desde la terminal con comandos compactos y snapshots de accesibilidad. Permite a los agentes validar cambios de frontend directamente: abrir una pantalla, interactuar, capturar y verificar, sin escribir un test completo. También monta sesiones autenticadas para validar pantallas con login.
TypeScript 7 en el backend
Sección titulada «TypeScript 7 en el backend»El backend (apps/api y packages/*) usa el compilador nativo de TypeScript 7 (port en Go, versión ^7.0.2). Medido en este repo cuando se adoptó: entre 4 y 6 veces más rápido que TypeScript 6, sin errores con los defaults estrictos de la versión 7. El frontend (apps/web) sigue en TypeScript 6 (fijado en 6.0.3) hasta que svelte-check soporte el compilador nativo, algo que se esperaba con TypeScript 7.1; al 24-oct-2026 no se actualizó. Bun aísla las dos versiones por workspace.
El principio común
Sección titulada «El principio común»Todas estas herramientas comparten una idea: darle a los agentes de desarrollo el contexto correcto de forma barata, en lugar de que relean el mundo en cada tarea. El catálogo, el grafo y las skills reducen tokens de comprensión; el Agent CLI cierra el lazo de validación; el compilador acelera el ciclo. Cada una se adoptó con una evaluación honesta y, donde aplicaba, un spike con números antes de comprometerse.