Saltar al contenido principal

El ciclo completo de trabajo

Almirant organiza el trabajo en cinco fases. Cada una tiene su herramienta y su momento. El objetivo: que puedas pasar de una idea en movimiento a una feature implementada y documentada sin fricciones.

Seeds → Ideate → Implement → Validate → Document

Vista general

Cada fase puede ejecutarse de forma local (con tu terminal presente) o en cloud (sin estar delante). OnCloud desacopla tu presencia de la ejecución.


Las cinco fases

1. Seeds — Capturar la intención

Qué es: La unidad mínima de intención. Una idea, una mejora, un problema. No tiene que estar bien definida — tiene que existir.

Cuándo se usa: Cuando detectas algo que mejorar, en reuniones, en movimiento. Capturas ahora, planificas después.

Cómo se crea:

  • Desde el móvil, con tu asistente conectado al MCP
  • Desde Claude Code: /seed "descripción"
  • Desde la app web, en la sección Seeds del proyecto

Resultado: Un registro de la intención vinculado al proyecto, preservando el contexto del momento en que surgió.

Seeds — la unidad mínima de intención


2. Ideate — Planificar con IA

Qué es: La sesión de planificación donde la IA convierte seeds en tareas bien definidas.

Cuándo se usa: Cuando tienes seeds acumuladas y tiempo para una sesión de planning.

Cómo se lanza:

> /ideate

Lo que hace la IA:

  1. Revisa el board (qué hay en progreso, qué está bloqueado)
  2. Lee las seeds pendientes
  3. Agrupa las que son variaciones del mismo problema
  4. Si la seed es ambigua → preguntas de aclaración o brainstorming
  5. Si la seed es concreta → research técnico (archivos, patrones, approach)
  6. Propone tareas con definition of done, archivos relevantes y consideraciones técnicas
  7. Con tu aprobación → crea las tareas en el board

Resultado: Tareas en el board, listas para implementar, trazadas hasta la seed que las originó.

La sesión de planificación (Ideate)


3. Implement — Ejecutar el trabajo

Qué es: El agente implementa la tarea a partir de su especificación.

Cuándo se usa: Cuando una tarea está en el backlog y lista para implementar.

Dos formas de hacerlo:

Local (estás presente):

> /implement A-T-42

El agente trabaja en tu terminal. El work item pasa a "In Progress" y luego a "Review".

OnCloud (sin estar delante):

> /runner-implement A-T-42

El agente trabaja en un entorno remoto. Lanzas y te desconectas. Cuando termina, la PR está lista.

Resultado: Código implementado, PR generada, work item en Review.

Ejecución en cloud (OnCloud)


4. Validate — Verificar que está bien hecho

Qué es: El agente verifica que la implementación cumple los criterios de aceptación definidos en planning.

Cuándo se usa: Cuando una tarea está en Review y quieres verificar antes de hacer merge.

Cómo se lanza:

> /validate A-T-42        # local
> /runner-validate A-T-42 # en cloud

La IA compara el resultado con la definition of done original, no con su propia interpretación. Si algo no cuadra, lo indica con detalle.

Automatización nocturna: Puedes configurar un proceso automático que valide todas las tareas en Review durante la noche y las marque como Done si pasan. Javi lo usa para llegar por la mañana con el board actualizado.

Resultado: Tarea verificada, lista para merge, o con feedback concreto sobre qué falta.


5. Document — Documentar los cambios

Qué es: El agente genera documentación de lo que se implementó.

Cuándo se usa: Tras validar, para mantener la documentación del proyecto actualizada.

Cómo se lanza:

> /document A-T-42        # local
> /runner-document A-T-42 # en cloud

Resultado: Documentación de los cambios, decisiones tomadas y archivos afectados.


El contexto en cada fase

Lo que hace que este ciclo funcione es que el contexto no se pierde entre fases:

FaseQué contexto tiene disponible
SeedsSe crean con el contexto del momento que surgió la idea
IdeateVe las seeds, el board completo y el codebase
ImplementLee la tarea con toda su especificación (from Ideate)
ValidateCompara contra los criterios definidos en Ideate
DocumentConoce la tarea original y lo que se implementó

Cada agente arranca con el mapa completo. No empieza de cero.


Local vs. OnCloud

Todas las fases de ejecución (Implement, Validate, Document) tienen una versión local y una versión en cloud:

LocalOnCloud
CuándoEstás delante del ordenadorQuieres desconectarte
Skill/implement, /validate, /document/runner-implement, /runner-validate, /runner-document
ResultadoEn tu terminal en tiempo realLa PR/resultado te espera cuando vuelves
ProveedoresEl configurado en tu IDEClaude, Codex, Gemini (configurable)

Ejecución en cloud (OnCloud)


Qué sigue