feat(project-manager): adiciona plugin project-manager (agents, skills, knowledge e metadados do projeto)

2026-10-28 16:09:43 +00:00
parent 77c33e4d96
commit a32752df8a
35 changed files with 1589 additions and 0 deletions
@@ -0,0 +1,188 @@
+---
+name: sprint
+description: Sprints flexíveis que lêem tasks do Desk CRM, agrupam em sprints com checkpoints e reviews.
+disable-model-invocation: true
+layer: wiki
+---
+
+# /sprint v1.0 - Sprints Flexiveis
+
+Sprints com duracao flexivel, Desk CRM como fonte de verdade, checkpoints obrigatorios.
+
+## Contexto NotebookLM
+
+ANTES de executar, consultar notebooks para contexto especializado:
+
+| Notebook | ID | Consultar quando |
+|----------|-----|-----------------|
+| Gestão de Projectos e Agile | 0c9c079c-a426-486c-99eb-1564d42d37ad | Sempre |
+
+```
+mcp__notebooklm__notebook_query({
+  notebook_id: "0c9c079c-a426-486c-99eb-1564d42d37ad",
+  query: "<adaptar ao contexto do pedido do utilizador>"
+})
+```
+
+Integrar insights do NotebookLM nas recomendações e decisões.
+
+---
+
+## Comandos
+
+| Comando | Funcao |
+|---------|--------|
+| `/sprint` | Mostrar sprint activo |
+| `/sprint plan` | Criar sprint a partir de tasks Desk |
+| `/sprint check-in` | Checkpoint a meio do sprint |
+| `/sprint review` | Review final do sprint |
+| `/sprint close` | Fechar sprint e calcular metricas |
+| `/sprint add <task_id>` | Adicionar task ao sprint activo |
+| `/sprint remove <task_id>` | Remover task do sprint |
+
+---
+
+## SPRINT.md Template
+
+```markdown
+---
+sprint_id: YYYY-WNN-[projecto]
+project_id: null
+start_date: YYYY-MM-DD
+end_date: YYYY-MM-DD
+status: active
+checkpoint_done: false
+spec_refs: []
+tasks_planned: 0
+tasks_added_after: 0
+---
+
+# Sprint: [Goal em 1 frase]
+
+## Tasks
+
+| Desk ID | Task | Prioridade | Estimativa | Status | Tempo Real |
+|---------|------|-----------|-----------|--------|-----------|
+
+## Checkpoint (Meio do Sprint)
+_Data: [a preencher]_
+- On track: [sim/nao]
+- Bloqueios: [lista]
+- Scope changes: [lista]
+- Accao: [continuar/ajustar]
+
+## Review (Final do Sprint)
+_Data: [a preencher]_
+- Tasks completadas: X/Y
+- Tasks adicionadas pos-planeamento: N
+- Tempo estimado: Xh
+- Tempo real: Yh
+- Scope changes: N
+- Licoes aprendidas: [lista]
+- Proximos passos: [lista]
+```
+
+---
+
+## Protocolos
+
+### `/sprint` (sem argumentos)
+
+```
+1. Procurar SPRINT.md no directorio actual (ou pais, max 3 niveis)
+2. SE encontrado e status == active:
+   a. Ler SPRINT.md
+   b. Buscar estado actual das tasks no Desk CRM:
+      Para cada task_id na tabela:
+        mcp__desk-crm-v3__get_task({ id: task_id })
+   c. Mostrar:
+      ---
+      ## Sprint Activo: [goal]
+      **Projecto:** [nome] (#id)
+      **Periodo:** [start] -> [end] (dia X de Y)
+      **Checkpoint:** [feito/pendente]
+
+      | Task | Status Desk | Sprint |
+      |------|------------|--------|
+
+      **Progresso:** X/Y tasks (Z%)
+      ---
+3. SE nao encontrado:
+   "Sem sprint activo. Usar /sprint plan para criar."
+```
+
+### `/sprint plan`
+
+```
+1. mcp__mcp-time__current_time -> data actual
+2. Detectar contexto:
+   a. Ler .desk-project se existe -> project_id
+   b. Se nao: perguntar projecto
+3. Buscar tasks abertas do Desk CRM:
+   mcp__desk-crm-v3__get_tasks({ project_id: X, status: [1, 4] })
+   (status 1=Not Started, 4=In Progress)
+4. Verificar SPEC.md:
+   - Se existe e aprovado: incluir referencia no sprint
+   - Se nao existe: WARN "Sem spec aprovado. Considere /spec create."
+   - Nao bloquear por isto (gradual adoption)
+5. Apresentar tasks ao Emanuel por prioridade:
+
+   ## Tasks Disponiveis para Sprint
+
+   ### Urgente / Alta
+   - #1450: Implement API (4h estimado)
+   - #1451: Fix login bug (1h estimado)
+
+   ### Normal
+   - #1448: Write docs (2h estimado)
+
+   ### Baixa
+   - #1452: Refactor CSS (3h estimado)
+
+6. Perguntar:
+   "Que tasks incluir neste sprint? E data limite?"
+   (pode ser: "todas as urgentes", "#1450 e #1448", etc.)
+7. Calcular estimativa total
+8. GERAR SPRINT.md:
+   - sprint_id: YYYY-WNN-[projecto] (semana ISO actual)
+   - tasks_planned: contagem
+   - Preencher tabela de tasks
+9. CONFIRMAR: "Sprint com [N] tasks, ~[X]h, ate [data]. Criar?"
+10. Gravar SPRINT.md
+11. Guardar em mem0:
+    save_memory({
+      content: "Sprint [id] iniciado: [N] tasks, [X]h, ate [data]",
+      tags: ["sprint", "project-[id]", sprint_id]
+    })
+12. "Sprint criado. Check-in recomendado em [data_meio]."
+```
+
+### `/sprint check-in`
+
+```
+1. Ler SPRINT.md
+   - Se nao existe ou status != active: "Sem sprint activo."
+2. Se checkpoint_done == true:
+   "Checkpoint ja realizado. Para novo check-in, usar /sprint review."
+3. mcp__mcp-time__current_time -> calcular dia actual vs periodo
+4. Para cada task do sprint:
+   mcp__desk-crm-v3__get_task({ id: task_id })
+   - Comparar status actual vs planeado
+5. Calcular:
+   - % tempo decorrido
+   - % tasks completadas
+   - Tasks adicionadas apos planeamento (comparar com tasks_planned)
+6. Detectar alertas:
+   - >50% tempo decorrido mas <40% tasks feitas -> "ATRASADO"
+   - Tasks novas adicionadas -> "SCOPE CREEP: [N] tasks nao planeadas"
+   - Tasks bloqueadas -> "BLOQUEIO: [task]"
+7. Apresentar:
+   ---
+   ## Checkpoint Sprint [id]
+
+   **Progresso:** X/Y tasks (Z%)
+   **Tempo:** dia M de N (W% decorrido)
+   **Alerta:** [verde/amarelo/vermelho]
+
+   ### Tasks
+   | Task | Planeado | A