ealmeida/claude-plugins
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: ealmeida/claude-plugins:d3f9c950cd06a80988b0bd1f957bcae8ca27cdc7
Branches Tags
ealmeida/claude-plugins:main
..
compare: ealmeida/claude-plugins:main
Branches Tags
ealmeida/claude-plugins:main

3 Commits
d3f9c950cd .. main

Author SHA1 Message Date
ealmeida 2439e3b41c docs(okf): frontmatter OKF + rich abstracts nas descriptions 
Normalizacao OKF dos .md: type/title/description/timestamp/layer +
descriptions factuais (rich abstracts). Apenas .md tracked; corpos intactos.
Parte da aplicacao OKF a /Dados/Dev (28-06-2026).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 23:11:00 +01:00
ealmeida f9f8f5135f atualiza definições de skills e plugins do Claude com melhorias locais 2026-06-10 13:27:46 +01:00
ealmeida cb8699075f feat(today): secção Fornecedores Auto-Criados pendentes validação 
Adiciona instrução na Fase 1 para verificar auto_proposto=true em
fornecedores-iva.json e apresentar tabela de revisão no dashboard.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-28 14:37:44 +01:00
16 changed files with 568 additions and 254 deletions
Expand all files Collapse all files
README.md
+8
View File
@@ -1,3 +1,11 @@
---
type: Reference
title: Readme
description: >-
Marketplace de plugins Claude Code da Descomplicar
timestamp: 2026-02-05T23:36:56.167944+00:00
layer: wiki
---
# claude-plugins # claude-plugins
Marketplace de plugins Claude Code da Descomplicar Marketplace de plugins Claude Code da Descomplicar
core-tools/skills/metrics/SKILL.md
+37
View File
@@ -36,6 +36,43 @@ Complementa `/reflect` (qualitativo) com dados quantitativos, `/worklog` com met
| `/metrics --roi` | ROI por cliente/projecto | | `/metrics --roi` | ROI por cliente/projecto |
| `/metrics --export` | Exportar JSON/CSV | | `/metrics --export` | Exportar JSON/CSV |
| `/metrics --alerts` | Listar alertas activos | | `/metrics --alerts` | Listar alertas activos |
| `/metrics --tools` | **Telemetria local de tool calls (ver secção Local Tool Telemetry)** |
---
## Local Tool Telemetry (G3.1-B)
Desde 08-04-2026 há captura universal de **todas** as tool calls do Claude Code via hook PostToolUse (`~/.claude/hooks/telemetry-posttool-hook.sh`). Complementa a telemetria Desk CRM com dados locais imediatos.
**Ficheiro:** `~/.claude-work/tool-invocations.jsonl` (1 linha por tool call: ts, session, tool_use_id, tool_name, success, error)
**Agregador:** `/media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py`
```bash
# Overview últimas 24h
python3 /media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py
# Só hoje
python3 /media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py --today
# Últimos 7 dias
python3 /media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py --last 7d
# Filtrar por sessão
python3 /media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py --session <session_id>
# Output JSON (para pipeline/grafos)
python3 /media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py --json
```
**Output:** total de invocations, sessões únicas, top 20 tools (contagem + %), falhas por tool com amostras de erro, top 5 sessões por volume.
**Limitações conhecidas:**
- Duration não é capturada (harness não entrega duration no hook payload). Apenas contagem e success/failure.
- Tokens não capturáveis via hooks (não estão no payload).
- Só captura tool calls que chegam ao PostToolUse — tool calls bloqueados por hooks PreToolUse não aparecem.
Ver `04-Stack/CHANGELOG.md` bloco 08-04-2026 sessão 2 para contexto do gap e decisão de scope.
### Agregacoes Disponiveis ### Agregacoes Disponiveis
crm-ops/skills/proposta-visual/SKILL.md
+91 -2
View File
@@ -116,6 +116,18 @@ Mostra: "750 EUR + IVA" + "Investimento único · prazo 1-2 semanas"
| Import de componentes SVG (`<Svg>`, `<Circle>`) | Crasha web worker do PDFDownloadLink | Implementar gráficos inline com `<View>` | | Import de componentes SVG (`<Svg>`, `<Circle>`) | Crasha web worker do PDFDownloadLink | Implementar gráficos inline com `<View>` |
| `Font.register` com fontes locais/CDN em multi-página | Falha silenciosa | Usar Helvetica/Helvetica-Bold (built-in) | | `Font.register` com fontes locais/CDN em multi-página | Falha silenciosa | Usar Helvetica/Helvetica-Bold (built-in) |
| `href` vazio no PDFDownloadLink | PDF não gerou — verificar consola | Cache do browser — Ctrl+Shift+R | | `href` vazio no PDFDownloadLink | PDF não gerou — verificar consola | Cache do browser — Ctrl+Shift+R |
| `width: "100%"` em bars/elementos dentro de flex container | Não resolve — fica invisível | Usar `alignSelf: "stretch"` no elemento e no container pai |
| Imagens com path absoluto (`/home/...`) | react-pdf não acede ao filesystem local | Colocar em `public/assets/` e referenciar como `"assets/foto.png"` (sem `/` inicial) |
| `borderBottomWidth` no header + `borderTopWidth` em componente filho | Duplica a linha dourada visualmente | Usar apenas `borderTopWidth: 2` no próprio header; remover `borderBottom` |
**Hifenização:** Para desactivar em todo o PDF, adicionar ao `<Document>`:
```jsx
hyphenationCallback={(word) => [word]}
```
**Ícones no PDF:** Usar `PDFIcons.jsx` (`src/pdf/sections/`) com `Svg/Path/Circle/Line/Polyline` de `@react-pdf/renderer`. NÃO importar lucide-react nos componentes PDF — crasha o worker.
**Ícones na web:** Usar `lucide-react`. Padrão: `FALLBACK_ICONS[i % FALLBACK_ICONS.length]` para rotação automática por índice quando o JSON não tem campo `icon`.
### 6. Página 360° (service360) — contextualizar ### 6. Página 360° (service360) — contextualizar
@@ -132,6 +144,64 @@ Se `service360` for `null`, a secção não aparece.
As condições estão numa página PDF separada (não na mesma que o roadmap) para evitar corte entre páginas. O componente `PDFWorkDone` retorna um Fragment com 2 Pages. As condições estão numa página PDF separada (não na mesma que o roadmap) para evitar corte entre páginas. O componente `PDFWorkDone` retorna um Fragment com 2 Pages.
### 8. Apresentação 16:9 — PDFPresentation.jsx
Existe um segundo output PDF em formato 1920×1080 (slides), activado por um botão "Apresentação 16:9" no canto inferior direito da proposta web.
**Ficheiros envolvidos:**
- `src/pdf/PDFPresentation.jsx` — documento completo com todos os slides
- `src/pdf/sections/PDFSlide.jsx` — wrapper de slide (Page 1440×810pt, header com logo, rodapé com numeração)
**Dimensões:** 1920×1080 @ 72dpi → `[1440, 810]` em pontos (unidade do react-pdf).
**Estrutura de slides:**
| Slide | Componente | Dados |
|-------|-----------|-------|
| Capa | `SlideCover` | `data.title`, `client`, `date`, `company` |
| Diagnóstico | `SlideProblem` | `context.description`, `context.diagnosis` |
| Descomplicar 360° | `Slide360` | `educationSections` com `label:"Descomplicar 360°"` |
| Educação | `SlideEducation` | restantes `educationSections` |
| Soluções | `SlideService360` | `service360.areas` |
| Previsão de leads | `SlideLeadForecast` | `leadForecast` |
| Preços | `SlidePricing` | `plans` |
| Roadmap | `SlideRoadmap` | `roadmap` |
| Contacto | `SlideContact` | `company`, `client.contact` |
**Helper components internos (PDFPresentation.jsx):**
- `GoldLine` — linha dourada decorativa
- `Tag` — label uppercase dourado (fontSize 13)
- `SlideTitle` — título principal do slide (fontSize 52 default)
- `SlideBody` — corpo do slide (fontSize 19)
- `Card` — caixa de conteúdo com border esquerda dourada (title 16, body 14)
- `CardGrid` — wrapper flexWrap para cards
**Tamanhos de referência para legibilidade em sala:**
- Tag: 13pt | SlideTitle: 42-58pt | SlideBody: 19pt
- Card title: 16pt | Card body: 14pt
- Cover logo: height 120 (3× maior que header normal)
**Separação Slide360 vs SlideEducation:**
```jsx
const slide360 = educationSections?.find(s => s.label?.toLowerCase().includes("360"))
const otherSections = educationSections?.filter(s => !s.label?.toLowerCase().includes("360"))
```
**Botão no App.jsx:**
```jsx
<PDFDownloadLink
document={<PDFPresentation data={currentProposal} />}
fileName={`apresentacao-descomplicar-${...}.pdf`}
>
{({ loading }) => <button>Apresentação 16:9</button>}
</PDFDownloadLink>
```
**PROIBIÇÕES específicas do 16:9:**
- NÃO usar `gap` em `flexWrap` (mesmo bug do A4)
- NÃO usar `rgba()` em `borderColor`
- Manter `hyphenationCallback` no `<Document>` do PDFPresentation também
--- ---
## Protocolo ## Protocolo
@@ -342,6 +412,7 @@ rm -f /tmp/propostas-dist.tar.gz
|------|---------|------|------| |------|---------|------|------|
| `ljm-360-61a8aecc` | A Loja da Maria | 360° (mensal) | 2026-03-20 | | `ljm-360-61a8aecc` | A Loja da Maria | 360° (mensal) | 2026-03-20 |
| `ccv-bookeo-a3f7c1d2` | Carvoeiro Caves | Migração técnica (único) | 2026-03-23 | | `ccv-bookeo-a3f7c1d2` | Carvoeiro Caves | Migração técnica (único) | 2026-03-23 |
| `pbk-autoridade-local-2026` | Equipa Sérgio Oliveira e Paula Barros · KW Portugal | SEO + conteúdo hiperlocal (mensal) | 2026-04-27 |
--- ---
@@ -366,12 +437,26 @@ rm -f /tmp/propostas-dist.tar.gz
- Checklist pré-build e teste PDF obrigatório - Checklist pré-build e teste PDF obrigatório
- Condições comerciais em página PDF separada - Condições comerciais em página PDF separada
### v2.2.0 (2026-04-27)
- Formato 16:9 documentado: `PDFPresentation.jsx` + `PDFSlide.jsx`
- Regra 8 adicionada: estrutura de slides, dimensões, helper components, tamanhos de referência
- Separação Slide360 vs SlideEducation por label
- Botão "Apresentação 16:9" no App.jsx documentado
- Proibições específicas 16:9 adicionadas
### v2.1.0 (2026-04-27)
- Novos bugs react-pdf documentados: `width:"100%"` em flex, paths absolutos em imagens, `borderBottom` duplicado
- Hifenização: `hyphenationCallback` no `<Document>`
- Padrão de ícones: `PDFIcons.jsx` para PDF, lucide-react para web, fallback por índice
- Proposta `pbk-autoridade-local-2026` adicionada ao registo
- Healing Log com 5 erros reais corrigidos
### v1.0.0 (2026-03-23) ### v1.0.0 (2026-03-23)
- Versão inicial - Versão inicial
--- ---
**Versão:** 2.0.0 | **Data:** 2026-03-23 **Versão:** 2.2.0 | **Data:** 2026-04-27
--- ---
@@ -380,7 +465,11 @@ rm -f /tmp/propostas-dist.tar.gz
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar. Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
```jsonl ```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"} {"date":"2026-04-27","issue":"Barras de gráfico invisíveis no PDF","fix":"width:'100%' não funciona em flex containers — substituir por alignSelf:'stretch' no container e na barra","source":"user"}
{"date":"2026-04-27","issue":"Linha dourada duplicada no topo das páginas","fix":"PDFPage tinha borderBottomWidth no header E os componentes filhos tinham borderTopWidth — remover borderBottom do header, manter apenas borderTopWidth:2","source":"user"}
{"date":"2026-04-27","issue":"Foto do gestor de conta não aparece no PDF","fix":"react-pdf não carrega paths absolutos do filesystem — copiar para public/assets/ e referenciar sem / inicial","source":"user"}
{"date":"2026-04-27","issue":"Border verde em vez de dourado no PDF","fix":"rgba() em borderColor renderiza verde — usar hex sólido (#D4A020)","source":"user"}
{"date":"2026-04-27","issue":"Hifenização indesejada no PDF","fix":"Adicionar hyphenationCallback={(word) => [word]} ao <Document>","source":"user"}
``` ```
*Adicionar nova linha após cada erro corrigido.* *Adicionar nova linha após cada erro corrigido.*
dev-tools/skills/pdf/SKILL.md
+1 -1
View File
@@ -766,7 +766,7 @@ def extract_text_with_ocr(pdf_path):
| Propostas | `/media/ealmeida/Dados/Hub/03-Propostas/` | | Propostas | `/media/ealmeida/Dados/Hub/03-Propostas/` |
| Arquivo clientes | `/media/ealmeida/Dados/GDrive/Arquivo_de_Clientes/` | | Arquivo clientes | `/media/ealmeida/Dados/GDrive/Arquivo_de_Clientes/` |
| Knowledge Base | `/media/ealmeida/Dados/Hub/06-Operacoes/Knowledge-Base/PDFs/` | | Knowledge Base | `/media/ealmeida/Dados/Hub/06-Operacoes/Knowledge-Base/PDFs/` |
| Backups | `/media/ealmeida/Dados/GDrive/Backups/` | | Backups | `/media/ealmeida/Externo/LocalBackups/` (espelhado p/ GDrive via rclone) |
| Temporarios | `~/.claude-work/` (limpar ao concluir) | | Temporarios | `~/.claude-work/` (limpar ao concluir) |
### MCPs relevantes ### MCPs relevantes
gestao/skills/clip-agent/SKILL.md
+60 -5
View File
@@ -194,12 +194,67 @@ UPDATE agents SET adapter_config = adapter_config || '{"dangerouslySkipPermissio
WHERE id = '{{AGENT_ID}}'; WHERE id = '{{AGENT_ID}}';
``` ```
**Nota sobre modelos e adapters:** O adapter `claude_local` já não é usado para agentes heartbeat. Distribuição actual: **Política de adapters por nível (actualizado 07-04-2026):** `opencode_local` foi **completamente removido** (modelos indisponíveis). Distribuição actual:
- 1 agente (CEO) usa `gemini_local` com `gemini-2.5-pro` - **C-Level (5)** — CEO, CDO, CFO, CGO, CTO: `claude_local` com `claude-sonnet-4-6` (decisão estratégica, exige raciocínio premium)
- 50 agentes usam `gemini_local` com `gemini-2.5-flash` - **Especialistas/Directores (59)**: `gemini_local` com `gemini-2.5-flash` (execução, custo baixo)
- 13 agentes usam `opencode_local` com `openrouter/x-ai/grok-4.1-fast` - **Analyst on-demand (1)** — Reality Checker: `process` com `claude-sonnet-4-6` (sem heartbeat)
**Agentes analyst/read-only (ex: Reality Checker):** usar `adapter_type: process` com `adapter_config.model: "claude-sonnet-4-6"` e `instructionsBundleMode: "external"`. Estes agentes são invocados manualmente (heartbeat desactivado), não consomem budget em modo autónomo. **Configurar `claude_local` (template canónico — C-Level):**
```json
{
"cwd": "/media/ealmeida/Dados/Hub/04-Stack/02.06-Clip",
"model": "claude-sonnet-4-6",
"command": "claude",
"dangerouslySkipPermissions": true,
"timeoutSec": 900,
"graceSec": 20,
"instructionsFilePath": "<path absoluto AGENTS.md>"
}
```
Modelos válidos: `claude-opus-4-6`, `claude-sonnet-4-6`, `claude-haiku-4-6`, `claude-sonnet-4-5-20250929`, `claude-haiku-4-5-20251001`.
**Configurar `gemini_local` (template canónico):**
```json
{
"cwd": "/media/ealmeida/Dados/Hub/04-Stack/02.06-Clip",
"yolo": true,
"model": "gemini-2.5-flash",
"command": "/home/ealmeida/.paperclip/gemini-wrapper.sh",
"sandbox": false,
"newSession": true,
"instructionsFilePath": "<path absoluto AGENTS.md>"
}
```
Campos:
- `command` — wrapper Gemini CLI local em `/home/ealmeida/.paperclip/gemini-wrapper.sh`
- `model` — `gemini-2.5-flash` (default) ou `gemini-2.5-pro` (CEO/tarefas pesadas)
- `yolo: true` — auto-aprovar comandos (equivalente a `dangerouslySkipPermissions` do claude_local)
- `sandbox: false` — sem sandbox de filesystem
- `newSession: true` — sessão nova por run
- `cwd` — `/media/ealmeida/Dados/Hub/04-Stack/02.06-Clip` (NUNCA usar Hub raiz)
- `instructionsFilePath` — path absoluto para AGENTS.md
**Migrar agente para gemini_local (SQL):**
```sql
UPDATE agents
SET adapter_type = 'gemini_local',
adapter_config = jsonb_build_object(
'cwd', COALESCE(adapter_config->>'cwd', '/media/ealmeida/Dados/Hub/04-Stack/02.06-Clip'),
'yolo', true,
'model', 'gemini-2.5-flash',
'command', '/home/ealmeida/.paperclip/gemini-wrapper.sh',
'sandbox', false,
'newSession', true,
'instructionsFilePath', adapter_config->>'instructionsFilePath'
),
updated_at = NOW()
WHERE id = '{{AGENT_ID}}';
```
**Nota sobre API REST vs SQL:** O endpoint `PATCH /api/agents/:id` valida `adapterType` contra enum desactualizada que não inclui `gemini_local` (devolve HTTP 400). Workaround actual: SQL directo na BD Paperclip (`postgres://paperclip:paperclip@localhost:54329/paperclip`). Quando a validação for actualizada, preferir sempre API com header `User-Agent: node` (Cloudflare bloqueia `curl/*`).
**Agentes analyst/read-only (ex: Reality Checker):** usar `adapter_type: process` com `adapter_config.model: "claude-sonnet-4-6"` e `instructionsBundleMode: "external"`. Estes agentes são invocados manualmente (heartbeat desactivado por design), não consomem budget em modo autónomo.
### Passo 7b: Sessão e tokens (INC-12) ### Passo 7b: Sessão e tokens (INC-12)
gestao/skills/clip-skill/SKILL.md
+5 -6
View File
@@ -25,13 +25,12 @@ Skills no Paperclip funcionam como **injecção de contexto em runtime**:
- Atribuição é por agente via `adapter_config.paperclipSkillSync.desiredSkills` (array de slugs) - Atribuição é por agente via `adapter_config.paperclipSkillSync.desiredSkills` (array de slugs)
- Skills instaladas na empresa ficam em `company_skills` — só as atribuídas ao agente são injectadas - Skills instaladas na empresa ficam em `company_skills` — só as atribuídas ao agente são injectadas
**Distribuição actual de adapters:** **Distribuição actual de adapters (07-04-2026):**
- 1 agente (CEO): `gemini_local` com `gemini-2.5-pro` - 5 C-Level (CEO/CDO/CFO/CGO/CTO): `claude_local` com `claude-sonnet-4-6` (raciocínio estratégico)
- 50 agentes: `gemini_local` com `gemini-2.5-flash` - 59 especialistas/directores: `gemini_local` com `gemini-2.5-flash` (execução, baixo custo)
- 13 agentes: `opencode_local` com `openrouter/x-ai/grok-4.1-fast` - 1 analyst (Reality Checker): `process` com `claude-sonnet-4-6` (on-demand, sem heartbeat, sem skills)
- Agentes analyst/passive (ex: Reality Checker): `process` com `claude-sonnet-4-6` (sem heartbeat, sem skills)
O adapter `claude_local` já não é usado para agentes heartbeat. `opencode_local` foi **removido** (modelos indisponíveis). Política: C-Level = claude_local sonnet-4-6, restantes = gemini_local. Templates em `/clip-agent`.
## Modo lista (sem argumentos) ## Modo lista (sem argumentos)
gestao/skills/daily-digest/SKILL.md
+1 -6
View File
@@ -40,11 +40,7 @@ Em paralelo:
mcp__desk-crm-v3__get_estimates({ status: 4, limit: 20 }) mcp__desk-crm-v3__get_estimates({ status: 4, limit: 20 })
Estimates com status "To Do" Estimates com status "To Do"
6. ESTIMATES ACEITES 6. AGENDA DO DIA
mcp__desk-crm-v3__get_estimates({ status: 3, limit: 10 })
Destaques de valor
7. AGENDA DO DIA
mcp__google-workspace__calendar_get_events({ mcp__google-workspace__calendar_get_events({
user_google_email: "emanuelalmeidaa@gmail.com", user_google_email: "emanuelalmeidaa@gmail.com",
time_min: "YYYY-MM-DDT00:00:00Z", time_min: "YYYY-MM-DDT00:00:00Z",
@@ -75,7 +71,6 @@ Em paralelo:
### Leads + Propostas ### Leads + Propostas
- Leads novos: X - Leads novos: X
- Propostas pendentes: Y - Propostas pendentes: Y
- Estimates aceites: Z (destaque: [cliente] [valor] EUR)
### Agenda ### Agenda
- HH:MM - [Evento] - HH:MM - [Evento]
gestao/skills/knowledge/SKILL.md
+239 -200
View File
@@ -1,188 +1,225 @@
--- ---
name: knowledge name: knowledge
description: Router de conhecimento Família A/B. Família A (operacional interna) consultada em paralelo para qualquer pergunta sobre processos, projectos, decisões, histórico. Família B (NotebookLM externa) só para conhecimento conceptual/teórico. v2.2.0 description: Router de conhecimento unificado. Classifica pergunta por tipo e encaminha para fonte certa (Hub granular/NLM/Context7/CC memory/Supabase/Desk CRM/Git). v3.1.0
--- ---
# /knowledge — Router Família A/B v2.2.0 # /knowledge — Router Unificado v3.1.0
> **Correcção arquitectural 08-04-2026:** a v2.0.0 tratava NotebookLM como fonte primária. Isso estava errado — NotebookLM não vê operações, não vê estado real, só tem ebooks e transcripts. Em `~/.claude/projects/-media-ealmeida-Dados-Hub/memory/feedback_knowledge-router-arquitectura.md` está o racional completo. > **Reescrita 13-04-2026:** v2.2.0 usava modelo Familia A/B com NLM restrito a "externo".
> **v2.2.0 (13-04-2026):** LightRAG removido da Família A — serviço com 0 documentos desactivado. Família A passa a 4 fontes: Supabase, CC memory, Hub, Desk CRM. > v3.0.0 classifica por tipo de pergunta (8 rotas), adiciona Hub granular
> (QR/KB/APIs/Manuais/PROCs/Troubleshooting), reclassifica NLM como referencia
> tecnica primaria, e torna Supabase complementar (nao alicerce).
> Racional: `plans/atomic-fluttering-flame.md`
## Princípio de routing ## Principio
**Não é fallback linear.** É router por tipo de pergunta: **Classificar pergunta → fonte certa.** Nao e fallback linear, nao e "Familia A depois B". E routing directo por tipo.
- **Operacional / processual / histórico / decisões / projectos / código interno** → **Família A em paralelo**, consolidar com citação de origem. ---
- **Conceptual / teórico / externo / research / mercado / ebooks** → **Família B (NotebookLM)** com routing por tema (tabela em baixo).
- **Ambíguo** → perguntar ao utilizador qual o tipo.
## Família A — Operacional interna (paralelo, complementares) ## Router principal (8 tipos)
| Fonte | Tool | Conteúdo | ### 1. Facto rapido (ID, path, comando, credencial)
|-------|------|----------|
| **memory-supabase** | `mcp__memory-supabase__search_memories(query, threshold=0.7, limit=10)` | Memórias persistentes cross-sessão com embeddings. Decisões, contexto, lacunas anteriores. |
| **Memória CC cross-projecto** | `Grep` recursivo em `~/.claude/projects/*/memory/*.md` | **110 ficheiros em 34 projectos.** Harness só carrega automaticamente a memória do `cwd` — este grep é **obrigatório** para não perder contexto de outros projectos. |
| **Obsidian / Hub** | `Grep` em `/media/ealmeida/Dados/Hub/**/*.md` | PROCs, QRs, INDEX, frontmatter, procedimentos, histórico. |
| **Desk CRM** | `mcp__desk-crm-v3__*` (tasks, projects, tickets, customers) | Fonte de verdade operacional: tarefas, projectos, clientes, tickets, horas. |
### Workflow Família A **Sinais:** "qual e o ID de", "path para", "comando para", "porta do"
``` **Fontes (sequencial — parar ao primeiro hit):**
1. Classificar pergunta como operacional (default para queries internas) 1. `Grep` em `/media/ealmeida/Dados/Hub/06-Operacoes/Documentacao/Quick-Reference/QR-*.md`
2. Disparar em PARALELO (mesma mensagem, vários tool calls): 2. `Grep` em `~/.claude/projects/*/memory/*.md` (cross-projecto)
- mcp__memory-supabase__search_memories(query, threshold=0.65, limit=8) [graceful se MCP indisponível]
- Grep ~/.claude/projects/*/memory/*.md
- Grep Hub/**/*.md (limitar a pastas relevantes quando possível)
- Desk CRM search (se query menciona cliente/projecto/tarefa)
3. Consolidar resposta citando origem de cada fragmento
4. Se Família A insuficiente → perguntar ao utilizador ou escalar para Família B
```
**Nota sobre graceful fallback:** as tools `mcp__*` podem estar indisponíveis em sessões específicas por razões de auto-discovery do harness. Se a chamada falhar com "No such tool available", continuar o paralelismo com as outras fontes e reportar a lacuna no output final. **QR routing por keyword:**
### Formato de resposta Família A | Keywords | Ficheiro |
|----------|----------|
| servidor, ip, porta, ssh | QR-Servidores.md |
| cwp, virtualhost, conta cwp | QR-CWP.md |
| site cwp, dominio cwp | QR-Sites-CWP.md |
| easypanel, servico, container | QR-EasyPanel.md |
| desk, tabela, campo bd, relacao | QR-Desk-BD.md |
| staff id, project id, category id | QR-IDs-Frequentes.md |
| moloni, serie, imposto, metodo | QR-Moloni.md |
| path, directorio, pasta | QR-Paths-Locais.md |
| backup, rota backup, destino | QR-Backups.md |
| sync, syncthing, rsync | QR-Sync-Ficheiros.md |
| script, claudedev | QR-Scripts.md |
| credencial, password, api key | QR-Credenciais.md |
| rank math, seo wp-cli | QR-RankMath-WP-CLI.md |
| capa, cover, podcast imagem | QR-Cover-Generator.md |
| alurin, desktop, laptop | QR-Alurin-Desktop.md |
### 2. Como funciona X / Como fazer Y (referencia tecnica)
**Sinais:** "como funciona", "como configurar", "como fazer", "melhores praticas", "tutorial", "deep dive"
**Fontes (paralelo — consolidar):**
1. **Hub Knowledge-Base** — `Grep` em `/media/ealmeida/Dados/Hub/06-Operacoes/Knowledge-Base/*.md` (preferir ficheiro local se existir match directo)
2. **NotebookLM** — max 2 notebooks por query (routing por tema abaixo)
3. **Hub Manuais** — `Grep` em `/media/ealmeida/Dados/Hub/06-Operacoes/Documentacao/Manuais/**/*.md`
4. **Context7** — `resolve-library-id` → `query-docs` (para frameworks/bibliotecas com docs oficiais)
5. **CC memory cross-projecto** — `Grep` em `~/.claude/projects/*/memory/*.md`
6. **Supabase** — `search_memories(query, threshold=0.5, limit=5)` [graceful se indisponivel]
**Prioridade por tipo de tema:**
- Framework/biblioteca com docs oficiais (Next.js, React, Laravel...) → **KB local primeiro** + **Context7** + NLM
- Stack interna (CWP, Perfex, n8n...) → **NLM primeiro** (fonte mais densa para estes) + KB
- Conceito generico (design patterns, boas praticas...) → **NLM primeiro**
**NLM routing por tema (top 15):**
| Tema | Notebook | ID |
|------|----------|----|
| Claude Code, skills, hooks, plugins | Claude Code | `2876d1fe-5cea-4d98-8140-b0e1a81c6bc4` |
| CWP, servidor, hosting, virtualhost | CWP | `0ded7bd6-69b3-4c76-b327-452396bf7ea7` |
| WordPress, WP-CLI, temas, config | WordPress Config CLI | `fb2f26bd-8cb0-4d4c-bafc-4f1ebb51c51d` |
| Elementor, widgets, templates | WordPress e Elementor | `5be0d1a6-00f2-4cd9-b835-978cb7721601` |
| Seguranca WP, malware, hardening | Ciberseguranca WordPress | `5f60adfd-2435-4725-8c12-9c11c5f51d75` |
| Perfex/Desk CRM, modulos, hooks | Perfex CRM | `df4688bb-c2c0-4aba-98c1-38c3b50a353c` |
| n8n, automacoes, workflows | n8n | `f2c809b8-1cb5-4dd0-aa7e-be2cfb6704d1` |
| Marketing digital, SEO, ads, funil | Marketing Digital PT | `4c595973-ba10-420a-a3bf-e4389e424ad3` |
| AI agents, orquestracao, MCPs | AI Agents e Orquestracao | `bc480d68-5835-415e-82bc-4583f36b8c29` |
| Proxmox, VMs, clustering, HA | Proxmox | `276ccdde-6b95-42a3-ad96-4e64d64c8d52` |
| Design, branding, visual, automacao | Design Profissional | `b568b13b-0eed-48c9-b513-5c5b7ec0b102` |
| UI/UX, WCAG, acessibilidade | UI/UX Design | `081ca512-8279-4850-b2b9-dff090267482` |
| Gestao operacoes, KPIs, agencia | Gestao Operacoes | `f9dc59c2-718b-4b12-bd06-095d4bfa3e34` |
| Remotion, video programatico | Remotion | `f2b75baa-1ab1-48d3-8f7c-a6a9e516934c` |
| Obsidian, vault, Claude workflow | Obsidian + Claude | `ebee9fe1-78fd-4f85-8938-f19f3ea32131` |
| Programacao, padroes, api design | Programacao | `24947ffa-0019-448a-a340-2f4a275d2eb1` |
| Copywriting, persuasao, texto | Copywriting e Persuasao | `7b8fec17-d34f-4e3f-a8c6-8231e51f6323` |
| Video, producao, youtube | Producao de Video e Youtube | `058a896e-6c9a-4e51-ae7d-9adb2738bc5f` |
| WooCommerce, loja, produtos | Documentacao WooCommerce | `bd06acff-4b9d-44aa-b3f7-60434bbd6b49` |
> Inventario completo 65 notebooks: `~/.claude/projects/-media-ealmeida-Dados-Hub/memory/notebooklm-inventory.md`
**Hub KB: ficheiros locais densos (usar quando match directo):**
| Keywords | Ficheiro KB |
|----------|-------------|
| next.js, app router, server components | `Next.js 14_15 App Router Deep Dive.md` |
| php, laravel | `PHP 8+ e Laravel 11_12_ Pesquisa Profunda.md` |
| core web vitals, ga4, performance | `Core Web Vitals, GA4, Performance Web.md` |
| n8n, automacao | `Base-Conhecimento-n8n.md` |
| perfex crm, modulos | `Base-Conhecimento-Perfex-CRM.md` |
| remotion, video codigo | `Base-Conhecimento-Remotion-Video.md` |
| ui, ux, design systems | `Base-Conhecimento-UI-UX-Design-Systems.md` |
| tipografia, cor, web design | `Base-Conhecimento-Web-Design-Tipografia-Cor.md` |
| youtube, video producao | `Base-Conhecimento-Video-YouTube.md` |
| openrouter, modelos ai | `OpenRouter-Matrix-v1.1.md` |
| postfix, email security | `Postfix Email Security Best Practices.md` |
| wcag, acessibilidade | `Relatório Acessibilidade Web WCAG 2.2.md` |
| gestao, operacoes, agencia | `Gestao-Operacoes-Agencias-Marketing-Tecnologia.md` |
**Context7 para docs oficiais:** usar `resolve-library-id` → `query-docs` quando a pergunta e sobre uma biblioteca/framework com documentacao oficial actualizada (Next.js, React, Tailwind, Laravel, etc). Context7 tem docs mais frescos que NLM.
### 3. API / implementacao (endpoint, payload, autenticacao)
**Sinais:** "endpoint", "API de", "payload", "autenticacao", "integrar com"
**Fontes (sequencial — Read directo do ficheiro):**
| Keywords | Ficheiro em `Hub/06-Operacoes/Documentacao/APIs/` |
|----------|----------------------------------------------------|
| perfex, desk crm api | Perfex-CRM-API.md |
| cwp api, cwp endpoint | CWP-API.md |
| whatsms, sms api | WhatSMS-API.md + WhatSMS-Admin-API.md |
| paperclip api | Paperclip-API.md |
| dify api | Dify-API.md |
| bookstack api | BookStack-API.md |
| mcp desenvolvimento | MCP-Dev-Manual.md |
Se API nao listada → NLM notebook relevante + Context7.
### 4. Processo / procedimento (como fazemos X internamente)
**Sinais:** "procedimento", "como fazemos", "PROC", "workflow interno", "passo-a-passo"
**Fontes:**
1. `Grep` em `/media/ealmeida/Dados/Hub/06-Operacoes/Procedimentos/**/*.md` (38 PROCs)
2. `Grep` em `/media/ealmeida/Dados/Hub/06-Operacoes/Documentacao/Manuais/**/*.md`
**Departamentos PROC:**
| Tema | Pasta |
|------|-------|
| Comercial, CRM, catalogo | D1-Comercial/ |
| Suporte, tickets | D2-Suporte/ |
| Contabilidade, facturas | D3-Contabilidade/ |
| RH | D4-RH/ |
| Design | D5-Design/ |
| Marketing, conteudo | D6-Marketing/ |
| Tecnologia, MCP, Claude, infra | D7-Tecnologia/ |
| Multi-departamental | Cross-Departamental/ |
### 5. Troubleshooting (erro, problema, nao funciona)
**Sinais:** "erro", "nao funciona", "problema com", "fix para", "troubleshoot"
**Fontes (paralelo):**
1. `Grep` em `/media/ealmeida/Dados/Hub/06-Operacoes/Documentacao/Troubleshooting/*.md`
2. CC memory cross-projecto — `Grep` em `~/.claude/projects/*/memory/*.md`
3. Supabase — `search_memories(query, threshold=0.5, limit=5)` [graceful]
4. NLM notebook relevante (contexto tecnico)
### 6. Estado actual (quem, quando, quanto, aberto/fechado)
**Sinais:** nome de cliente, "#" + numero, "tarefas abertas", "horas", "facturas", "tickets"
**Fontes:** Directo ao **Desk CRM** via MCP:
- `get_tasks`, `get_projects`, `get_tickets`, `get_customers`
- `get_timesheets`, `get_invoices`, `get_estimates`
**NLM e Hub NAO entram** — nao veem estado vivo.
### 7. Decisao / historico (porque fizemos X, quando decidimos Y)
**Sinais:** "decisao", "porque fizemos", "historico de", "quando decidimos", "ultima vez que"
**Fontes (paralelo):**
1. **Supabase** — `search_memories(query, threshold=0.5, limit=8)` [graceful]
2. **CC memory cross-projecto** — `Grep` em `~/.claude/projects/*/memory/*.md`
3. **Desk CRM discussions** — `get_discussion_comments` (#31 worklogs, #32 reflexoes, #33 accoes)
4. **Git log** — `git log --oneline --grep="keyword"` nos repos relevantes
### 8. Codigo / projecto (o que mudou, como esta o repo)
**Sinais:** "changelog", "ultimo commit", "o que mudou em", "estado do repo"
**Fontes:**
1. `Read` CHANGELOG.md do projecto
2. `git log` do repo
3. CC memory do projecto especifico
---
## Classificador de pergunta (heuristica)
| Sinal | Tipo |
|-------|------|
| ID, path, porta, comando concreto | **1. Facto rapido** |
| "como funciona", "como configurar", "melhores praticas" | **2. Referencia tecnica** |
| "endpoint", "API", "payload" | **3. API** |
| "procedimento", "PROC", "como fazemos internamente" | **4. Processo** |
| "erro", "nao funciona", "problema" | **5. Troubleshooting** |
| Cliente, tarefa #N, ticket, factura, horas | **6. Estado actual** |
| "decisao", "porque", "historico", "ultima vez" | **7. Decisao/historico** |
| "changelog", "commit", "repo" | **8. Codigo** |
| **Ambiguo** | **Perguntar ao utilizador** |
---
## Formato de resposta
```markdown ```markdown
## [pergunta] ## [pergunta]
**memory-supabase:** [excerto] _(id N, tags)_ **[Fonte 1]:** [excerto] _(origem especifica)_
**memory/<projecto>:** [excerto] _(ficheiro)_ **[Fonte 2]:** [excerto] _(origem especifica)_
**Hub:** [excerto] _(caminho:linha)_
**Desk CRM:** [excerto] _(task #N, projecto #M)_
**Síntese:** [consolidação em 2-3 frases citando as fontes mais fortes] **Sintese:** [consolidacao em 2-3 frases citando as fontes mais fortes]
``` ```
**Regra:** nunca responder sem citar fonte. Se 0 fontes, dizer "sem hits em Família A" explicitamente. Origens possiveis: `QR:ficheiro`, `NLM:notebook`, `KB:ficheiro`, `API:ficheiro`, `PROC:codigo`, `Manual:ficheiro`, `Troubleshooting:ficheiro`, `memory/projecto:ficheiro`, `Supabase:id`, `Desk CRM:task #N`, `Git:commit`
--- **Regra:** nunca responder sem citar fonte. Se 0 fontes, dizer explicitamente.
## Família B — Conhecimento externo (NotebookLM)
**Quando usar:** só para perguntas **conceptuais, teóricas, de research externo ou mercado**. Nunca para operacional.
Exemplos de queries Família B:
- "Quais são as melhores práticas de Core Web Vitals em 2025?"
- "Como funciona o algoritmo de ranking do YouTube Shorts?"
- "Arquétipos de Jung aplicados a branding"
- "Stoicismo na gestão de equipas"
**Workflow Família B:**
1. Classificar tema → tabela de routing
2. Consultar **max 3 notebooks** (performance)
3. `mcp__notebooklm-mcp__notebook_query({ notebook_id, query })`
4. Se score <70 → fallback a Context7 (docs bibliotecas)
### Routing por tema (65 notebooks)
> Inventário completo: `~/.claude/projects/-media-ealmeida-Dados-Hub/memory/notebooklm-inventory.md`
**WordPress/Web**
| Keywords | Notebook | ID |
|----------|----------|----|
| wordpress, wp-cli, config | WordPress Config CLI | `fb2f26bd-8cb0-4d4c-bafc-4f1ebb51c51d` |
| elementor, templates, widgets | WordPress e Elementor | `5be0d1a6-00f2-4cd9-b835-978cb7721601` |
| woocommerce, loja, produtos | Documentacao WooCommerce | `bd06acff-4b9d-44aa-b3f7-60434bbd6b49` |
| kivicare, ehr, clinica | KiviCare EHR WP | `78621405-a5bc-433f-856f-296260a80bd9` |
| seguranca wp, malware, hardening | Ciberseguranca WordPress | `5f60adfd-2435-4725-8c12-9c11c5f51d75` |
**Marketing e Conteúdo**
| Keywords | Notebook | ID |
|----------|----------|----|
| marketing, digital, campanha, funil | Marketing Digital PT | `4c595973-ba10-420a-a3bf-e4389e424ad3` |
| marketing avancado, ads, growth | Marketing Digital Avancado | `76647e0f-3ae2-4c00-a0a8-f457aebf5655` |
| seo, keywords, ranking, serp | Marketing Digital PT | `4c595973-ba10-420a-a3bf-e4389e424ad3` |
| copywriting, persuasao, texto | Copywriting e Persuasao | `7b8fec17-d34f-4e3f-a8c6-8231e51f6323` |
| social media, branding, instagram | Social Media e Branding | `9053d0e8-dd39-460b-b5ea-e67af3e9a675` |
| video, producao, youtube | Producao de Video e Youtube | `058a896e-6c9a-4e51-ae7d-9adb2738bc5f` |
| youtube, monetizacao, compliance | YouTube Monetizacao e Compliance | `60a209a7-e205-4d57-a6f3-fef3de61e87a` |
| podcast, audio | Podcast Descomplicar | `a5bef96b-a1af-4293-9979-5da46f8d2301` |
| ecommerce, loja online | E-commerce Pratico | `226e384e-d4bc-48f4-bb82-7927360436cc` |
| ecommerce portugal, marketplace | E-Commerce Portugal | `8a430cf2-ed99-413d-b4bf-a1400deaf49e` |
**Desenvolvimento / Código (externo)**
| Keywords | Notebook | ID |
|----------|----------|----|
| programacao externa, padroes, api design | Programacao | `24947ffa-0019-448a-a340-2f4a275d2eb1` |
| claude code, mcp dev externo | Claude Code | `2876d1fe-5cea-4d98-8140-b0e1a81c6bc4` |
| mcp protocolo | Desenvolvimento de MCPs | `73102308-70ef-403e-9be9-eae0cfc62d55` |
| ai editor, cursor, copilot | AI Code Editors | `57d9c6c9-48ba-4d83-8f71-cc890f348a53` |
| github trends | GitHub Trends | `922b7532-ddf3-4dba-9d3c-6d5f83b89378` |
| open source, foss | Open Source Software and Platforms | `cabf9821-c1ff-44cb-9bfd-59bda3599792` |
| n8n, workflow automacao | n8n | `f2c809b8-1cb5-4dd0-aa7e-be2cfb6704d1` |
| perfex dev, hooks externos | Dev PerfexCRM | `80606de8-2783-4d36-b08d-5825e6f9a8da` |
| remotion, video code | Remotion | `f2b75baa-1ab1-48d3-8f7c-a6a9e516934c` |
> **Nota:** código do projecto (`/Dev/*`, plugins locais, MCPs desenvolvidos internamente) é **Família A** (grep Hub + filesystem), não Família B.
**Infraestrutura**
| Keywords | Notebook | ID |
|----------|----------|----|
| cwp externo | CWP | `0ded7bd6-69b3-4c76-b327-452396bf7ea7` |
| cloud, devops patterns | Cloud e Infraestrutura TI | `f9a79b5a-649f-4443-afaf-7ff562b6c2e7` |
| proxmox | Proxmox | `276ccdde-6b95-42a3-ad96-4e64d64c8d52` |
**Design/UX**
| Keywords | Notebook | ID |
|----------|----------|----|
| design, branding externo | Design Profissional AItomatizado | `b568b13b-0eed-48c9-b513-5c5b7ec0b102` |
| ui, ux, wcag | UI/UX Design | `081ca512-8279-4850-b2b9-dff090267482` |
| tipografia, cores | Tipografia e Cor para Web | `f97a0d2b-a5b3-4640-b941-3cbb184b1b81` |
**Gestão e Estratégia**
| Keywords | Notebook | ID |
|----------|----------|----|
| gestao projectos, agile, scrum | Gestao de Projectos e Agile | `0c9c079c-a426-486c-99eb-1564d42d37ad` |
| operacoes externas, kpi | Gestao de Operacoes | `f9dc59c2-718b-4b12-bd06-095d4bfa3e34` |
| estrategia, empreendedorismo | Estrategia e Empreendedorismo | `79d43410-0e29-4be1-881d-84db6bdc239a` |
| transformacao digital, ia negocio | Transformacao Digital e IA | `ab876d0d-12a8-43d9-bc62-59c1c8e9d0f8` |
| ai automation stack | AI Automation Stack | `929ef67b-c131-4f01-abd0-8b078491a6b7` |
| ai agents curso | AI Agents Intensive Course | `f4be0e3f-4d9e-4c5c-a743-9f14427f2e43` |
**Produtos externos / Mercado**
| Keywords | Notebook | ID |
|----------|----------|----|
| zaia, chatbot | Zaia | `087d76f1-e929-49da-9e3c-4edc22b42b3f` |
| zender, whatsapp api | Zender 3 | `7095e5fa-1465-4496-b1a3-48f2e6e07f79` |
| solar, fotovoltaico | Solar FV Engenharia | `03d54e00-aefa-45dc-ba01-f3864a7c3112` |
| opensolar | OpenSolar | `0082bcaf-1e17-4b84-87cc-2256b1719b55` |
**Pessoal / SelfRescueProtocol** (só se explicitamente pessoal)
| Keywords | Notebook | ID |
|----------|----------|----|
| jung, arquetipos | Jung | `d5c67d7f-7fe8-4542-9e5c-22403f3193ee` |
| taoismo, wu wei | Taoism | `aea85baf-9ddf-4d79-bf07-81391a275b09` |
| adhd, phda | ADHD | `a4ff3fd7-fb7c-49a1-94ff-0433193e2338` |
| autismo | Autismo | `66eff78e-318f-4a8b-a3c7-039a4124b1ad` |
| heroi, jornada | Essencia de Heroi | `6dcd08e8-79d9-4ae0-b6bf-b2ee96717bf2` |
| kintsugi | Auto Kintsugi | `82a95c2f-be56-4c4a-a96f-96f6677a6991` |
| somatica, trauma | Psicologia Somatica | `3410893b-16a3-4178-9091-42650a41086f` |
| estoicismo | Marcus Aurelius / Stoic | `4b986ad4-49da-4604-a423-4fcdf20dd9da` |
---
## Classificador de pergunta (heurística)
Usar estes sinais para decidir Família A vs B:
| Sinal na pergunta | Família |
|---|---|
| Nome de cliente, projecto, tarefa #N, ticket #N | **A** |
| "quando", "histórico", "última vez", "decisão", "porque fizemos" | **A** |
| Nome de ficheiro, path, skill, plugin, MCP interno | **A** |
| "como funciona (abstracto)", "melhores práticas", "teoria de" | **B** |
| Nome de biblioteca externa + versão | **B** (+ Context7) |
| Pessoal explícito (jung, adhd, estoicismo, …) | **B** pessoal |
| Ambíguo | **perguntar** |
--- ---
@@ -190,69 +227,69 @@ Usar estes sinais para decidir Família A vs B:
| Comando | Uso | | Comando | Uso |
|---------|-----| |---------|-----|
| `/knowledge [pergunta]` | Router automático A/B com paralelismo | | `/knowledge [pergunta]` | Router automatico por tipo |
| `/kb [pergunta]` | Alias curto | | `/kb [pergunta]` | Alias curto |
| `/kb-save [conteúdo]` | Guardar na fonte adequada (Supabase se decisão/solução, Hub se processual, NotebookLM source_add se externo) | | `/kb-save [conteudo]` | Guardar na fonte adequada (ver abaixo) |
| `/kb-gaps` | Listar lacunas detectadas em `memory-supabase` | | `/kb-gaps` | Listar lacunas detectadas em Supabase |
--- ---
## Gravar conhecimento (/kb-save) ## Gravar conhecimento (/kb-save)
Router inverso por tipo:
| Tipo | Destino | Tool | | Tipo | Destino | Tool |
|---|---|---| |------|---------|------|
| Decisão / contexto / solução técnica | memory-supabase | `mcp__memory-supabase__save_memory` com tags | | Decisao / solucao tecnica / workaround | Supabase | `save_memory` com tags `[tipo, dominio, projecto?, data]` |
| Procedimento operacional | Hub/06-Operacoes/Procedimentos/ | `Write` PROC-*.md | | Feedback / regra estavel | CC memory | `Write` em `~/.claude/projects/*/memory/` |
| Conhecimento externo | NotebookLM notebook adequado | `mcp__notebooklm-mcp__source_add` | | Procedimento operacional | Hub PROCs | `Write` PROC-*.md |
| Referencia rapida (ID, path) | Hub QR | `Edit` QR-*.md |
| Conhecimento externo | NotebookLM | `source_add` no notebook adequado |
--- ---
## Detecção e reporte de lacunas ## Deteccao de lacunas
Quando query retorna 0 hits úteis em Família A (o caso relevante) ou <30% score em Família B: Quando 0 hits uteis em todas as fontes consultadas para o tipo:
```javascript ```javascript
mcp__memory-supabase__save_memory({ mcp__memory-supabase__save_memory({
content: `LACUNA: "${query}" — Família A 0 hits, classificada como ${classificacao}.`, content: `LACUNA: "${query}" — tipo ${tipo}, 0 hits`,
tags: ["lacuna-kb", classificacao], tags: ["lacuna-kb", tipo, dominio]
metadata: { query, timestamp, source_families: ["A","B"] }
}); });
``` ```
Depois sugerir acção: criar PROC, guardar no Supabase, adicionar fonte ao notebook NotebookLM adequado. Sugerir accao: criar PROC, actualizar QR, adicionar fonte a NLM, guardar em Supabase.
--- ---
## Regras operacionais ## Regras operacionais
1. **Família A é default.** Só escalar para B quando classificador sinalizar externo. 1. **Classificar primeiro, consultar depois.** Nao despejar todas as fontes para todas as perguntas.
2. **Paralelismo obrigatório em Família A.** Todas as tools na mesma mensagem (regra global #1: "NEVER run independent tool calls sequentially"). 2. **Paralelismo obrigatorio** dentro de cada tipo quando ha multiplas fontes.
3. **Grep cross-projecto obrigatório** em `~/.claude/projects/*/memory/*.md` — o harness só carrega a memória do `cwd`, este grep compensa esse gap. 3. **Grep cross-projecto obrigatorio** para tipos 2, 5, 7 — `~/.claude/projects/*/memory/*.md`.
4. **Nunca responder sem citar fonte.** Se 0 hits, dizer explicitamente. 4. **Nunca responder sem citar fonte.**
5. **Max 3 notebooks** por query Família B. 5. **Max 2 notebooks NLM** por query (performance).
6. **PT-PT sempre** na consolidação. 6. **Supabase sempre graceful** — se indisponivel ou 0 resultados, continuar com outras fontes.
7. **Se a pergunta é sobre estado presente** (tarefas abertas, tickets, horas, facturas), ir **directo ao Desk CRM**, não a NotebookLM. 7. **Estado presente = Desk CRM directo** — nunca NLM/Hub para tarefas/facturas/tickets.
8. **PT-PT sempre.**
--- ---
## Anti-patterns ## Anti-patterns
- ❌ Começar por NotebookLM para perguntas operacionais (era o erro da v2.0.0) - Consultar NLM para "quantas tarefas abertas tem o projecto X" (estado vivo → Desk CRM)
- ❌ Só consultar o `cwd` e ignorar memory cross-projecto - Fazer grep generico em `Hub/**/*.md` quando a pergunta e claramente sobre um QR especifico
- ❌ Responder sem citar fonte - Consultar Supabase como unica fonte (usar como complemento, nao alicerce)
- ❌ Chamar Família A em série — tem de ser paralelo - Classificar "como funciona o nosso router /knowledge" como referencia externa (e interno → CC memory + Hub)
- ❌ Classificar "como funciona o nosso router /knowledge?" como Família B (é Família A — é sobre infra interna) - Ignorar CC memory cross-projecto (harness so carrega cwd)
- ❌ Fallback linear A→B quando a pergunta é claramente externa (vai directo a B) - Disparar 5 fontes para um facto rapido que esta num QR (sequencial, parar ao hit)
--- ---
## Referências ## Referencias
- `references/routing-guide.md` — mapeamento detalhado de routing (pendente v2.1 — actualizar) - `~/.claude/plans/atomic-fluttering-flame.md` — plano RAG-System completo
- `~/.claude/projects/-media-ealmeida-Dados-Hub/memory/feedback_knowledge-router-arquitectura.md` — decisão arquitectural - `~/.claude/projects/-media-ealmeida-Dados-Hub/memory/feedback_knowledge-router-arquitectura.md` — decisao arquitectural
- `~/.claude/projects/-media-ealmeida-Dados-Hub/memory/notebooklm-inventory.md` — inventário completo 65 notebooks - `~/.claude/projects/-media-ealmeida-Dados-Hub/memory/notebooklm-inventory.md` — inventario 65 notebooks NLM
--- ---
@@ -260,12 +297,14 @@ Depois sugerir acção: criar PROC, guardar no Supabase, adicionar fonte ao note
```jsonl ```jsonl
{"date":"2026-04-08","issue":"v2.0.0 tratava NotebookLM como fonte primaria para tudo","fix":"v2.1.0 router Familia A/B — NotebookLM so para externo","source":"user"} {"date":"2026-04-08","issue":"v2.0.0 tratava NotebookLM como fonte primaria para tudo","fix":"v2.1.0 router Familia A/B — NotebookLM so para externo","source":"user"}
{"date":"2026-04-08","issue":"v2.1.0 assumia FastMCP file-based (11 tools lightrag_*) apos migracao temporaria da outra sessao","fix":"v2.1.1 restaurado para LightRAG-HKU completo com 17 tools originais (query_document, insert_document, get_pipeline_status, etc), UI em rag.descomplicar.pt, PG storage 331 docs","source":"user"} {"date":"2026-04-08","issue":"v2.1.0 assumia FastMCP file-based (11 tools lightrag_*)","fix":"v2.1.1 restaurado LightRAG-HKU 17 tools","source":"user"}
{"date":"2026-04-13","issue":"LightRAG com 0 documentos — servico sem utilidade a consumir recursos","fix":"v2.2.0 removido LightRAG da Familia A — 4 fontes restantes: Supabase, CC memory, Hub, Desk CRM","source":"user"} {"date":"2026-04-13","issue":"LightRAG com 0 docs, servico sem utilidade","fix":"v2.2.0 removido LightRAG da Familia A","source":"user"}
{"date":"2026-04-08","issue":"memoria Claude Code fragmentada em ~/.claude/projects/*/memory/ (101 ficheiros, 34 projectos)","fix":"grep cross-projecto obrigatorio no router Familia A","source":"user"} {"date":"2026-04-08","issue":"memoria CC fragmentada por projecto","fix":"grep cross-projecto obrigatorio","source":"user"}
{"date":"2026-04-08","issue":"mcp__memory-supabase__search_memories pode estar indisponivel no harness","fix":"graceful fallback no router — continuar paralelismo com outras fontes e reportar lacuna","source":"auto"} {"date":"2026-04-13","issue":"Supabase degradado (stats/paginacao/embeddings raw)","fix":"MCP reparado — stats, paginacao e sanitize embeddings corrigidos. 6 registos com credentials eliminados","source":"fase-2"}
{"date":"2026-04-13","issue":"v2.2.0 modelo A/B subestimava Hub e NLM para queries operacionais","fix":"v3.0.0 router por tipo (8 rotas), Hub granular (QR/KB/APIs/Manuais/PROCs/Troubleshooting), NLM referencia tecnica primaria, Supabase complementar","source":"plano RAG-System"}
{"date":"2026-04-13","issue":"v3.0.0 nao tinha routing para frameworks (Next.js foi ao notebook errado), KB local subutilizado","fix":"v3.1.0 prioridade por tipo de tema (KB local > Context7 > NLM para frameworks), 13 ficheiros KB mapeados, 4 notebooks NLM adicionados, Context7 como fonte para docs oficiais","source":"testes fase 5"}
``` ```
--- ---
**v2.2.0** | 13-04-2026 | LightRAG removido (0 docs, serviço desactivado). Família A: 4 fontes — Supabase, CC memory, Hub, Desk CRM **v3.1.0** | 13-04-2026 | KB local mapeado (13 ficheiros), Context7 para docs oficiais, prioridade por tipo de tema, 19 notebooks NLM
gestao/skills/onboarding/SKILL.md
+4 -2
View File
@@ -9,15 +9,17 @@ tools: [mcp__desk-crm-v3__create_task, mcp__desk-crm-v3__add_task_checklist_item
# Skill: /onboarding # Skill: /onboarding
Checklist e automacao de onboarding de novo colaborador. Baseado em PROC-Onboarding.md (RH-001). Checklist e automacao de onboarding de novo colaborador. Baseado em PROC-D4-RH-001-Onboarding-Colaborador.md.
--- ---
## Referencia ## Referencia
Procedimento completo em: `Hub/06-Operacoes/Procedimentos/D4-RH/PROC-Onboarding.md` Procedimento completo em: `Hub/06-Operacoes/Procedimentos/D4-RH/PROC-D4-RH-001-Onboarding-Colaborador.md`
Esta skill executa os passos — o PROC define as regras. Esta skill executa os passos — o PROC define as regras.
**Agent associado:** `hr-specialist` (criado 08-04-2026) — executor autónomo para onboarding completo, gestão de contratos e férias.
--- ---
## Processo ## Processo
gestao/skills/reflect/SKILL.md
-1
View File
@@ -1,7 +1,6 @@
--- ---
name: reflect name: reflect
description: Alias de /worklog. Auto-reflexão e registo de trabalho unificado. /reflect = /worklog (mesmo resultado). /reflect view = ver últimos registos. /reflect deep = análise profunda com histórico → Discussão #32. /reflect week = revisão semanal → Discussão #32. Usar quando "reflect", "reflexão", "análise", "melhoria", "insight". description: Alias de /worklog. Auto-reflexão e registo de trabalho unificado. /reflect = /worklog (mesmo resultado). /reflect view = ver últimos registos. /reflect deep = análise profunda com histórico → Discussão #32. /reflect week = revisão semanal → Discussão #32. Usar quando "reflect", "reflexão", "análise", "melhoria", "insight".
context: fork
--- ---
# /reflect - Alias de /worklog # /reflect - Alias de /worklog
gestao/skills/today/SKILL.md
+17 -2
View File
@@ -8,8 +8,6 @@ context: fork
Le resultados dos agentes cron locais (desktop, crontab ealmeida) + invoca skills interactivas. Nao duplica trabalho automatizado. Le resultados dos agentes cron locais (desktop, crontab ealmeida) + invoca skills interactivas. Nao duplica trabalho automatizado.
> **Nota migração (20-04-2026):** CT 102 eliminado. Todos os agentes migrados para crontab local em `/media/ealmeida/Dados/Dev/claude_automations_dev/`. SSH "dev" descontinuado.
--- ---
## Arquitectura ## Arquitectura
@@ -93,6 +91,12 @@ CRON (desktop local, crontab ealmeida) /today (interactivo, sob pedido)
- Erros ou falhas nos logs - Erros ou falhas nos logs
- HEARTBEAT WP >26h sem post novo em cat 1188 - HEARTBEAT WP >26h sem post novo em cat 1188
-> Adicionar a seccao "Requer Atencao Urgente" -> Adicionar a seccao "Requer Atencao Urgente"
4b. VERIFICAR FORNECEDORES AUTO-CRIADOS:
Ler ~/.claude-work/fornecedores-iva.json
Filtrar entradas com "auto_proposto": true
Para cada entrada extrair: nome, dominio (chave), politica, confianca, despesas_count
-> Se existirem: adicionar secção "Fornecedores Auto-Criados" no dashboard (ver formato abaixo)
``` ```
### Fase 2: Recolha de dados frescos (silencioso) ### Fase 2: Recolha de dados frescos (silencioso)
@@ -169,6 +173,17 @@ CRON (desktop local, crontab ealmeida) /today (interactivo, sob pedido)
--- ---
## Fornecedores Auto-Criados (pendente validação)
[Omitir secção se nenhum fornecedor tem auto_proposto=true]
| Fornecedor | Domínio | Política | Confiança | Despesas | Acção |
|------------|---------|----------|-----------|----------|-------|
| [nome] | [dominio] | [politica] | [confianca] | [despesas_count]/3 | [— se alta, "rever" se baixa] |
Nota: Promovidos automaticamente após 3 despesas. Confiança "baixa" = fallback EXTRA_UE aplicado — rever manualmente.
---
## 3 Prioridades Hoje ## 3 Prioridades Hoje
1. [ ] [Mais urgente] 1. [ ] [Mais urgente]
2. [ ] [Segunda] 2. [ ] [Segunda]
gestao/skills/today/prompts/execute.md
+77 -23
View File
@@ -1,38 +1,92 @@
# /today - Checkup Diario (Orquestrador) # /today v11.0 - Checkup Diario (Orquestrador)
Executa o checkup diario invocando sub-skills em sequencia. Executa o checkup diario lendo logs locais dos agentes + recolhe dados frescos.
> NOTA CRITICA: CT 102 abatido em 20-04-2026. Os agentes cron correm como systemd user timers
> no desktop. NUNCA usar ssh_execute(server="dev"). Ler logs locais via tail/journalctl.
## Passo 1: Verificar data e ultima execucao ## Passo 1: Verificar data e ultima execucao
``` ```
mcp__mcp-time__current_time mcp__mcp-time__current_time → data, dia da semana
mcp__memory-supabase__search_memories("today checkup YYYY-MM-DD") mcp__memory-supabase__search_memories("today checkup YYYY-MM-DD")
Se ja existe → perguntar se quer re-executar Se ja existe hoje → perguntar se quer re-executar
``` ```
## Passo 2: Fase 1 - Auto-processamento (silencioso) ## Passo 2: Fase 1 - Ler logs locais dos agentes (silencioso)
Invocar em sequencia: Base: /media/ealmeida/Dados/Dev/claude_automations_dev/
1. `/ticket-triage` → processa tickets abertos
2. `/imap-triage` → processa emails IMAP
3. `/auto-expense` → cria despesas dos resultados anteriores
4. `/cleanup-downloads` → se >10 ficheiros em Transferencias
## Passo 3: Fase 2 - Recolha de dados (silencioso) ```bash
# IMAP Triage
tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/imap-triage/imap-triage.log
cat ~/.claude-work/today-imap-$(date +%d-%m-%Y).json 2>/dev/null
Invocar: # Ticket Triage
1. `/daily-digest` → metricas do dia tail -30 /media/ealmeida/Dados/Dev/claude_automations_dev/ticket-triage/ticket-triage.log 2>/dev/null
2. `/tasks-overview` → tarefas e workflows
## Passo 4: Rotinas especiais # Auto-Expense
tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/auto-expense/auto-expense.log 2>/dev/null
- Segunda: planeamento semanal + `/wp-update` # Infra Check
- Sexta: sugerir manutencao WordPress tail -30 /media/ealmeida/Dados/Dev/claude_automations_dev/infra-check/infra-check.log 2>/dev/null
- Sabado/Domingo: `/infra-check`
## Passo 5: Dashboard final # AikTop Tasks
tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/aiktop-tasks/aiktop-tasks.log 2>/dev/null
Agregar resultados de todas as sub-skills. # WP Update (apenas se segunda-feira)
Criar nota Obsidian em `00-Inbox/DD-MM-YYYY-checkup.md`. tail -50 /media/ealmeida/Dados/Dev/claude_automations_dev/wp-update/wp-update.log 2>/dev/null
Guardar em Supabase.
Limpar temporarios `~/.claude-work/today-*.json`. # Intelligence pipeline (status)
tail -15 /media/ealmeida/Dados/Dev/claude_automations_dev/daily-selector/daily-selector.log 2>/dev/null
tail -10 /media/ealmeida/Dados/Dev/claude_automations_dev/intelligence-publisher/intelligence-publisher.log 2>/dev/null
```
Verificar estado systemd para confirmar ultima execucao:
```bash
journalctl --user -u imap-triage.service -u ticket-triage.service -u auto-expense.service \
-u infra-check.service -u aiktop-tasks.service --since "8 hours ago" \
--no-pager -n 5 --output=short-precise
```
Para cada agente: verificar se correu nas ultimas 8h (infra: 24h), detectar erros.
Adicionar alertas criticos a "Requer Atencao Urgente".
## Passo 3: Fase 2 - Recolha de dados frescos (silencioso)
Invocar em paralelo:
1. `/daily-digest` → timer, tickets, facturas, leads, propostas, agenda
2. `/tasks-overview` → tarefas overdue/pendentes/em curso + workflows sugeridos
Verificar `~/Transferencias` — se >10 ficheiros, invocar `/cleanup-downloads`.
## Passo 4: Fase 2b - Specs e Sprints activos (silencioso)
```bash
find /media/ealmeida/Dados/Dev -name "SPEC.md" -maxdepth 4 2>/dev/null
find /media/ealmeida/Dados/Dev -name "SPRINT.md" -maxdepth 4 2>/dev/null
```
Para cada encontrado: ler frontmatter (primeiras 15 linhas), filtrar status != "completed"/"archived".
Extrair: titulo, status, progresso done/total.
## Passo 5: Rotinas especiais por dia
- Segunda: planeamento semanal (tarefas + capacidade)
- Sexta: sugerir manutencao semanal
## Passo 6: Dashboard final + guardar
Agregar todos os resultados e mostrar dashboard (formato no SKILL.md).
Criar nota Obsidian:
- Path: `/media/ealmeida/Dados/Hub/00-Inbox/DD-MM-YYYY-checkup.md` (formato DD-MM-YYYY)
- Frontmatter: title, date, type: checkup, status: active
Guardar em Supabase:
```
mcp__memory-supabase__save_memory({
content: "Checkup diario DD-MM-YYYY - X tickets, Y tarefas, cron OK/FALHA",
tags: ["today", "checkup", "DD-MM-YYYY"]
})
```
infraestrutura/skills/backup-strategies/SKILL.md
+6 -4
View File
@@ -50,10 +50,12 @@ RTO (Recovery Time Objective)
- **2** tipos de media diferentes (disco local + cloud) - **2** tipos de media diferentes (disco local + cloud)
- **1** copia offsite (protege contra desastres locais) - **1** copia offsite (protege contra desastres locais)
**Implementacao Descomplicar:** **Implementacao Descomplicar (estado real — fonte de verdade: `Hub/05-Projectos/SistemaBackups/`):**
1. **Producao:** Servidor CWP (176.9.3.158) 1. **Producao:** Servidor CWP (VM 100) + EasyPanel (VM 101) no cluster Proxmox
2. **Backup local:** NAS Synology ou disco externo 2. **Backup:** Proxmox vzdump → PBS (6TB) + MySQL hourly + rsync servidores → cluster
3. **Backup offsite:** Google Drive + S3 (Wasabi) 3. **Offsite:** **pendente** (regra 3-2-1 em 2-1-0; decisao Hetzner Storage Box / Backblaze B2 / Wasabi). Insync/rclone→GDrive estao mortos — nao assumir como activos.
> Esta skill cobre conceitos genericos (RPO/RTO, GFS, 3-2-1). Para o estado e topologia reais do sistema Descomplicar, consultar sempre `Hub/05-Projectos/SistemaBackups/AUDITORIA-Backups-2026-06-08.md`.
--- ---
infraestrutura/skills/cwp/SKILL.md
+20
View File
@@ -9,6 +9,26 @@ Skill unificada para o servidor **CWP Principal `176.9.3.158`** (MCP `ssh-unifie
**REGRA #38 — ZERO INVENÇÃO:** NUNCA improvisar comandos. Verificar estado actual ANTES de alterar. Pesquisar wiki CWP se necessário. Usar APENAS scripts oficiais (`/scripts/*` e `/scripts/cwp_api`). Se não souber: PERGUNTAR. **REGRA #38 — ZERO INVENÇÃO:** NUNCA improvisar comandos. Verificar estado actual ANTES de alterar. Pesquisar wiki CWP se necessário. Usar APENAS scripts oficiais (`/scripts/*` e `/scripts/cwp_api`). Se não souber: PERGUNTAR.
---
## 0. GATE OBRIGATÓRIO — checklist pré-intervenção CWP
> **Antes de QUALQUER alteração em CWP (SSL, email/Postfix/Dovecot, nginx/Apache, CSF, PHP), correr este checklist. Padrão recorrente de edições manuais desnecessárias = causa de incidentes repetidos (#3992).**
1. **CONSULTAR PRIMEIRO** (Regra 53 — LLM Wiki obrigatório):
- `PROC-CWP-SSL.md` (D7 Infraestrutura) — para SSL/certificados.
- `PROC-Email-Antispam-CWP.md` (D7 Infraestrutura) — para email/Postfix/DKIM/antispam.
- NotebookLM CWP `0ded7bd6-69b3-4c76-b327-452396bf7ea7` + `~/wiki/` se o caso não estiver nos PROCs.
2. **VERIFICAR ESTADO ACTUAL** (read-only) antes de tocar — ver secção relevante abaixo (ex.: `openssl s_client` para SSL, `postqueue -p` para email).
3. **SCRIPT NATIVO, NUNCA EDIÇÃO MANUAL.** Se existe `/scripts/*` para a tarefa, usar esse. Editar Postfix/Dovecot/vhosts/certs à mão é anti-pattern (sobrescrito em updates + causa-raiz de drift).
- **SSL de email partido → `sh /scripts/mail_rebuild_sni_certs`** (NÃO editar `main.cf`/`master.cf` manualmente).
- Certs web → acme.sh nativo (§6). Webservers → `cwp_api webservers rebuild_*` (§7). Permissões pós-SSH → `cwp_api account fix_perms` (§1).
4. **EMAIL EM PRODUÇÃO = ZERO RISCO:** não mexer em `master.cf`/postscreen nem reiniciar Postfix sem necessidade comprovada. Mudança mínima, testada, reversível.
5. **HDD 4TB — sem comandos cegos:** NUNCA `du`/`find` genéricos em `/home` (bloqueia horas, iowait >30%). Caminhos específicos sempre.
6. **VALIDAR + DOCUMENTAR:** confirmar o efeito (secção "Validação" relevante) e registar o que se descobriu (memória/PROC) se for novo.
> Se os passos 1-3 não resolvem e seria preciso editar à mão: **PARAR e perguntar**. A edição manual é o último recurso, não o primeiro.
## Documentação base ## Documentação base
- Wiki: https://wiki.centos-webpanel.com/cwp-admin-api , /cwp-scripts , /csf-firewall-command-line - Wiki: https://wiki.centos-webpanel.com/cwp-admin-api , /cwp-scripts , /csf-firewall-command-line
project-manager/.claude-plugin/plugin.json
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "project-manager", "name": "project-manager",
"description": "Spec-driven project management with flexible sprints, scope validation, and NotebookLM-powered discovery. Prevents wasted work by forcing alignment before coding. 6 skills, 2 agents, 1 hook.", "description": "Spec-driven project management with flexible sprints, scope validation, and NotebookLM-powered discovery. Prevents wasted work by forcing alignment before coding. 7 skills, 2 agents, 1 hook.",
"version": "1.1.0", "version": "1.1.0",
"author": { "author": {
"name": "Descomplicar - Crescimento Digital", "name": "Descomplicar - Crescimento Digital",
wordpress/skills/wp-cli/references/commands.md
+1 -1
View File
@@ -311,7 +311,7 @@ find /home/USER/public_html -name "*.php" -newer /home/USER/public_html/wp-confi
```bash ```bash
#!/bin/bash #!/bin/bash
PATH_WP="/home/USER/public_html" PATH_WP="/home/USER/public_html"
BACKUP_DIR="/media/ealmeida/Dados/GDrive/Backups/WP" BACKUP_DIR="/media/ealmeida/Externo/LocalBackups/WP"
DATE=$(date +%Y%m%d_%H%M) DATE=$(date +%Y%m%d_%H%M)
SITE=$(basename $(dirname $PATH_WP)) SITE=$(basename $(dirname $PATH_WP))