Docs Cómo funciona
Cómo funciona
El modelo de ejecución
ASDT te da estructura sin quitarte el control. Cuando ejecutás un especialista, orquesta una secuencia de pasos enfocados — cada uno produce un único artefacto y solo lee lo que produjo el paso anterior.
Vos invocás a los especialistas. ASDT nunca los ejecuta automáticamente. Eso es intencional: cada paso donde un humano confirma un plan es un paso donde los supuestos incorrectos se detectan antes de que se acumulen.
El asesor /asdt analiza tu petición y sugiere qué especialistas involucrar y en qué orden. Vos confirmás el plan y ejecutás cada comando.
El conocimiento fluye hacia adelante automáticamente
Cada paso de cada especialista produce un artefacto — un documento estructurado guardado en la base de conocimiento con una clave estable. El siguiente especialista lo recupera por clave. Sin pasar contexto manualmente. Sin copiar y pegar entre comandos.
Esto significa:
- Los especialistas están desacoplados. El Developer lee el registro de decisión del Arquitecto como un documento — no como una variable compartida ni un import de archivo.
- Los artefactos sobreviven a las sesiones. Ejecutás PM el lunes, continuás con el Arquitecto el jueves. La base de conocimiento retiene el contexto.
- Los inputs faltantes se degradan sin errores. Si falta un artefacto, el siguiente especialista lo anota en una lista de pendientes llamada
open_itemsy continúa con lo que tiene disponible.
Los especialistas se adaptan a la complejidad
Cada especialista ejecuta la profundidad de pasos adecuada para la complejidad de la petición. Un bugfix rápido corre menos pasos que un nuevo sistema de autenticación. La descripción a continuación muestra la secuencia completa a complejidad moderada:
- Researcher
Encuadra el problema, diverge en direcciones candidatas, juzga factibilidad con evidencia y converge en una recomendación
- PM
Convierte la petición en historias en orden de entrega, alcance explícito, NFRs medibles y criterios de aceptación
- UX/UI
Convierte el requisito en flujos mapeados a componentes existentes, con la accesibilidad que cada uno debe cumplir
- Architect
Decide el enfoque frente a sus alternativas y diseña el modelo de datos y la superficie de API que se derivan
- Developer
Escribe el código — y sus tests bajo TDD estricto — dentro de los límites de edición que declaró el spec
- Security
Convierte la evaluación en hallazgos priorizados con mitigaciones concretas y una checklist accionable
- QA
Encuentra los huecos y casos límite que los criterios de aceptación no cubren, los vuelve casos de test y da un veredicto go/no-go
Los pasos se ejecutan como sub-agentes aislados (ejecuciones de IA independientes y de una sola tarea que no ven el razonamiento de las demás) — no comparten contexto entre sí, lo que evita que el razonamiento temprano contamine los pasos posteriores. Cada paso lee solo sus inputs declarados, escribe un artefacto y pasa el control.
El humano siempre está en el circuito
ASDT aplica una compuerta suave en dos momentos:
- Después de
/asdt— el asesor de pipeline presenta un plan de routing y espera confirmación antes de darte los comandos a ejecutar. - Entre especialistas — vos decidís cuándo correr el siguiente. Nada se automatiza.
Esto no es una limitación. Es el diseño. Las decisiones de arquitectura generadas por IA se benefician de la revisión humana antes de que un developer actúe sobre ellas. Los planes de QA se benefician de la revisión humana antes de que definan qué significa “listo”. ASDT te da la estructura; vos aplicás el criterio.