feat(gestao): adiciona plugin gestao (agents, skills, knowledge e metadados do projeto)

2026-10-28 16:08:53 +00:00
parent 7b2162ff29
commit de2d6f2fb5
91 changed files with 13525 additions and 0 deletions
@@ -0,0 +1,182 @@
+---
+name: spec-coauthor
+description: Co-autoria iterativa de documentos estruturados — SPECs de projecto, propostas comerciais e PROCs operacionais. Workflow 3 fases com brainstorming, curadoria e teste de leitura por sub-agente. Usar quando "spec", "proposta", "PROC", "documento", "co-autoria", "redigir", "estruturar documento", "escrever proposta".
+layer: wiki
+---
+
+# /spec-coauthor - Co-Autoria de Documentos Estruturados
+
+Co-autoria iterativa de SPECs, propostas comerciais e PROCs operacionais com workflow de 3 fases: recolha de contexto, refinamento estruturado e teste de leitura.
+
+---
+
+## Tipos de Documento Suportados
+
+| Tipo | Audiência | Exemplos |
+|------|-----------|----------|
+| **SPEC de projecto** | Equipa técnica, Emanuel | WhatSMS-v2-SPEC.md, DashDescomplicar-SPEC.md |
+| **Proposta comercial** | Cliente, stakeholders | Proposta-ClienteX-SEO.md, Proposta-ERP-2026.md |
+| **PROC operacional** | Equipa interna, ops | PROC-Deploy-EasyPanel.md, PROC-Onboarding-Cliente.md |
+
+---
+
+## Fase 1: Recolha de Contexto
+
+### 1.1 Identificar tipo de documento
+
+Perguntar ao utilizador:
+
+```
+1. Que tipo de documento precisas criar?
+   a) SPEC de projecto (requisitos, arquitectura, milestones)
+   b) Proposta comercial (solução, pricing, timeline)
+   c) PROC operacional (passos, checklist, troubleshooting)
+   d) Outro (descrever)
+
+2. Para quem é este documento?
+   - Emanuel (uso interno / decisão)
+   - Cliente (venda / aprovação)
+   - Equipa técnica (execução)
+   - Múltiplas audiências (especificar)
+
+3. Qual o impacto esperado?
+   - Aprovar orçamento / go-ahead
+   - Alinhar equipa em requisitos
+   - Documentar processo para replicar
+   - Outro (especificar)
+```
+
+### 1.2 Recolher contexto existente
+
+Após identificar tipo e audiência, recolher contexto via:
+
+**Desk CRM:**
+```
+mcp__desk-crm-v3__get_projects → projectos activos relacionados
+mcp__desk-crm-v3__get_tasks    → tarefas e sub-tarefas relevantes
+mcp__desk-crm-v3__get_customers → dados do cliente (se proposta)
+```
+
+**Hub / Ficheiros:**
+```
+Read ficheiros relevantes em:
+  /media/ealmeida/Dados/Hub/05-Projectos/[projecto]/
+  /media/ealmeida/Dados/Hub/07-Clientes/[cliente]/
+  /media/ealmeida/Dados/Hub/90-Templates/
+```
+
+**Perguntas complementares de contexto:**
+```
+4. Existe documentação anterior? (SPEC, proposta, email, notas)
+   → Partilhar caminho ou colar conteúdo
+
+5. Há restrições ou requisitos não-negociáveis?
+   → Prazo, orçamento, tecnologia obrigatória
+
+6. Qual o nível de detalhe desejado?
+   → Resumo executivo (1-2 pág.) / Documento completo (5-15 pág.) / Ultra-detalhado
+```
+
+### 1.3 Confirmar antes de avançar
+
+Apresentar resumo do contexto recolhido e confirmar com utilizador antes de passar à Fase 2.
+
+```
+**Contexto confirmado:**
+- Tipo: [SPEC / Proposta / PROC]
+- Audiência: [quem vai ler]
+- Impacto: [decisão esperada]
+- Referências encontradas: [ficheiros / tarefas]
+- Nível de detalhe: [resumo / completo / ultra]
+
+Avançar para estruturação? (s/n)
+```
+
+---
+
+## Fase 2: Refinamento e Estrutura
+
+### 2.1 Brainstorming de secções
+
+Para cada secção principal do documento, gerar **5 a 20 opções** de abordagem/conteúdo.
+
+**Formato de apresentação:**
+
+```
+## Secção: [Nome da Secção]
+
+Opções de abordagem:
+
+1. [Opção concisa — 1 linha de descrição]
+2. [Opção alternativa]
+3. [Opção mais detalhada]
+4. [Opção focada em audiência técnica]
+5. [Opção focada em audiência não técnica]
+...
+
+→ Quais queres manter? (ex: "1,3,5" ou "todas" ou "nenhuma, tentar de novo")
+```
+
+**Regras do brainstorming:**
+- Apresentar opções reais e diferenciadas (não variações mínimas)
+- Indicar vantagens de cada abordagem em 1 linha
+- Nunca gerar menos de 5 opções por secção
+- Para SPECs técnicas: incluir sempre opção de maior e menor detalhe
+- Para propostas: incluir sempre opção orientada a valor e a custo
+
+### 2.2 Curadoria pelo utilizador
+
+O utilizador selecciona opções com sintaxe simples:
+
+```
+"Keep 1,4,7"     → manter apenas essas opções
+"Todas"          → aceitar todas
+"Nenhuma"        → tentar de novo com abordagem diferente
+"1 mas mais curto" → manter com refinamento
+"Combinar 2 e 5" → fusão das opções
+```
+
+### 2.3 Drafting iterativo
+
+Após curadoria de cada secção, produzir rascunho com `str_replace_editor` ou apresentar em bloco markdown.
+
+**Ciclo por secção:**
+```
+1. Brainstorm (5-20 opções)
+2. Curadoria pelo utilizador
+3. Draft da secção
+4. Revisão inline ("mudar X para Y" / "expandir parágrafo Z")
+5. Confirmar → avançar para secção seguinte
+```
+
+**Ordem de secções por tipo:**
+
+Para SPEC de projecto:
+```
+1. Contexto e problema
+2. Objectivo e scope
+3. Requisitos funcionais
+4. Requisitos técnicos / arquitectura
+5. Milestones e timeline
+6. Riscos e dependências
+7. Definition of Done
+8. Referências
+```
+
+Para proposta comercial:
+```
+1. Sumário executivo
+2. Contexto e diagnóstico
+3. Solução proposta
+4. Entregáveis e timeline
+5. Investimento e condições
+6. Próximos passos
+7. Sobre a Descomplicar
+```
+
+Para PROC operacional:
+```
+1. Objectivo e âmbito
+2. Pré-requisitos
+3. Passos detalhados
+4. Checklis