A cache do plugin e versionada por directorio (cache/.../1.2.0/), pelo que
as correccoes de ca6c56c ao gateway-check nao chegavam ao carregador sem
bump de versao.
Corrige a próxima porta livre (a 3188 documentada estava ocupada e causou um
deploy falhado), regista o router youtube e o ssh-unified, e acrescenta três
regras: backups do nginx nunca em sites-enabled/, cruzar sempre ss -tlnH com
as portas roteadas, e contar ~40s de arranque nos MCPs Python/FastMCP.
O commit 0e2c832 bumpou só o marketplace.json agregado. A fonte de verdade
para o /plugin update é <plugin>/.claude-plugin/plugin.json, que ficou nas
versões antigas — resultado: o catálogo mostrava marketing 2.0.0 mas o
/plugin update respondia "already at the latest version (1.0.0)" e o cache
continuou a servir a superfície SEO morta.
Alinha as quatro fontes com o agregado e documenta o acoplamento no README:
os dois ficheiros têm de ser bumpados juntos, não há automação a sincronizá-los.
As skills de SEO assentavam em quatro dependências, nenhuma operacional:
SEO Tools API (localhost:3000, pasta inexistente em disco), Ahrefs MCP
(nunca esteve em config), gsc e lighthouse (em disabledServers). Os seis
passos da /seo-audit e o workflow inteiro da /seo-report apontavam para
tooling morto — não eram executáveis.
- seo-audit v3.0: ordem por custo (grátis → lote pago → unitário pago),
gate de mercado (PT = 2620/pt) e gate de maxPages
- seo-report v3.0: cobertura de crawl obrigatória no entregável
- ferramentas-api.md: inventário das 24 ferramentas OpenSEO + tabela de
migração endpoint a endpoint
- implementacao-tecnica.md: striking distance, desperdício e filtro de
ruído do GSC em código
- seo-specialist v3.0: primary_mcps [openseo], bloco de MCPs desligados,
FID → INP nos Core Web Vitals
maxPages tem default 50: descomplicar.pt auditado com o default deu 25
URLs e 92 issues sem críticos; com maxPages 600 deu 1337 issues e 9
críticos. Documentado como gate — a fase Search Console dimensiona o crawl.
Limitações declaradas nas skills: get_audit_issues devolve contagens sem
URLs pela bridge MCP (structuredContent.issues não é entregue) e o whoami
não expõe saldo de créditos em self-hosted.
Licao do teste WhatSMS: o briefing enquadrou um sistema de automacao de
contacto multicanal como bot de resposta a mensagens, e o resultado foi
uma landing page de chatbot de WhatsApp.
Nova seccao 0: perguntar o posicionamento e nunca presumi-lo; "esta
robotico" pede tom e nao reescrita de posicionamento; briefing longo
escrito sozinho impede o motor de fazer as perguntas certas.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Levantamento e metodo, ainda por aprovar:
- SPEC-opendesign-migration.md: plano de migrar as skills e agents do
plugin para o Open Design como motor unico, com design systems geridos
la (Descomplicar e um por cliente)
- DRAFT-metodo-design-pro.md: contrato de entrada com 4 pilares, fluxo em
4 fases, regra do hero, pipeline template-first (Envato e galerias) e
directrizes de operacao no Open Design
Nenhum destes documentos esta validado por uso real. O primeiro teste
(WhatSMS) falhou no enquadramento — ver nota no topo do metodo.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
A skill documentava uma paleta azul/laranja (#1a365d, #dd6b20) com Open Sans
que nao corresponde nem ao design system nem ao site real. Cada ferramenta
produzia material com uma marca diferente.
Passa a espelhar o DESIGN.md do Open Design como fonte de verdade unica:
dourado #cc8d00 sobre preto e branco, Montserrat (display) e Inter (corpo),
com precedencia explicita do DESIGN.md sobre qualquer espelho.
Reformulada para servir qualquer marca (Descomplicar e clientes), com
procedimento para criar design systems de cliente a partir de material real
via brand-extract, validacao antes de tornar normativo, e um projecto por marca.
- SKILL.md v2.0.0: espelho correcto + gestao multi-marca
- descomplicar-theme.md v2.0.0: tokens YAML derivados do DESIGN.md
- color-palettes.md removido: 47 valores derivados da paleta errada
- design-systems-multimarca.md: procedimento de gestao no Open Design
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
SETUP_MCPS deixa de apontar para settings.json (regra 58); agents com MCPs
desligados por omissão (desk-crm-v3, moloni, easypanel, lighthouse, authentik,
spaceship, youtube) ganham nota para pedir activação via /mcp.
Timers rclone-bisync/gdrive-sync marcados obsoletos (devem ficar disabled);
backup-strategies reescrito: offsite via rclone pontual LocalBackups→GDrive,
nunca rclone mount/bisync em pastas de trabalho (conflito com InSync).
Desenvolvimento passa a local no desktop (/media/ealmeida/Dados/Dev), sem
ssh_execute(server="dev"); crons /root/Dev migrados para systemd user
timers; refs a sync Syncthing para dev removidas (regra 48).
wikijs retirado das tool-lists de agents; consultas mcp__wikijs__search_pages
substituídas por /knowledge (router Hub QR/PROC) + mcp__mem0__search_memories;
checklist CWP deixa de exigir LLM Wiki (mantém PROCs Hub + skills /cwp-*,
regra CWP Zero Invenção); refs à wiki oficial CWP e ao serviço wikijs do
gateway mantidas.
Cache instalado (1.6.2) mais recente que o repo (1.4.0): today v12.0
(systemd user timers), worklog actualizado, novas skills qw e report-5w2h.
Preservada a edição local de deep-research (remove refs a /research extinta),
mais recente que o cache.
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>
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>
Skills /worklog e /reflect dependem do histórico conversacional do agente
principal. Invocá-las via Skill tool ou Agent tool cria subagente sem
contexto e reporta 'nothing to log'. Banner obrigatório no topo, fonte A
(conversa) reforçada como primária, fonte C (activity log) rebaixada para
fallback.
Incidente 2026-04-23: após 28h+ trabalho Observabilidade, /worklog via
Skill tool retornou vazio.
Actualização derivada da restauração do LightRAG-HKU no gateway
(ver Hub/04-Stack/CHANGELOG.md sessão 3 extensão).
A v2.1.0 tinha sido escrita assumindo FastMCP file-based com 11 tools
(lightrag_query, lightrag_stats, etc) porque outra sessão tinha
migrado temporariamente o backend. Essa migração foi revertida e o
stack voltou ao LightRAG-HKU 1.4.13 completo com 17 tools originais.
Mudanças:
- Router Família A agora usa mcp__lightrag__query_document (não lightrag_query)
- Documentada a lista completa de 17 tools MCP (query, insert, pipeline, graph edit)
- Referência à UI rag.descomplicar.pt/webui
- PG storage notado (331 docs workspace default)
- Graceful fallback para mcp__memory-supabase__ quando MCP indisponível
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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, só
tem ebooks e transcripts. Racional em memory/feedback_knowledge-router-
arquitectura.md.
Nova arquitectura (não é fallback linear, é router por tipo):
- Família A (operacional interna, paralelo): LightRAG + memory-supabase +
grep ~/.claude/projects/*/memory/ cross-projecto + Obsidian/Hub + Desk CRM
- Família B (externa, NotebookLM): só conceptual/teórico/research/mercado
- Ambíguo: perguntar ao utilizador
Tools LightRAG actualizadas para as reais (FastMCP file-based,
confirmadas na recuperação sessão 3 do plano gaps): lightrag_query
(hybrid), lightrag_stats, lightrag_get_entity, lightrag_get_graph.
Grep cross-projecto obrigatório em ~/.claude/projects/*/memory/*.md
(101 ficheiros em 34 projectos) porque o harness só carrega
automaticamente a memória do cwd — este é um gap de contexto do CC
que nenhum sistema anterior endereçava.
Mantidas as tabelas de routing NotebookLM como Família B.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Dify foi removido 06-03-2026. Skills brainstorm/discover ainda referenciam-no
no corpo. Bump v1.2 + nota top-of-file. Reescrita workflow para próxima sessão.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Skill de compilação do 00-Inbox do Hub Obsidian. Classifica ficheiros
.md, gera resumos e backlinks, sugere destino e move com aprovação
explícita do utilizador. Implementa padrão Karpathy Raw→Compiler→Wiki.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Reordenar Capabilities para seguir ordem do Workflow:
ANALYSE GAPS → SEARCH → EVALUATE → RECOMMEND → INSTALL
(Gap Analysis passa de 4º para 1º lugar)
- Scoring: adicionar comentários inline com tipo (bool/tiered)
e escala de cada variável; confirmar explicitamente soma 3+2+2+1+2=10
- Healing log preenchido com os 2 problemas encontrados e corrigidos
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Problemas encontrados e corrigidos:
- Comandos /reflect deep e /reflect week marcados como '(exclusivo)'
mas existem na tabela de comandos do worklog SKILL.md (linhas 24-25)
- Versão desactualizada: reflect v4.0.0 vs worklog v4.2.0
- /worklog view não referenciado no reflect (utilizador sem acesso a ver logs)
Correcções aplicadas:
- Tabela de comandos: remover '(exclusivo)', mapear equivalentes worklog
- Adicionar /reflect view → /worklog view
- Nota explicativa sobre comandos partilhados (deep/week)
- Referência ao worklog v4.2.0 no corpo da skill
- Healing log preenchido com 3 entradas dos problemas detectados
- Bump versão: v4.0.0 → v4.0.1
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Plugin acidaos (novo):
- rust-dev: desenvolvimento Core em Rust (Axum, crates, debug compiler)
- spoke-dev: desenvolvimento Spokes em Next.js/TypeScript + Storybook
- devops: pipelines Gitea Actions CI/CD (adaptado de GitHub para Gitea)
- docs: rustdoc, TypeDoc, Outline e ADRs
dev-tools:
- prompt-refine: skill genérica de engenharia de prompts para agentes IA
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Documents Chrome integration capabilities, troubleshooting,
comparison with Puppeteer/WebFetch, and common workflows.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
marketplace.json only had hello-plugin registered. Added all 12 plugins
(automacao, crm-ops, design-media, dev-tools, gestao, hello-plugin,
infraestrutura, marketing, negocio, perfex-dev, project-manager,
wordpress) so Claude Code can discover and load them.
This fixes "failed to load" errors for all descomplicar plugins.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add NotebookLM (Gemini 2.5 RAG) as primary internal knowledge source for
/discover and /brainstorm skills, complementing existing Dify KB datasets.
- /discover: NotebookLM as first source in Fase 1 (Pesquisa Interna)
- /brainstorm: NotebookLM Passo A before Dify KB Passo B in Fase 2
- datasets.json: dual-source structure (notebooklm + dify_kb)
- plugin.json: bump to v1.1.0, update description
- 7 notebooks mapped to topics for intelligent routing
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Marketplace Descomplicar para plugins Claude Code.
Primeiro plugin: hello-plugin (exemplo didactico com skill, agent, hook)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
ealmeida
