Herramientas de dev

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 rapido y barato en tokens, el proyecto adopto varias herramientas de desarrollo. Todas son opt-in y ninguna es parte del substrato en produccion.

catalog-mcp

Servidor MCP de desarrollo que expone el catalogo de operaciones como tres herramientas compactas, para consultar el catalogo sin leer los archivos completos.

• catalog_search: busca operaciones y devuelve una lista corta.
• operation_describe: el contrato de una operacion mas el checklist de los cuatro touchpoints.
• operation_coverage_check: verifica que una operacion este registrada en los cuatro lugares, el error recurrente.

Ahorro medido: entre 64 y 90 por ciento de tokens en tareas de consulta del catalogo. Vive en tools/catalog-mcp.

autoskills

Instala skills de mejores practicas del stack real para que los agentes desarrollen mejor. Se curo un conjunto de 12 skills: Svelte 5, Hono, Zod, TypeScript avanzado, Vitest, Playwright, Three.js y accesibilidad, entre otras. Las skills son locales al entorno; el skills-lock.json las hace reproducibles.

codebase-memory-mcp

Un grafo de conocimiento persistente del codigo (funciones, clases, imports, llamadas, arquitectura) expuesto como herramientas MCP. Sirve para que los agentes naveguen y entiendan el codebase sin recorrer archivo por archivo.

• Ahorro medido: alrededor de 88 por ciento menos tokens en preguntas del tipo donde esta o quien usa X, con mayor precision que grep.
• El indice completo del repo se arma en menos de dos segundos.
• Limite honesto: ayuda a encontrar y entender la estructura, no a editar. Para editar siempre se lee el codigo real y se corren los tests. El conocimiento tribal, las decisiones y los porques viven en la memoria del equipo y en esta documentacion, no en el grafo.

De hecho, buena parte del material factual de esta documentacion (rutas, modulos, estructura) se extrajo de este grafo.

Playwright Agent CLI

Una 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. Tambien monta sesiones autenticadas para validar pantallas con login.

TypeScript 7 en el backend

El backend (apps/api y packages/*) usa el compilador nativo de TypeScript 7 (port en Go). Medido en este repo: entre 4 y 6 veces mas rapido que TypeScript 6, sin errores con los defaults estrictos de la version 7. El frontend (apps/web) sigue en TypeScript 6 hasta que las herramientas de Svelte soporten el compilador nativo, previsto para TypeScript 7.1. Bun aisla las dos versiones por workspace.

El principio comun

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 catalogo, el grafo y las skills reducen tokens de comprension; el Agent CLI cierra el lazo de validacion; el compilador acelera el ciclo. Cada una se adopto con una evaluacion honesta y, donde aplicaba, un spike con numeros antes de comprometerse.