APEX.
TypeScript, SQLite, FTS5, Claude Code MCP, arquitectura de plugins
El sistema de 14 fases que me permite entregar en 4 semanas lo que a otros les lleva 8.
Contexto
Después de construir varios proyectos de IA (DNI Chatbot, FeedbackIA, Osyris-Web), identifiqué un patrón: los proyectos no fallaban por falta de habilidad técnica, sino por falta de estructura. Se empezaba a programar sin analizar bien el problema, se saltaba el testing y se entregaba tarde o con deuda técnica insostenible.
En lugar de seguir repitiendo los mismos errores, decidí construir mi propio sistema de desarrollo que forzara las buenas prácticas desde el minuto cero.
El problema
El desarrollo asistido por IA tiene un problema fundamental: el agente no tiene memoria entre sesiones, no sabe en qué fase del proyecto está, y tiende a saltar directamente al código sin analizar el problema. El resultado es código que funciona en demo pero no en producción.
Las herramientas existentes (Cursor, Copilot, Claude Code vanilla) son excelentes como asistentes puntuales, pero no guían un proyecto completo de principio a fin. No hay persistencia de decisiones, no hay tracking de errores, y no hay fase socrática que cuestione la idea antes de construirla.
Restricciones
- Debía funcionar como extensión de Claude Code, no como herramienta separada
- Persistencia real entre sesiones (no solo prompt, sino base de datos)
- 14 fases secuenciales obligatorias: desde el socrático hasta el mantenimiento
- Debía registrar decisiones con temporal facts (invalidables cuando cambia el contexto)
- Suficientemente flexible para cualquier tipo de proyecto (web, bot, CLI, SaaS)
El enfoque
APEX se implementa como un sistema MCP (Model Context Protocol) con una base de datos SQLite que actúa como cerebro persistente del proyecto. Cada decisión, error, componente y fase se registra en context.db con búsqueda full-text FTS5.
Las 14 fases van desde lo socrático (cuestionar la idea antes de construir) hasta el mantenimiento (documentación auto-generada, backups, plan de deprecación). Cada fase tiene sub-pasos secuenciales y obligatorios con criterios de verificación.
Un knowledge base tipo wiki almacena el contexto del proyecto: propuesta de valor, design system, edge cases, modelo de datos. Esto permite que cualquier sesión nueva de Claude Code tenga acceso completo al historial de decisiones y al estado real del proyecto.
Resultados
50%
Reducción tiempo
14
Fases guiadas
6+
Proyectos construidos
100+
Decisiones trackeadas
Aprendizajes
Forzar análisis antes de código evita el 80% de reescrituras. La fase socrática (cuestionar la idea, investigar mercado, pensar edge cases) es la más valiosa de todo el sistema.
Un agente con contexto persistente es exponencialmente más productivo que uno sin memoria. La diferencia entre 'empieza de cero cada vez' y 'recuerda por qué tomaste esa decisión hace 3 sesiones' es la diferencia entre un junior y un senior.
APEX es la metodología de auditoría y hoja de ruta que aplico cuando entro en un proyecto nuevo: 14 fases secuenciales, cuestionamiento socrático y análisis de constraints antes de escribir una línea de código. Pack Compass es la versión consultiva de esa misma metodología.