Planificación con IA (Ideate)
La planificacion es donde la mayoria de los proyectos fracasan, no en la ejecucion. Y el problema no es falta de ideas, sino falta de cuestionamiento. Los equipos saltan a construir sin validar supuestos, sin desafiar el alcance, sin identificar riesgos evidentes.
AI Planning en Almirant no es una herramienta que genera work items. Es un sparring partner que te desafia antes de que escribas una sola linea de codigo.
Por que un sparring partner y no un generador
La diferencia es fundamental:
- Un generador toma tu input y produce output. Le dices "quiero autenticacion" y te da 15 tasks.
- Un sparring partner cuestiona tu input. Te pregunta por que necesitas autenticacion, que alternativas consideraste, donde estan los riesgos.
El resultado no es solo una lista de items: es un alcance validado y supuestos cuestionados.
Desde una idea vaga a un alcance validado en una sola sesion. Epics, stories y tasks auto-generados con definiciones de completado.
Planning Sessions
Las sesiones de planificacion son conversaciones multi-turno con la IA. No es un prompt unico: es un dialogo iterativo donde la IA:
- Desafia supuestos -- Cuestiona decisiones que das por sentadas.
- Identifica riesgos -- Senala puntos ciegos en tu planificacion.
- Propone alternativas -- Sugiere enfoques que no habias considerado.
- Refina el alcance -- Ayuda a delimitar que entra y que queda fuera.
Estados de una sesion
Cada sesion pasa por diferentes fases:
| Fase | Descripcion |
|---|---|
idle | Esperando que inicies la conversacion |
chatting | Intercambiando mensajes con la IA |
streaming | Recibiendo respuesta en tiempo real |
thinking | La IA procesa y razona (modo thinking activo) |
reviewing | Revisando items sugeridos para aceptar o rechazar |
completed | Sesion finalizada |
paused | Sesion pausada para continuar mas tarde |
Historial de sesiones
Tus sesiones se guardan automaticamente y puedes acceder a ellas despues:
- Activa -- Sesion en curso, puedes continuar el dialogo.
- Completada -- Sesion cerrada con items creados.
- Archivada -- Sesion guardada para referencia futura.
Cada sesion registra tokens usados (totalInputTokens, totalOutputTokens), costo estimado y duracion, para que puedas optimizar tu uso de la cuota.
Seeds de ideacion
Antes de iniciar el dialogo de planificacion, puedes seleccionar seeds: ideas previas capturadas en Almirant que sirven como punto de partida. Los seeds aportan contexto inicial a la sesion:
- Notas de brainstorming guardadas.
- Ideas de sesiones anteriores.
- Requisitos capturados de conversaciones con stakeholders.
Flujo de trabajo
- Selecciona seeds (opcional) -- Elige ideas previas para aportar contexto inicial.
- Inicia la sesion -- Describe lo que quieres lograr, pero espera cuestionamiento.
- Dialoga con la IA -- Responde preguntas, defiende decisiones, reconsidera supuestos.
- Revisa la propuesta -- Cuando el alcance esta claro, la IA genera work items estructurados.
- Acepta o rechaza items -- Selecciona los que aplican, descarta los que no.
- Items creados en el board -- Los items aceptados se crean automaticamente en el board activo.
La IA empieza revisando qué hay en progreso y en review. Evita proponer trabajo que ya está hecho o que entra en conflicto con lo que alguien está implementando ahora mismo.
La conversacion es bidireccional, pero tu primer mensaje importa:
Buenos puntos de partida
| Prompt | Por que funciona |
|---|---|
| "Quiero agregar autenticacion social, pero no se si vale la pena el esfuerzo vs magic links" | Invita a la IA a comparar alternativas |
| "Necesito mejorar el rendimiento del listado de productos, los usuarios se quejan de lentitud" | Define el problema real, no la solucion asumida |
| "Tenemos que migrar de REST a GraphQL, el equipo dice que es mejor pero no estoy convencido" | Abre espacio para cuestionar la decision |
Evitar
| Prompt | Problema |
|---|---|
| "Genera tasks para autenticacion" | Cierra el espacio de dialogo, pide output directo |
| "Haz un CRUD de usuarios" | No hay problema a resolver, solo mecanica |
| "Mejora todo el sistema" | Sin foco, imposible cuestionar |
Modos de respuesta
La IA puede operar en diferentes modos:
- Streaming -- Ves la respuesta mientras se genera, ideal para iteracion rapida.
- Thinking -- La IA razona paso a paso antes de responder, mejor para problemas complejos.
Puedes alternar entre modos segun la complejidad de lo que estas discutiendo.
"Me estás hablando de 5 cosas pero son realmente 3 problemas. Para la optimización del dashboard, hay tres causas posibles: queries sin índice, rendering excesivo o payload grande. ¿Tienes alguna pista? Si no, puedo proponer investigar las tres."
Cuando la IA genera su propuesta de work items, veras una lista organizada por tipo:
Con la intención clara, la IA analiza el codebase:
- Qué archivos son relevantes para esta seed
- Cómo está resuelto algo similar en el proyecto (patrones, convenciones existentes)
- Qué approach técnico tiene más sentido dado el contexto actual
- Qué dependencias o riesgos hay que tener en cuenta
Cada item incluye titulo, descripcion y jerarquia propuesta. Puedes:
- Aceptar items individuales.
- Rechazar items que no apliquen.
- Aceptar todos si la propuesta completa te convence.
Requisitos previos
- Un proveedor de IA configurado con API key válida
- Cuota disponible en tu organización
- Un proyecto con al menos un board activo
Para developers — Herramientas MCP
Los siguientes tools están disponibles via MCP:
| Tool | Descripción | Parámetros principales |
|---|---|---|
record_ai_session | Registra una sesión de planificación | projectId, prompt, response, tokensUsed |
get_ai_sessions | Historial de sesiones de planificación | projectId, limit |
Ejemplo: Registrar una sesión de Ideate
Tool: record_ai_session
Parámetros:
projectId: "uuid-del-proyecto"
prompt: "Seeds: optimizar dashboard, añadir exportación de reportes"
response: "Propuesta: Feature con 3 Tasks — índice BD, lazy loading, botón exportar"
tokensUsed: 2840