182 lines
5.0 KiB
Markdown
182 lines
5.0 KiB
Markdown
---
|
|
name: spec-coauthor
|
|
description: 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".
|
|
layer: 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 |