Proyectos y tablero kanban

Proyectos con etapas y tareas en un tablero de seis columnas, avance calculado y borrado reversible.

Categoría: Proyectos y empresas
Estado: Disponible
Requisitos: Una cuenta de ArduMaker; Para asociar empresas al crear: ser admin de esas empresas
Herramientas MCP (Solo leen): listar_proyectos, ver_proyecto, buscar_en_proyecto, listar_proyectos_eliminados
Herramientas MCP (Escriben o modifican): crear_proyecto, crear_proyecto_con_etapas, editar_proyecto

¿Qué permite hacer?

Un proyecto agrupa etapas y tareas, con miembros, roles, adjuntos, calendario y recursos vinculados. Etapas y tareas se ven en un tablero tipo kanban.

Columna	Cómo se llega
`backlog`	Automática con avance 0
`listo`	Solo moviendo la tarjeta a mano
`en_curso`	Automática con avance entre 1 y 99
`en_revision`	Solo a mano
`testing`	Solo a mano
`hecho`	Automática con avance 100

¿Cuándo conviene usarlo?

Para ordenar el trabajo de un cliente o de un producto en etapas y tareas.
Para darle a un agente de IA un lugar donde leer y actualizar el estado del trabajo.
Para archivar un proyecto terminado sin borrarlo.

¿Cómo funciona en ArduMaker?

Al crear el proyecto, ArduMaker siembra 14 roles con permisos completos, agrega a quien lo crea con el rol Manager y crea "Etapa 1" con "Tarea 1" para que no arranque vacío.
Si se asocian empresas, hay que ser admin de cada una. Por defecto se aplica la plantilla marcada como predeterminada de cada empresa.
El avance sube de abajo hacia arriba: el de una tarea es manual o sale de su checklist; el de una etapa es el promedio de sus tareas; el del proyecto, el promedio de sus etapas.
Mientras nadie mueva una tarjeta, su columna se deduce del avance. Moverla a mano la fija; volver a auto la devuelve al cálculo.

El estado del proyecto es active o archived. Archivar lo saca del listado por defecto sin borrar nada.

¿Qué cambia realmente?

Crear un proyecto crea sus roles, la membresía del creador, una etapa y una tarea.
Todo borrado es lógico: el proyecto, una etapa o una tarea van a la papelera 30 días y se pueden restaurar enteros.
Cada creación, edición o borrado queda en el historial del proyecto.

Esquema

Checklist: ítems hechos / total
Tarea: avance 0-100
Etapa: promedio de sus tareas
Proyecto: promedio de sus etapas

Cómo sube el avance — La columna del tablero se deduce de ese avance salvo que alguien mueva la tarjeta.

Resultado esperado

El proyecto queda visible para sus miembros y para los miembros y admins de las empresas asociadas, cada uno con lo que su rol le permite.

Errores y resolución

Mensaje	Causa
`nombre is required`	El nombre llegó vacío.
`Template not found`	La plantilla pedida no existe o está desactivada.
`That template belongs to a company that is not part of this project`	Se eligió una plantilla de una empresa no asociada.

Si falla la plantilla, el proyecto ya quedó creado: la plantilla se aplica después y fuera de la creación.

Relación con MCP

Un agente MCP lista, crea y edita proyectos dentro del alcance que le dio su dueño. Nunca puede borrar un proyecto entero.

Lectura: listar_proyectos, ver_proyecto, buscar_en_proyecto, listar_proyectos_eliminados.
Escritura: crear_proyecto (acepta plantilla_id), crear_proyecto_con_etapas y editar_proyecto (incluye archivar).
crear_proyecto_con_etapas crea el proyecto y sus etapas en una llamada; si fallan las etapas, el proyecto queda creado y la respuesta lo informa en residuo.

Más en /mcp/proyectos y /mcp/docs.