Files

Emanuel Almeida 6b3a6f2698 feat: refactor 30+ skills to Anthropic progressive disclosure pattern

- All SKILL.md files now <500 lines (avg reduction 69%)
- Detailed content extracted to references/ subdirectories
- Frontmatter standardised: only name + description (Anthropic standard)
- New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator
- Design skills: anti-slop guidelines, premium-proposals reference
- Removed non-standard frontmatter fields (triggers, version, author, category)

Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao,
core-tools, negocio, perfex-dev, wordpress, design-media

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-12 15:05:03 +00:00

8.0 KiB

Raw Blame History

name, description, disable-model-invocation

name	description	disable-model-invocation
proc-creator	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-*".	true

/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 - Estrutura completa (36 procedimentos, 8 departamentos)
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

---
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

---
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:

| [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:

**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®

8.0 KiB Raw Blame History