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,239 @@
+---
+name: proc-creator
+description: Cria procedimentos seguindo formato Hub Descomplicar. Gera código automático [DEPT]-[TEMA]-[NUM], cria ficheiro na pasta departamental correcta, actualiza INDEX.md. Usar quando "criar procedimento", "novo PROC", "documentar processo", "PROC-*".
+disable-model-invocation: true
+layer: wiki
+---
+
+# /proc-creator - Criador de Procedimentos Hub
+
+Cria procedimentos estruturados seguindo formato e organização Hub Descomplicar.
+
+---
+
+## Referências e Documentação
+
+**SEMPRE consultar:**
+- **[06-Operacoes/Procedimentos/INDEX.md](file:///media/ealmeida/Dados/Hub/06-Operacoes/Procedimentos/INDEX.md)** - Estrutura completa (36 procedimentos, 8 departamentos)
+- **[Hub CLAUDE.md](file:///media/ealmeida/Dados/Hub/CLAUDE.md)** - Secção "Organização de Procedimentos" (convenções, padrão referenciação)
+
+---
+
+## Estrutura de Procedimentos
+
+### 8 Departamentos
+
+| Departamento | Pasta | Código | Procedimentos Actuais |
+|--------------|-------|--------|----------------------|
+| D1-Comercial | `D1-Comercial/` | CRM | 1 |
+| D2-Suporte | `D2-Suporte/` | SUP | 0 (gap) |
+| D3-Contabilidade | `D3-Contabilidade/` | FIN | 2 |
+| D4-RH | `D4-RH/` | HR | 0 (novo) |
+| D5-Design | `D5-Design/` | DES | 0 (gap) |
+| D6-Marketing | `D6-Marketing/` | MKT | 1 |
+| D7-Tecnologia | `D7-Tecnologia/` | DEV, WP, INF, AI, WEB | 28 |
+| Cross-Departamental | `Cross-Departamental/` | XDP | 4 |
+
+**Base path:** `/media/ealmeida/Dados/Hub/06-Operacoes/Procedimentos/`
+
+---
+
+## Convenção de Código
+
+Formato: `[DEPT]-[TEMA]-[NUM]`
+
+**Exemplos:**
+- D7: `DEV-MCP-001`, `WP-SEC-001`, `INF-SSL-001`, `AI-PLG-001`, `WEB-SEO-001`
+- D1: `CRM-OPS-001`
+- D3: `FIN-MOL-001`, `FIN-DSP-001`
+- D6: `MKT-CNT-001`
+- Cross: `XDP-GPR-001`, `XDP-OBS-001`
+
+**Números:** Sequencial por tema (001, 002, 003...)
+
+---
+
+## Protocolo de Criação
+
+```
+1. PERGUNTAR ao utilizador:
+   - Título do procedimento
+   - Departamento (D1-D7 ou Cross)
+   - Tema/categoria
+   - Descrição breve
+
+2. DETERMINAR código:
+   - Ler INDEX.md do departamento
+   - Identificar próximo NUM disponível para o tema
+   - Gerar código [DEPT]-[TEMA]-[NUM]
+
+3. CRIAR ficheiro PROC-*.md:
+   - Nome: PROC-[Titulo].md
+   - Localização: /media/ealmeida/Dados/Hub/06-Operacoes/Procedimentos/[Departamento]/
+   - Usar template abaixo
+
+4. ACTUALIZAR INDEX.md:
+   - Adicionar linha na tabela do departamento
+   - Incrementar contador total
+   - Actualizar data
+
+5. CONFIRMAR:
+   - Mostrar path completo do ficheiro criado
+   - Mostrar código atribuído
+   - Listar próximos passos (preencher conteúdo)
+```
+
+---
+
+## Template PROC-*.md
+
+```markdown
+---
+title: [Título do Procedimento]
+date: YYYY-MM-DD
+type: procedimento
+status: draft
+dept_id: [N]
+desk_dept_id: [N]
+desk_dept_name: [Nome Departamento]
+codigo: [DEPT]-[TEMA]-[NUM]
+tags: [tag1, tag2, tag3]
+---
+
+# [Título do Procedimento]
+
+**Código:** [DEPT]-[TEMA]-[NUM] | **Departamento:** [Nome] | **Status:** Draft
+
+---
+
+## 📋 Contexto
+
+Descrição clara do propósito e âmbito deste procedimento.
+
+---
+
+## 🎯 Objectivo
+
+O que este procedimento pretende alcançar.
+
+---
+
+## 📍 Âmbito
+
+### Aplica-se a:
+- [ ] Item 1
+- [ ] Item 2
+
+### Não se aplica a:
+- [ ] Item 1
+- [ ] Item 2
+
+---
+
+## 🔧 Pré-requisitos
+
+| Requisito | Descrição |
+|-----------|-----------|
+| [Nome] | [Detalhe] |
+
+---
+
+## 📝 Procedimento
+
+### Passo 1: [Nome do Passo]
+
+**Objectivo:** [O quê]
+**Como:**
+1. Acção 1
+2. Acção 2
+
+**Validação:** Como confirmar sucesso
+
+### Passo 2: [Nome do Passo]
+
+[...]
+
+---
+
+## ✅ Checklist de Execução
+
+- [ ] Pré-requisito A verificado
+- [ ] Passo 1 concluído
+- [ ] Passo 2 concluído
+- [ ] Validação final OK
+
+---
+
+## ⚠️ Troubleshooting
+
+| Problema | Causa Provável | Solução |
+|----------|----------------|---------|
+| [Erro X] | [Causa] | [Como resolver] |
+
+---
+
+## 📊 Métricas e KPIs
+
+| Métrica | Target | Como Medir |
+|---------|--------|------------|
+| [Nome] | [Valor] | [Método] |
+
+---
+
+## 🔗 Referências
+
+**Procedimentos relacionados:**
+- [PROC-Outro.md](../PROC-Outro.md)
+
+**Skills relacionadas:**
+- `/skill-name` - Descrição
+
+**Documentação externa:**
+- [Nome](URL)
+
+---
+
+## 📅 Histórico de Revisões
+
+| Data | Versão | Autor | Alterações |
+|------|--------|-------|------------|
+| YYYY-MM-DD | 1.0 | [Nome] | Criação inicial |
+
+---
+
+**[Título] | Código: [DEPT]-[TEMA]-[NUM] | Departamento: [Nome]**
+**Última actualização:** YYYY-MM-DD
+```
+
+---
+
+## Frontmatter Obrigatório
+
+```yaml
+---
+title: [Título Procedimento]
+date: YYYY-MM-DD
+type: procedimento
+status: draft | active | archived
+dept_id: [1-7]
+desk_dept_id: [1-7]
+desk_dept_name: [D1-Comercial | D2-Suporte | ...]
+codigo: [DEPT]-[TEMA]-[NUM]
+tags: [categoria, tema, tecnologia]
+---
+```
+
+**Mapeamento dept_id:**
+- 1 = D1-Comercial (info@descomplicar.pt)
+- 2 = D2-Suporte (suporte@descomplicar.pt)
+- 3 = D3-Contabilidade (contabilidade@descomplicar.pt)
+- 4 = D4-RH (rh@descomplicar.pt)
+- 5 = D5-Design (design@descomplicar.pt)
+- 6 = D6-Marketing (marketing@descomplicar.pt)
+- 7 = D7-Tecnologia (dev@descomplicar.pt)
+
+---
+
+## Actualização INDEX.md
+
+Adicionar linha na tabela d