AKILI
Reduce a la mitad los tiempos de desarrollo sin sacrificar calidad: desarrollo spec-driven y constitution-first para agentes de IA en Claude Code, OpenCode y Google Antigravity.
SDD (Spec-Driven Development, o desarrollo guiado por especificaciones) es el principio detrás de AKILI: antes de escribir código se acuerda una especificación —requisitos, diseño y criterios de aceptación— y tanto las personas como los agentes de IA construyen a partir de ese contrato. Así el trabajo asistido por IA se vuelve trazable, auditable y repetible, en lugar de depender de prompts sueltos.
La mayoría de desarrolladores usa IA de manera reactiva: pegan prompts y esperan que el código funcione. AKILI lo reemplaza por un proceso disciplinado y constitution-first: contexto de producto duradero, requisitos trazables y releases gobernados, todo en archivos de metodología 100% locales. Cada cambio recorre un ciclo de vida explícito, de la constitución al archivo, de modo que la velocidad nunca cuesta calidad ni acumula deuda técnica.
La versión 2.1.0 lleva a AKILI al nivel empresarial. Un harness multi-agente reemplaza el bucle de agente único: un Líder planifica el trabajo, un Implementador escribe el código y un Revisor audita el resultado a ciegas —sin acceso al razonamiento del Implementador— detectando alucinaciones antes de que se fusionen. Cuando una revisión falla, el harness aborta rápido y revierte automáticamente (git restore), así que tu repositorio nunca queda sucio. Integraciones nativas con MCP extraen requisitos de negocio desde Jira y tokens de diseño desde Figma directamente a tus especificaciones, mientras que el prompt caching avanzado y las revisiones diff-only reducen drásticamente la factura de tokens de IA de tu equipo.
AKILI es portátil entre Claude Code, OpenCode y Google Antigravity, es consciente de CodeGraph, corre en macOS, Linux y Windows (Node.js 18+) y se distribuye bajo licencia MIT. Instálalo desde NPM y sé productivo en segundos: akili init ejecuta un asistente de configuración interactivo, la bandera --local instala los agentes de forma aislada por proyecto, y los clásicos comandos akili install, update, list y doctor mantienen tu configuración saludable.
Mejora continua · 改善
Kaizen: la metodología que aprende
Otras metodologías ejecutan especificaciones. AKILI aprende de cada una.
AKILI incorpora la filosofía japonesa del Kaizen (改善 — kai, cambio; zen, mejor) como un paso ejecutable, no como un eslogan. Cada vez que se archiva una especificación, AKILI corre automáticamente una retrospectiva acotada: mide el desperdicio (MUDA) en la evidencia de la propia especificación —reintentos del Revisor, pivotes, bugs y hallazgos críticos— y destila lecciones con causa raíz y evidencia real (Gemba), nunca especulación.
Esas lecciones se estandarizan en la constitución, las plantillas y las guías de los agentes —siempre con aprobación humana y en pasos pequeños— y quedan registradas en un log acumulativo que las próximas especificaciones leen antes de empezar. Así el equipo deja de repetir errores y la metodología mejora con cada entrega. Este es el significado de su nombre: akili es inteligencia en swahili, y una inteligencia que no aprende no es inteligencia.
- 1
Medir
Detecta el desperdicio (MUDA) en la evidencia del spec: reintentos, pivotes, bugs y advertencias de validación.
- 2
Aprender
Destila lecciones con causa raíz nombrada y evidencia real (Gemba). Las lecciones genéricas están prohibidas.
- 3
Estandarizar
Propone ediciones pequeñas a la constitución, las plantillas y las guías — siempre con aprobación humana.
- 4
Repetir
El próximo spec lee las lecciones activas antes de empezar, para que los errores no vuelvan.
Y vuelve a empezar en cada especificación
El mismo proceso estructurado que aplico al código, aplicado a la estrategia: discovery colaborativo, problemas enmarcados y decisiones trazables.
Taller de estrategia de innovación · Roma
El ciclo de vida de las especificaciones
Constitución
Establece la base del proyecto —PRD, diseño de sistema y diseño detallado— como fuente de verdad duradera.
Propuesta
Captura la intención de un cambio acotado como una propuesta ligera y revisable.
Especificación
Convierte la intención aprobada en requisitos completos, diseño técnico y tareas trazables.
Ejecución
Implementa cada tarea con un harness Líder → Implementador → Revisor — el Revisor audita a ciegas al Implementador y cualquier aborto fail-fast revierte limpiamente con git restore.
Validación
Revisión humana, pruebas automatizadas y evidencia de validación registrada contra cada requisito.
Cierre
Consolida la documentación, sincroniza el sistema de diseño y cierra la especificación.
Preguntas frecuentes
¿Cómo arranca un proyecto?
Con mi metodología AKILI: una sesión de discovery para entender el problema, luego una especificación acordada (requisitos + diseño) que apruebas antes de escribir código, y construcción por incrementos verificables. Nada se construye sin spec aprobado.
¿Qué es SDD (Spec-Driven Development)?
SDD, o desarrollo guiado por especificaciones, es una forma de construir software donde primero se acuerda una especificación —qué se va a construir, cómo y con qué criterios de aceptación— y luego humanos y agentes de IA implementan a partir de ese contrato, no de prompts sueltos. El resultado es trazable, revisable y con mucho menos retrabajo. AKILI es mi implementación open-source de SDD.
¿Qué es AKILI, tu metodología?
AKILI (AKILI-SPECS) es mi metodología open-source que lleva SDD a la práctica con un ciclo de vida explícito —de la constitución al cierre— y un harness multi-agente donde un Líder planifica, un Implementador codifica y un Revisor audita a ciegas. Se instala desde NPM como akili-specs y es portátil entre Claude Code, OpenCode y Google Antigravity.