claude-plugins/gestao/skills/proc-creator/SKILL.md

---
name: proc-creator
description: Cria procedimentos seguindo formato Hub Descomplicar. Use quando "criar procedimento", "novo PROC", "documentar processo", "PROC-*". Gera código automático [DEPT]-[TEMA]-[NUM], cria ficheiro na pasta departamental correcta, actualiza INDEX.md.
---

# /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 do departamento:

```markdown
| [PROC-Titulo.md](./PROC-Titulo.md) | [Descrição breve] | [DEPT]-[TEMA]-[NUM] |
```

Actualizar estatísticas:
- Incrementar contador "X procedimentos"
- Actualizar data "Última actualização: YYYY-MM-DD"

---

## Integração com Skills/Agents

Após criar procedimento, informar utilizador:

```markdown
**Próximos passos:**

1. Preencher conteúdo do procedimento
2. Testar procedimento em cenário real
3. Actualizar status: draft → active
4. Adicionar referências em skills/agents relevantes:

\`\`\`markdown
## Referências e Documentação

**SEMPRE consultar:**
- [PROC-Titulo.md](file:///media/ealmeida/Dados/Hub/06-Operacoes/Procedimentos/[Dept]/PROC-Titulo.md)
\`\`\`
```

---

## Exemplos de Uso

### Exemplo 1: Procedimento Técnico D7

```
User: Criar procedimento para deployment EasyPanel
Assistant: /proc-creator

Título: Deployment EasyPanel via API
Departamento: D7-Tecnologia
Tema: Infraestrutura (INF)
Descrição: Deploy automatizado de serviços no EasyPanel usando API oficial

→ Código gerado: INF-EPL-001
→ Ficheiro: PROC-Deployment-EasyPanel.md
→ Localização: D7-Tecnologia/
→ INDEX.md actualizado
```

### Exemplo 2: Procedimento Cross-Departamental

```
User: Documentar processo de gestão de projectos
Assistant: /proc-creator

Título: Sistema Gestão Projectos
Departamento: Cross-Departamental
Tema: Gestão Projectos (GPR)
Descrição: Metodologia híbrida Ágil/Waterfall

→ Código gerado: XDP-GPR-002 (já existe 001)
→ Ficheiro: Sistema-Gestao-Projectos-v2.md
→ Localização: Cross-Departamental/
→ INDEX.md actualizado
```

### Exemplo 3: Procedimento D2-Suporte (Gap)

```
User: Criar procedimento atendimento cliente
Assistant: /proc-creator

Título: Atendimento Cliente
Departamento: D2-Suporte
Tema: Suporte (SUP)
Descrição: Workflow primeiro contacto, templates resposta, escalação

→ Código gerado: SUP-ATC-001 (primeiro do D2!)
→ Ficheiro: PROC-Atendimento-Cliente.md
→ Localização: D2-Suporte/
→ INDEX.md actualizado
→ NOTA: D2 tinha 0 procedimentos, agora tem 1
```

---

## Anti-Patterns

**NUNCA:**
- ❌ Criar procedimento sem perguntar departamento
- ❌ Inventar código sem verificar INDEX.md
- ❌ Esquecer de actualizar INDEX.md
- ❌ Usar status "active" para draft inicial
- ❌ Omitir frontmatter obrigatório
- ❌ Criar em localização errada
- ❌ Duplicar NUM existente no mesmo tema

**SEMPRE:**
- ✅ Confirmar departamento com utilizador
- ✅ Ler INDEX.md para próximo NUM
- ✅ Actualizar INDEX.md após criação
- ✅ Usar status "draft" inicialmente
- ✅ Incluir todo frontmatter obrigatório
- ✅ Criar em pasta departamental correcta
- ✅ Verificar tema antes de atribuir NUM

---

## Validação Pós-Criação

Checklist automática:

```
✅ Ficheiro criado em pasta correcta
✅ Frontmatter completo e válido
✅ Código único e sequencial
✅ INDEX.md actualizado
✅ Template aplicado
✅ Path absoluto correcto
✅ Data actual em YYYY-MM-DD
```

---

*Skill v1.0.0 | 2026-02-13 | Plugin gestao | Descomplicar®*