claude-plugins/gestao/skills/spec-coauthor/SKILL.md

name, description, layer

name	description	layer
spec-coauthor	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".	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