Planning Sessions
La planificacion es donde la mayoria de los proyectos fracasan. No es falta de ideas ni de talento: es que los equipos saltan directamente a construir sin validar supuestos, sin cuestionar el alcance, sin identificar los riesgos que tienen delante.
Planning Sessions en Almirant no es una herramienta de generacion de tareas. Es tu sparring partner de IA que te desafia, te cuestiona y te obliga a pensar antes de escribir una sola linea de codigo.
Que son las Planning Sessions
Una Planning Session es una conversacion multi-turno con la IA. No es un prompt unico que produce una lista de items: es un dialogo iterativo donde la IA actua como sparring partner, desafiando cada decision que tomas:
- Cuestiona supuestos que das por sentados
- Identifica riesgos en tu planificacion
- Propone alternativas que no habias considerado
- Refina el alcance para que quede claro que entra y que queda fuera
El resultado no es solo una lista de work items: es un alcance validado y supuestos cuestionados.
La diferencia es fundamental. Un generador toma tu input y produce output. Un sparring partner cuestiona tu input. Te pregunta por que, que alternativas consideraste, donde estan los riesgos.
Iniciar una sesion
- Accede a la ruta
/plandesde el proyecto donde quieres planificar. - Selecciona el board destino donde se crearan los work items resultantes.
- Opcionalmente, selecciona seeds de ideacion para aportar contexto inicial.
- Escribe tu mensaje inicial describiendo lo que quieres lograr.
- Inicia la conversacion.
Titulo de la sesion
Al iniciar, puedes asignar un titulo descriptivo a la sesion. Este titulo te ayudara a identificar la sesion en el historial. Ejemplos:
- "Planificacion autenticacion OAuth"
- "Analisis migracion base de datos"
- "Diseno sistema de notificaciones"
Flujo conversacional
La sesion sigue un flujo natural de dialogo:
1. Presentas tu idea
Describes lo que quieres lograr. No necesitas tener todo claro: precisamente para eso esta el sparring.
2. La IA cuestiona
En lugar de generar items inmediatamente, la IA hace preguntas:
- Por que es necesario esto?
- Que alternativas consideraste?
- Donde estan los puntos ciegos?
- Que pasa si esto falla?
3. Defiendes o reconsidera
Respondes las preguntas. A veces defiendes tu posicion, a veces te das cuenta de que hay un mejor enfoque.
4. El alcance se refina
Con cada iteracion, el alcance se vuelve mas claro. La IA entiende mejor tu contexto y tu entiendes mejor los riesgos.
5. Generacion de work items
Cuando el alcance esta validado, la IA genera work items estructurados: epics, features, stories y tasks con definiciones de completado.
6. Revision y aceptacion
Revisas cada item sugerido. Aceptas los que aplican, rechazas los que no. Los items aceptados se crean automaticamente en el board seleccionado.
Fases de la sesion
Cada sesion pasa por diferentes fases que puedes ver en la interfaz:
| Fase | Descripcion |
|---|---|
idle | Esperando que inicies la conversacion |
booting | Preparando la sesion y el contexto |
chatting | Intercambiando mensajes con la IA |
streaming | Recibiendo respuesta en tiempo real |
thinking | La IA procesa y razona (modo thinking activo) |
waiting_for_answer | La IA espera tu respuesta a una pregunta |
reviewing | Revisando items sugeridos para aceptar o rechazar |
completed | Sesion finalizada con items creados |
paused | Sesion pausada para continuar mas tarde |
Seleccionar Seeds de ideacion
Antes de iniciar el dialogo, 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
- Feedback de usuarios procesado
Cuando seleccionas seeds, la IA los analiza como parte del contexto inicial, permitiendo una planificacion mas informada.
Como seleccionar seeds
- En la pantalla de inicio de sesion, veras la seccion Seeds disponibles.
- Marca los seeds relevantes para esta planificacion.
- Los seeds seleccionados se incluiran en el contexto inicial de la sesion.
El campo seedsProcessed en el resultado de la sesion indica cuantos seeds se analizaron.
Generar work items
Cuando la conversacion llega a un punto donde el alcance esta claro, la IA genera una propuesta de work items estructurados:
Tipos de items generados
| Tipo | Descripcion |
|---|---|
| Epic | Iniciativa grande que agrupa multiples features |
| Feature | Funcionalidad concreta que aporta valor |
| Story | Historia de usuario con criterios de aceptacion |
| Task | Tarea tecnica especifica y accionable |
Estructura de cada item
Cada item propuesto incluye:
- Titulo descriptivo y accionable
- Descripcion detallada con contexto
- Prioridad sugerida (urgent, high, medium, low)
- Jerarquia (parentTempId indica el item padre)
- Origen (fromSeedId si vino de un seed especifico)
Revisar y aceptar
En la fase de revision puedes:
- Aceptar items individuales
- Rechazar items que no apliquen
- Aceptar todos si la propuesta completa te convence
Los items aceptados se crean automaticamente en el board seleccionado, respetando la jerarquia propuesta.
Historial de sesiones
Todas las sesiones se guardan automaticamente y puedes acceder a ellas despues:
| Estado | Descripcion |
|---|---|
| active | Sesion en curso. Puedes continuar el dialogo. |
| completed | Sesion finalizada. Items creados en el board. |
| archived | Sesion guardada para referencia futura. |
Desde el historial puedes:
- Ver el dialogo completo de cualquier sesion
- Consultar los items que se crearon
- Reactivar una sesion archivada para continuar
Seguimiento de costes
Cada sesion registra metricas de uso para que puedas optimizar tu consumo de cuota:
| Metrica | Descripcion |
|---|---|
totalInputTokens | Tokens enviados a la IA |
totalOutputTokens | Tokens recibidos de la IA |
estimatedCost | Coste estimado de la sesion |
durationMs | Duracion total de la sesion |
Estas metricas te permiten entender cuanto consume cada sesion y optimizar tu uso de la cuota de IA.
Configuracion de la sesion
Cada sesion puede tener su propia configuracion:
| Campo | Descripcion |
|---|---|
model | Modelo de IA a usar (e.g., claude-3-opus) |
provider | Proveedor de IA (anthropic, openai, etc.) |
systemPrompt | Prompt de sistema personalizado |
temperature | Temperatura para la generacion (0.0 - 1.0) |
La configuracion por defecto viene de los ajustes de la organizacion, pero puedes personalizarla para sesiones especificas.
Modos de respuesta
La IA puede operar en diferentes modos segun la complejidad de lo que estas discutiendo:
Streaming
Ves la respuesta mientras se genera. Ideal para iteracion rapida y dialogo fluido.
Thinking
La IA razona paso a paso antes de responder. Mejor para problemas complejos donde necesitas un analisis profundo.
Puedes alternar entre modos durante la sesion.
Escribir prompts efectivos
Tu primer mensaje importa. Aqui hay ejemplos de buenos puntos de partida:
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 |
Requisitos previos
Para usar Planning Sessions necesitas:
- Un proveedor de IA configurado con API key valida
- Cuota disponible en tu organizacion
- Un proyecto con al menos un board activo donde se crearan los items
Estructura de datos
La sesion se almacena con los siguientes campos principales:
| Campo | Tipo | Descripcion |
|---|---|---|
id | uuid | Identificador unico |
organizationId | text | Organizacion propietaria |
projectId | uuid | Proyecto asociado |
boardId | uuid | Board donde se crean items |
title | text | Titulo de la sesion |
status | enum | active, completed, archived |
config | json | model, provider, systemPrompt, temperature |
result | json | summary, workItemsCreated, seedsProcessed |
Mensajes de la sesion
Cada mensaje de la conversacion tiene:
| Campo | Tipo | Descripcion |
|---|---|---|
role | enum | user, assistant, system |
content | text | Contenido del mensaje |
messageType | varchar | Tipo de mensaje |
inputTokens | integer | Tokens de entrada |
outputTokens | integer | Tokens de salida |
Herramientas MCP
| Tool | Descripcion | Parametros principales |
|---|---|---|
record_ai_session | Registra una sesion de planificacion | projectId, prompt, response, tokensUsed |
get_ai_sessions | Obtiene el historial de sesiones de un proyecto | projectId, limit |
Ejemplo: Registrar una sesion
Tool: record_ai_session
Parametros:
projectId: "uuid-del-proyecto"
prompt: "Necesito un sistema de notificaciones push"
response: "Propuesta generada por la IA..."
tokensUsed: 1250
Ruta de acceso
La ruta principal para Planning Sessions es /plan. Desde ahi puedes iniciar nuevas sesiones, ver el historial y continuar sesiones pausadas.