Proyectos
Cada sesion de un agente AI empieza desde cero a menos que alguien recuerde el contexto. Los proyectos son ese alguien. Contienen tu stack, tus repositorios, tus documentos y tus decisiones para que los agentes no empiecen cada sesion preguntando "que framework usamos?". Sin proyectos, repites el mismo contexto una y otra vez. Con proyectos, los agentes arrancan con todo lo que necesitan.
Un proyecto es el contenedor principal en Almirant. Agrupa boards, work items, sprints, documentos, repositorios y configuracion bajo una misma entidad. Todo el trabajo de tu equipo se organiza dentro de un proyecto.
Crear un proyecto
Almirant incluye un asistente guiado para crear proyectos. Accede desde el menu lateral o desde la ruta /projects/new.
Pasos del asistente
- Nombre y descripcion -- Define un nombre unico y una descripcion opcional del proyecto.
- Aspecto visual -- Elige un color e icono representativos para identificar el proyecto rapidamente en la navegacion.
- Stack tecnologico -- Indica las tecnologias del proyecto (lenguajes, frameworks, bases de datos). Esta informacion es utilizada por la IA para contextualizar las tareas.
- URLs de entorno -- Registra las URLs de produccion y staging para tener acceso rapido y que la IA pueda referenciarlas.
- Organizacion y cliente -- Asocia el proyecto a una organizacion y opcionalmente a un cliente.
- Confirmacion -- Revisa los datos y crea el proyecto.
Campos de configuracion
| Campo | Descripcion | Obligatorio |
|---|---|---|
name | Nombre del proyecto | Si |
description | Descripcion general del proyecto | No |
color | Color para identificacion visual en el sidebar | No |
icon | Icono representativo del proyecto | No |
techStack | Array de tecnologias utilizadas (e.g., ["Next.js", "PostgreSQL"]) | No |
productionUrl | URL del entorno de produccion | No |
stagingUrl | URL del entorno de staging | No |
client | Nombre del cliente asociado | No |
organizationId | Organizacion propietaria del proyecto | Si |
Dashboard del proyecto
Al acceder a un proyecto (/projects/[id]), se muestra un dashboard con:
- Resumen de work items -- Contadores por tipo y estado actual.
- Boards activos -- Lista de boards del proyecto con acceso directo.
- Sprint activo -- Informacion del sprint en curso, si existe.
- Repositorios -- Repositorios de GitHub conectados al proyecto.
- Actividad reciente -- Historial de cambios y eventos del proyecto.
Doc links
Cada proyecto puede tener enlaces a documentacion externa. Los doc links permiten asociar URLs relevantes (Confluence, Notion, Google Docs, wikis internas) al proyecto para que tanto el equipo como la IA tengan acceso rapido al contexto.
Para agregar un doc link:
- Accede al proyecto.
- Ve a la seccion Doc Links.
- Introduce la URL y un titulo descriptivo.
- Guarda el enlace.
Notas del proyecto
Los proyectos incluyen un sistema de notas para registrar decisiones, contexto tecnico o cualquier informacion relevante que no encaje en un work item. Las notas quedan asociadas al proyecto y son visibles para todo el equipo.
Repositorios
Conecta repositorios de GitHub al proyecto para que la IA pueda referenciar codigo, crear pull requests y vincular commits con work items. Consulta la seccion de integraciones para mas detalles sobre la configuracion de GitHub.
Screenshots del proyecto
Puedes adjuntar capturas de pantalla al proyecto para documentar visualmente el estado actual de la aplicacion, mockups o cualquier referencia grafica.
Transferir un proyecto
Un proyecto puede transferirse entre organizaciones. La transferencia es atomica e incluye:
- El proyecto con toda su configuracion.
- Todos los work items asociados (incluyendo ideas y milestones).
- Los boards y el remapeo de columnas.
Para transferir un proyecto:
- Accede a la configuracion del proyecto.
- Selecciona Transferir proyecto.
- Elige la organizacion destino.
- Confirma la transferencia.
La transferencia mueve el proyecto completo. Asegurate de que la organizacion destino tiene permisos y configuracion adecuada antes de proceder.
Eliminar un proyecto
La eliminacion de un proyecto es permanente y elimina todos los datos asociados (boards, work items, sprints, documentos, notas, repositorios). Esta accion no se puede deshacer.
- Accede a la configuracion del proyecto.
- Selecciona Eliminar proyecto.
- Confirma escribiendo el nombre del proyecto.
Eliminar un proyecto borra todos los boards, work items, sprints y datos asociados de forma irreversible.
Para developers
Rutas de la aplicacion
| Ruta | Descripcion |
|---|---|
/projects | Listado de todos los proyectos |
/projects/new | Asistente de creacion de proyecto |
/projects/[id] | Dashboard del proyecto |
Herramientas MCP
Los siguientes tools estan disponibles via MCP para gestionar proyectos programaticamente:
| Tool | Descripcion | Parametros principales |
|---|---|---|
list_projects | Lista todos los proyectos de la organizacion | organizationId (opcional si hay projectId en sesion) |
create_project | Crea un nuevo proyecto | name, description, techStack, productionUrl, stagingUrl |
update_project | Actualiza campos de un proyecto existente | projectId, campos a actualizar |
get_project | Obtiene los detalles completos de un proyecto | projectId |
get_project_roadmap | Obtiene el roadmap del proyecto con epics y features | projectId |
Ejemplo: Crear un proyecto via MCP
Tool: create_project
Parametros:
name: "Mi Aplicacion Web"
description: "Plataforma SaaS para gestion de inventario"
techStack: ["Next.js", "PostgreSQL", "Tailwind CSS"]
productionUrl: "https://app.ejemplo.com"
stagingUrl: "https://staging.ejemplo.com"
Ejemplo: Consultar el roadmap
Tool: get_project_roadmap
Parametros:
projectId: "uuid-del-proyecto"
Devuelve la estructura jerarquica del proyecto con epics, features y su progreso actual.