5.0 KiB
name, description, layer
| name | description | layer |
|---|---|---|
| doc-coauthoring | 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". | 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:
- Recolha de contexto: O utilizador fornece todo o contexto relevante enquanto são feitas perguntas de clarificação
- Refinamento e estrutura: Construção iterativa de cada secção através de brainstorming e edição
- 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:
- Que tipo de documento é? (ex.: proposta comercial, spec de projecto, SOP)
- Quem é o público-alvo principal?
- Qual o impacto desejado quando alguém lê isto?
- Existe um template ou formato específico a seguir?
- Há algum cliente ou projecto associado? (para consultar /crm)
- 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