claude-plugins/gestao/skills/knowledge/SKILL.md

---
name: knowledge
description: Gestao unificada de conhecimento com routing por tema para 58 notebooks NotebookLM, Supabase, Context7 e documentacao local. Detecta lacunas e sugere criacao de conteudo. v2.0.0
---

# /knowledge - Gestao Unificada de Conhecimento v2.0.0

Pesquisa inteligente com routing automatico entre todas as fontes de conhecimento.
NotebookLM e a fonte primaria (substituiu Dify KB em 06-03-2026).

## Arquitectura

```
Pergunta -> Classificar Tema -> Seleccionar Notebooks -> Query NotebookLM -> Enriquecer (Supabase/Context7/Local) -> Resultado
                                                                                    |
                                                                              Detecta Lacunas -> Sugere Criacao
```

| Fonte | MCP | Tipo de Conhecimento |
|-------|-----|---------------------|
| **NotebookLM** | notebooklm | RAG Gemini 2.5, 58 notebooks tematicos (primario) |
| **Supabase** | memory-supabase | Memoria sessoes, decisoes, contexto |
| **Context7** | context7 | Docs bibliotecas externas |
| **Docs Locais** | filesystem | Ficheiros Hub, GDrive, Dev |

---

## Comandos

| Comando | Uso |
|---------|-----|
| `/knowledge [termo]` | Pesquisa inteligente com routing |
| `/kb [termo]` | Alias curto |
| `/kb-save [tema]` | Guardar conhecimento na fonte adequada |
| `/kb-gaps` | Listar lacunas identificadas |

---

## Routing por Tema -> Notebooks NotebookLM

### WordPress e 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` |

**Fallback:** Context7 (docs oficiais plugins) -> Docs Locais (`/Dev/*/wp-content/`)

### Marketing e Conteudo

| 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` |

**Fallback:** Supabase (decisoes marketing) -> Docs Locais (Hub/)

### Desenvolvimento e Codigo

| Keywords | Notebook | ID |
|----------|----------|----|
| programacao, codigo, api, php, react, node | Programacao | `24947ffa-0019-448a-a340-2f4a275d2eb1` |
| claude code, claude, mcp dev | Claude Code | `2876d1fe-5cea-4d98-8140-b0e1a81c6bc4` |
| claude code mini, snippets | Claude Code (mini) | `0be6f45b-8fd5-4a5e-8f80-e36a6f516ded` |
| mcp, mcp server, protocolo | Desenvolvimento de MCPs | `73102308-70ef-403e-9be9-eae0cfc62d55` |
| ai editor, cursor, copilot | AI Code Editors | `57d9c6c9-48ba-4d83-8f71-cc890f348a53` |
| github, trends, repos | GitHub Trends | `922b7532-ddf3-4dba-9d3c-6d5f83b89378` |
| open source, foss, self-hosted | Open Source Software and Platforms | `cabf9821-c1ff-44cb-9bfd-59bda3599792` |
| open webui, ollama | Open WebUI | `be6f72ac-f8ba-4337-912d-abd5dd448519` |
| remotion, video code | Remotion | `f2b75baa-1ab1-48d3-8f7c-a6a9e516934c` |
| perfex, perfexcrm, modulos | Perfex CRM: Gestao de Clientes e Projetos | `df4688bb-c2c0-4aba-98c1-38c3b50a353c` |
| perfex dev, hooks perfex | Dev PerfexCRM | `80606de8-2783-4d36-b08d-5825e6f9a8da` |
| erxes, xos | Erxes XOS | `10ea7de8-5777-4f18-bd2c-f58952b6047c` |
| n8n, automacao, workflow | n8n | `f2c809b8-1cb5-4dd0-aa7e-be2cfb6704d1` |

**Fallback:** Context7 (docs bibliotecas) -> Docs Locais (`/Dev/`)

### Infraestrutura e Servidores

| Keywords | Notebook | ID |
|----------|----------|----|
| cwp, centos, servidor web | CWP | `0ded7bd6-69b3-4c76-b327-452396bf7ea7` |
| cloud, infraestrutura, devops | Cloud e Infraestrutura TI | `f9a79b5a-649f-4443-afaf-7ff562b6c2e7` |
| proxmox, virtualizacao, vm | Proxmox | `276ccdde-6b95-42a3-ad96-4e64d64c8d52` |

**Fallback:** Supabase (configs anteriores) -> Docs Locais (Hub/06-Operacoes/)

### Design e UX

| Keywords | Notebook | ID |
|----------|----------|----|
| design, branding visual, ai design | Design Profissional AItomatizado | `b568b13b-0eed-48c9-b513-5c5b7ec0b102` |
| ui, ux, interface, usabilidade | UI/UX Design | `081ca512-8279-4850-b2b9-dff090267482` |
| tipografia, cores, web design | Tipografia e Cor para Web | `f97a0d2b-a5b3-4640-b941-3cbb184b1b81` |

### Gestao e Estrategia

| Keywords | Notebook | ID |
|----------|----------|----|
| gestao projectos, agile, scrum | Gestao de Projectos e Agile | `0c9c079c-a426-486c-99eb-1564d42d37ad` |
| operacoes, processos, kpi | Gestao de Operacoes | `f9dc59c2-718b-4b12-bd06-095d4bfa3e34` |
| estrategia, empreendedorismo, negocio | 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 | AI Automation Stack | `929ef67b-c131-4f01-abd0-8b078491a6b7` |
| ai agents, curso ai | AI Agents Intensive Course | `f4be0e3f-4d9e-4c5c-a743-9f14427f2e43` |

**Fallback:** Supabase (decisoes) -> Docs Locais (Hub/01-Planeamento/)

### Produtos e Clientes

| Keywords | Notebook | ID |
|----------|----------|----|
| zaia, chatbot, whatsapp bot | Zaia | `087d76f1-e929-49da-9e3c-4edc22b42b3f` |
| zender, sms, whatsapp api | Zender 3 | `7095e5fa-1465-4496-b1a3-48f2e6e07f79` |
| reonic, solar crm | Reonic | `b7e61158-0717-4582-8ef2-0301be3c73ae` |
| carstuff, automovel | CarStuff | `90f0bc77-b5e4-4ddd-a07c-013a1a30b247` |
| solar, fotovoltaico, engenharia | Solar FV Engenharia | `03d54e00-aefa-45dc-ba01-f3864a7c3112` |
| opensolar, dimensionamento | OpenSolar | `0082bcaf-1e17-4b84-87cc-2256b1719b55` |
| produtos, servicos, tabela precos | Produtos e Servicos: BD | `c451d7b4-79fd-4a67-9149-1da38d28345e` |
| descomplicar marketing | Descomplicar: Marketing Digital | `f29c8457-f16d-4fb3-979d-6e5901de1b20` |

### Sistema e Produtividade

| Keywords | Notebook | ID |
|----------|----------|----|
| obsidian, vault, notas | Obsidian + Claude | `ebee9fe1-78fd-4f85-8938-f19f3ea32131` |
| viral, filosofia, youtube channel | Building Viral AI Philosophy Channels | `7bb570b3-9dc4-4e6f-817c-aca68df59e6d` |

### Pessoal / SelfRescueProtocol (9)

| Keywords | Notebook | ID |
|----------|----------|----|
| jung, arquetipos, sombra | Jung | `d5c67d7f-7fe8-4542-9e5c-22403f3193ee` |
| emanuel, pessoal, perfil | Emanuel Almeida | `8c6c8257-bda2-433c-bf55-f40d98bfde8f` |
| taoismo, tao, wu wei | Taoism | `aea85baf-9ddf-4d79-bf07-81391a275b09` |
| adhd, phda, atencao | ADHD | `a4ff3fd7-fb7c-49a1-94ff-0433193e2338` |
| autismo, neurodivergencia | Autismo | `66eff78e-318f-4a8b-a3c7-039a4124b1ad` |
| heroi, jornada, mito | Essencia de Heroi | `6dcd08e8-79d9-4ae0-b6bf-b2ee96717bf2` |
| kintsugi, resiliencia | Auto Kintsugi | `82a95c2f-be56-4c4a-a96f-96f6677a6991` |
| somatica, corpo, trauma | Psicologia Somatica | `3410893b-16a3-4178-9091-42650a41086f` |
| estoicismo, marco aurelio, stoic | Marcus Aurelius / Stoic | `4b986ad4-49da-4604-a423-4fcdf20dd9da` |

---

## Workflow

### Passo 1: Classificar Tema

```javascript
// Input: "/knowledge como configurar crocoblock filters"
// 1. Extrair keywords: ["crocoblock", "filters", "configurar"]
// 2. Match routing: wordpress (crocoblock)
// 3. Notebooks primarios: WordPress Config CLI, WordPress e Elementor
// 4. Notebooks secundarios: Ciberseguranca WordPress (se relevante)
```

### Passo 2: Query NotebookLM (Primario)

```javascript
// Consultar 1-3 notebooks relevantes (max 3 para performance)
mcp__notebooklm__notebook_query({
  notebook_id: "fb2f26bd-8cb0-4d4c-bafc-4f1ebb51c51d", // WordPress Config CLI
  query: "crocoblock filters configuracao"
})

// Se score < 70, consultar notebook secundario
mcp__notebooklm__notebook_query({
  notebook_id: "5be0d1a6-00f2-4cd9-b835-978cb7721601", // WordPress e Elementor
  query: "crocoblock filters"
})
```

### Passo 3: Enriquecer (Opcional)

```javascript
// Supabase - contexto/decisoes anteriores
mcp__memory-supabase__search_memories({ query, tags: ["wordpress", "crocoblock"] })

// Context7 - docs bibliotecas externas
mcp__plugin_context7_context7__resolve-library-id({ libraryName: "crocoblock" })

// Filesystem - codigo local
// Grep/Glob em /media/ealmeida/Dados/Dev/ e /media/ealmeida/Dados/Hub/
```

### Passo 4: Resposta Estruturada

```markdown
## Resultado: [termo]

### Encontrado em [Notebook]
[Conteudo encontrado]

### Relacionado
- [Links relevantes]

### Qualidade
- Score: XX/100
- Fonte: NotebookLM ([notebook])
- Enriquecido: [Supabase/Context7/Local] (se aplicavel)
```

### Passo 5: Detectar e Reportar Lacunas

```javascript
if (resultado.score < 50 || !resultado.encontrado) {
  await mcp__memory-supabase__save_memory({
    content: `LACUNA: Query "${query}" sem informacao adequada.`,
    metadata: { type: 'lacuna-kb', categoria, query, score: resultado.score }
  });
}
```

---

## Regras de Routing

1. **Max 3 notebooks** por query (performance)
2. **Notebooks especificos primeiro** (ex: KiviCare antes de WordPress generico)
3. **Fallback hierarquico:** NotebookLM -> Supabase -> Context7 -> Docs Locais
4. **Multi-tema:** Se query cruza temas, consultar 1 notebook de cada tema
5. **Pessoal:** So consultar notebooks pessoais se query explicitamente pessoal

---

## Guardar Conhecimento (/kb-save)

```
1. Analisar tipo de conhecimento
2. Determinar destino:
   - Decisao/Contexto -> Supabase (memory-supabase)
   - Conhecimento tematico -> NotebookLM (via source_add ao notebook adequado)
   - Procedimento -> Hub/06-Operacoes/Procedimentos/ (PROC-*.md)
3. Formatar conteudo
4. Guardar com metadata adequada
```

---

## Deteccao de Lacunas

```markdown
> [!warning] Lacuna Detectada
> Tema "[X]" nao tem documentacao adequada.
>
> Sugestao:
> - [ ] Adicionar fontes ao notebook NotebookLM: [notebook]
> - [ ] Guardar em Supabase: [se for decisao/contexto]
> - [ ] Criar PROC: [se for procedimento]
```

---

## Gaps Conhecidos (P1)

| Gap | Notebook alvo | Prompt |
|-----|---------------|--------|
| Next.js App Router/RSC | Programacao (24947ffa) | DR-nextjs-app-router.md |
| PHP 8+ / Laravel 11-12 | Programacao (24947ffa) | DR-php-laravel-moderno.md |
| Core Web Vitals / GA4 | Marketing Digital PT (4c595973) | DR-core-web-vitals-ga4.md |
| WCAG 2.2 / ARIA | UI/UX Design (081ca512) | DR-wcag-acessibilidade.md |

---

## Checklist de Pesquisa

- [ ] Tema correctamente classificado
- [ ] Notebooks prioritarios consultados (max 3)
- [ ] Score de relevancia >70 (ou >30 agregado)
- [ ] Lacunas detectadas e reportadas
- [ ] Resultados formatados correctamente

---

## Referencias

- `references/routing-guide.md` - Mapeamento detalhado com codigo de routing
- Inventario completo: `~/.claude/projects/-media-ealmeida-Dados-Hub/memory/notebooklm-inventory.md`