Los agentes de IA son extraordinariamente capaces, pero tienen una limitacion estructural: cada sesion empieza desde cero.
Cada fase produce un documento que alimenta a la siguiente. No se avanza hasta que el artefacto esta commiteado en git.
Sesion de entrevista guiada entre la IA y el responsable funcional. Rondas iterativas de preguntas. Lenguaje de negocio, sin tecnologias.
4 bloques de decisiones: stack, capas, componentes, restricciones. Cada decision con alternativas. Sensible a aapp/ens. Diagrama mermaid.
El diferenciador de ASDM. Query inventory antes de disenar tablas. Cada indice justificado por una query. Flyway oracle 19c.
Roadmap con epicas e historias (fibonacci). Sprints con tareas de granularidad modulo completo. Dod verificable + prompt ejecutable.
El desarrollador copia el prompt y lo pasa al agente con los skills activos. El agente tiene todo el contexto. El desarrollador revisa contra el dod.
Cada skill es un documento de instrucciones que Claude lee antes de ejecutar una tarea. Garantiza comportamiento consistente y reproducible.
Conduce la definicion de requisitos mediante rondas iterativas de preguntas con opciones. Solo lenguaje de negocio.
Entrevista arquitectonica en 4 bloques. Sensible a aapp/ens. Genera diagrama mermaid. Versiones concretas del stack.
Query inventory antes de tablas. Esquema satisface operaciones reales. Flyway oracle 19c. Auditoria doble nivel.
Roadmap + sprints con tareas de granularidad modulo completo. Cada tarea incluye dod y prompt ejecutable en dos partes.
ASDM no es un proceso burocratico. Es la infraestructura minima para que los agentes de IA produzcan trabajo consistente.
Todos los agentes de todos los sprints consultan el mismo arch. Sprint 1 y Sprint 5 tienen la misma estructura.
Hazelcast o Redis? Se decide una vez con alternativas. Ningun agente futuro lo reinventa.
Indices justificados por queries reales antes de escribir codigo. Sin indices reactivos en produccion.
Un nuevo miembro lee 4 documentos y entiende el sistema completo: que hace, como esta construido y que queda.
El desarrollador verifica contra el dod. No juzga. Si cumple el contrato, esta bien.
Cada prompt referencia secciones del arch. Si la arquitectura cambia, todos los prompts futuros son coherentes.
Toda metodologia tiene limites. Estos son los gaps de ASDM v1.0 que determinan su roadmap.
Sin proceso formal para actualizar req-v2.md y propagarlo al arch cuando los requisitos cambian.
Skills de analisis e implementacion son piezas separadas sin activacion automatica formal.
La experiencia de implementacion no fluye de vuelta a los documentos de analisis.
No hay verificacion automatica de que el codigo generado respeta la estructura de modulos del arch.
ASDM esta validado para monolitos modulares. La extension a microservicios no esta cubierta.
La metodologia esta disenada para un agente secuencial. Agentes en paralelo no soportados.
Cada version cierra uno o mas gaps y anade capacidades que multiplican la autonomia de los agentes.
4 skills de analisis validados en un proyecto de 96 sp, 5 sprints y 21 tareas con prompts ejecutables.
Activacion automatica de skills de implementacion mediante seleccion declarativa en sprint-nn.md.
Skill change-manager que analiza el impacto de cambios de requisito sobre arch y ddl existentes.
Skill retrospective-analyst que detecta decisiones del arch inadecuadas y propone actualizaciones.
Extension a arquitecturas distribuidas, openapi, archunit, y orquestacion de agentes paralelos.
Herramienta web que implementa ASDM de forma visual: entrevista guiada, grafo de dependencias, prompt store.