feat(gestao): adiciona plugin gestao (agents, skills, knowledge e metadados do projeto)
This commit is contained in:
@@ -0,0 +1,103 @@
|
||||
---
|
||||
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
|
||||
Reference in New Issue
Block a user