Files
ealmeida 6285be6c2e feat(gestao): adicionar 9 skills /clip-* + migrar 5 para diag tools MCP
Skills clip-* nunca tinham sido committed. Adicionadas todas (9):
clip, clip-agent, clip-health, clip-instructions, clip-issue, clip-org,
clip-routine, clip-skill, clip-vision.

Migração para mcp__paperclip__diag_* (17 substituições em 5 skills):
- clip: 5 substituições (agents_by_status, false_blockers, token burn,
  stuck routines, company_skills_summary)
- clip-agent: 2 (agent_full_context consolida 4 passos, false_blockers)
- clip-health: 8 (budget_orphans, missing_permissions, missing_heartbeat,
  routine_triggers_broken, false_blockers, heartbeat_token_usage,
  prompt_too_long_errors, stuck_routines, zombie_parents)
- clip-org: 1 (agent_hierarchy)
- clip-routine: 1 (routine_triggers_broken)

Sem substituições (CRUD-específico sem diag_* equivalente):
clip-instructions, clip-issue, clip-skill — mantêm psql.

Refs: Desk #2041, mcp-paperclip feature/diagnostics-db

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 03:59:54 +01:00

175 lines
5.1 KiB
Markdown

---
name: clip-vision
category: gestao
description: "Gera documento de visao estrategica para o CEO Paperclip e bootstraps por C-Level. Resolve o vision gap — agentes param porque lhes falta a visao do fundador. Usar quando 'clip vision', 'visao paperclip', 'vision gap', 'bootstrap ceo', 'direcao agentes'."
version: "1.0.0"
created: 2026-04-07
tools: [Read, Write, Bash, AskUserQuestion]
---
# Skill: /clip-vision
Gera documento de visao estrategica para o CEO Paperclip e bootstrap documents para cada C-Level. Baseado no padrao Paperclip Vision Skill (#368 Aron Prins).
---
## Problema que resolve
Agentes Paperclip param de produzir apos setup porque so recebem tarefas operacionais, nao visao estrategica. O CEO nao sabe para onde ir. Os C-Level nao sabem o que priorizar. O "vision gap" faz com que a organizacao funcione mas sem direcao.
---
## Processo de execucao
### Fase 1 — Recolha de contexto (automatica)
Recolher dados do estado actual do Paperclip e do stack:
1. **Ler estado Paperclip:**
- Ficheiro `/home/ealmeida/paperclip/` — listar agents activos
- Desk CRM task #2041 (projecto Stack) — estado
- `Hub/04-Stack/STK-Estado-Actual.md` — metricas actuais
- `Hub/04-Stack/plano-consolidado-stack-q2-2026.md` — plano e metas
2. **Ler issues e routines:**
- Via MCP Paperclip ou ficheiros locais em `/home/ealmeida/paperclip/`
- Issues abertas, routines activas, ultimos heartbeats
3. **Compilar contexto:** resumo de 10-15 linhas com estado actual
### Fase 2 — Entrevista ao fundador (interactiva)
Fazer 5-7 perguntas ao Emanuel usando AskUserQuestion. Cada pergunta com 3-4 opcoes + "outro":
**Pergunta 1:** Qual e a prioridade principal para os proximos 30 dias?
- a) Aumentar receita (novos clientes, propostas)
- b) Melhorar operacoes internas (eficiencia, automacao)
- c) Desenvolver produto/servico novo
- d) Consolidar o que ja existe (qualidade, documentacao)
- e) Outro: ___
**Pergunta 2:** Que departamento precisa de mais atencao neste momento?
- a) D1 Comercial (vendas, leads, propostas)
- b) D6 Marketing (SEO, conteudo, redes sociais)
- c) D7 Tecnologia (infra, dev, automacao)
- d) D3 Contabilidade (facturas, despesas, cash flow)
- e) Outro: ___
**Pergunta 3:** Que nivel de autonomia queres dar aos agentes?
- a) Passive — so actuam quando pedido, sempre com aprovacao
- b) Balanced — actuam em rotinas, pedem aprovacao para novidades
- c) Active — actuam proactivamente, reportam resultados
- d) Manter o actual
**Pergunta 4:** Qual e o budget mensal aceitavel para agentes IA (tokens + APIs)?
- a) <50 EUR/mes (minimo, so essenciais)
- b) 50-100 EUR/mes (moderado)
- c) 100-200 EUR/mes (investimento activo)
- d) >200 EUR/mes (sem restricao significativa)
**Pergunta 5:** Qual e o objectivo principal do Q2 2026?
- a) Facturacao: atingir X EUR/mes
- b) Clientes: fechar N novos contratos
- c) Produto: lancar servico/SaaS especifico
- d) Stack: maximizar capacidade operacional
- e) Outro: ___
**Pergunta 6:** O que deve ser explicitamente proibido para os agentes?
- a) Contactar clientes directamente
- b) Fazer deploy sem aprovacao
- c) Gastar budget acima de X
- d) Todas as anteriores
- e) Outro: ___
**Pergunta 7:** Como medes sucesso dos agentes Paperclip?
- a) Output tangivel (artigos, propostas, deploys)
- b) Reducao de tempo em tarefas manuais
- c) ROI mensuravel (custo vs valor gerado)
- d) Consistencia (fazem sempre o basico bem)
### Fase 3 — Geracao de documentos
Com base nas respostas, gerar 5 documentos:
#### 1. vision.md (destino: /home/ealmeida/paperclip/vision.md)
```markdown
# Visao Descomplicar — {data}
## Missao
{extraido das respostas + contexto}
## Objectivos Q2 2026
1. {objectivo principal}
2. {objectivo secundario}
3. {objectivo terciario}
## Prioridades (30 dias)
1. {prioridade 1 com accao concreta}
2. {prioridade 2}
3. {prioridade 3}
## Restricoes
- {proibicoes definidas na P6}
- Budget maximo: {P4}
- Governance: {P3}
## Metricas de sucesso
- {P7 — como medir}
## Revisao
- Gerado: {data}
- Proxima revisao: {data + 90 dias}
```
#### 2-5. Bootstrap documents (destino: /home/ealmeida/paperclip/)
Para cada C-Level (CEO, CTO, CMO, COO), gerar `{role}-bootstrap.md`:
```markdown
# Bootstrap {Role} — {data}
## Contexto
{estado actual do departamento relevante}
## Top 3 prioridades
1. {prioridade com accao e deadline}
2. {prioridade}
3. {prioridade}
## Recursos disponiveis
- Skills: {lista relevante}
- MCPs: {lista relevante}
- Routines: {activas no departamento}
## Restricoes
- {do vision.md, filtradas para este papel}
## Proxima accao
{1 accao concreta que pode fazer no proximo heartbeat}
```
### Fase 4 — Resumo e confirmacao
Apresentar resumo ao utilizador:
- 5 documentos gerados com paths
- Sugerir proximos passos (injectar vision.md no CEO heartbeat, etc.)
- Perguntar se quer ajustar algo
---
## Notas importantes
- Os documentos devem ser **accionaveis**, nao genericos
- Cada bootstrap deve referenciar **dados reais** do estado actual
- O vision.md deve ser **injectado no CEO** como contexto do heartbeat
- Sugerir /schedule trimestral para refrescar a visao
---
## Healing Log
```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```