239 lines
5.0 KiB
Markdown
239 lines
5.0 KiB
Markdown
---
|
|
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 |