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