---
name: doc-coauthoring
description: Workflow estruturado para co-autoria de documentos. Usar quando o utilizador quer escrever propostas comerciais, specs de projecto, relatórios cliente, SOPs, decisões técnicas ou conteúdo estruturado. Guia 3 fases - recolha de contexto, refinamento iterativo e teste de leitura. Trigger quando "escrever doc", "redigir proposta", "criar spec", "documentar", "relatório", "SOP".
layer: wiki
---

# /doc-coauthoring - Co-Autoria de Documentos

Workflow estruturado para criação colaborativa de documentos profissionais. Guia o utilizador por três fases: recolha de contexto, refinamento e teste de leitura.

## Arquitectura

```
Pedido → Fase 1 (Contexto) → Fase 2 (Refinamento) → Fase 3 (Teste Leitura) → Documento Final
              ↓                      ↓                        ↓
         /knowledge              Templates Hub            Sub-agente leitor
         /crm (dados cliente)    Iteração secção a secção  Detecta pontos cegos
```

---

## Quando Activar

**Condições de trigger:**
- Utilizador menciona escrita de documentação: "escrever doc", "redigir proposta", "criar spec", "documentar"
- Utilizador menciona tipos específicos: "proposta comercial", "spec de projecto", "relatório cliente", "SOP", "decisão técnica", "RFC"
- Utilizador inicia uma tarefa de escrita substancial

**Tipos de documento suportados:**

| Tipo | Template Hub | Notas |
|------|-------------|-------|
| Proposta comercial | `Hub/90-Templates/Comercial/` | Integrar dados cliente via /crm |
| Spec de projecto | `Hub/90-Templates/TPL-Projecto/` | Incluir arquitectura, milestones |
| Relatório cliente | `Hub/90-Templates/` | Dados do Desk CRM |
| SOP / Procedimento | `Hub/06-Operacoes/Procedimentos/` | Formato PROC-*.md |
| Decisão técnica | — | Registar contexto e alternativas |
| RFC / Design doc | — | Foco em trade-offs e impacto |

**Oferta inicial:**
Oferecer ao utilizador um workflow estruturado para co-autoria. Explicar as três fases:

1. **Recolha de contexto**: O utilizador fornece todo o contexto relevante enquanto são feitas perguntas de clarificação
2. **Refinamento e estrutura**: Construção iterativa de cada secção através de brainstorming e edição
3. **Teste de leitura**: Testar o documento com um Claude sem contexto para detectar pontos cegos antes de outros lerem

Explicar que esta abordagem garante que o documento funciona quando outros o lêem. Perguntar se preferem este workflow ou trabalhar em formato livre.

Se o utilizador recusar, trabalhar em formato livre. Se aceitar, avançar para a Fase 1.

---

## Fase 1: Recolha de Contexto

**Objectivo:** Fechar a lacuna entre o que o utilizador sabe e o que o Claude sabe, permitindo orientação inteligente depois.

### Perguntas Iniciais

Começar por pedir meta-contexto sobre o documento:

1. Que tipo de documento é? (ex.: proposta comercial, spec de projecto, SOP)
2. Quem é o público-alvo principal?
3. Qual o impacto desejado quando alguém lê isto?
4. Existe um template ou formato específico a seguir?
5. Há algum cliente ou projecto associado? (para consultar /crm)
6. Outras restrições ou contexto relevante?

Informar que podem responder de forma breve ou despejar informação como preferirem.

**Se o utilizador mencionar um template ou tipo de documento:**
- Verificar templates disponíveis em `Hub/90-Templates/`
- Se mencionarem um template específico, usar filesystem para o ler
- Se mencionarem um documento partilhado (Google Drive, etc.), usar a integração adequada

**Se o utilizador mencionar um cliente ou projecto:**
- Usar /crm para obter dados do cliente (contactos, historial, projectos activos)
- Consultar `Hub/07-Clientes/` para contexto adicional
- Verificar propostas anteriores em `Hub/03-Propostas/` ou no Desk CRM

**Se o utilizador mencionar edição de documento existente:**
- Usar a integração adequada para ler o estado actual
- Verificar imagens sem alt-text
- Se existirem imagens sem alt-text, explicar que quando outros usarem o Claude para entender o documento, o Claude não consegue vê-las. Perguntar se querem alt-text gerado.

### Despejo de Informação

Após as perguntas iniciais, encorajar o utilizador a despejar todo o contexto disponível. Pedir informação como:
- Background do projecto/problema
- Discussões de equipa ou documentos relacionados
- Porquê alternativas não estão a ser usadas
- Contexto organizacional (dinâmicas de equipa, incidentes passados)
- Pressões de prazo ou restrições
- Arquitectura técnica ou dependências
- Preocupações de stakeholders
- Dados do CRM relevantes (historial do cliente, propostas anteriores)

Aconselhar a não se preocuparem com organização — apenas tirar tudo cá para fora. Oferecer múltiplas formas de fornecer contexto:
- Despejo de informação em fluxo de consciência
- Apontar para canais ou threads de equipa
- Partilhar links para documentos

**Pesquisa de contexto automática:**
Usar /knowledge para pesquisar contexto relevante nas fontes de conhecimento (NotebookLM, Supabase, docs locais). Informa