descomplicar-meta-plugin/README.md

Descomplicar Meta-Plugin

Meta-plugin para gestão automatizada da infraestrutura Claude Code com suporte completo a MCPs, LSPs, relacionamentos e telemetria.

Versão

v1.2.0 - Adicionado suporte completo a LSPs, telemetria e documentação de boas práticas.

Documentação

Documento	Descrição
STANDARDS.md	Regras oficiais do ecossistema
docs/01-GUIA-SKILLS.md	Guia definitivo para skills
docs/02-GUIA-AGENTS.md	Guia definitivo para agents
docs/03-GUIA-HOOKS.md	Guia completo de hooks (12 eventos)
docs/04-GUIA-PLUGINS.md	Guia de plugins
docs/05-CHECKLISTS.md	Checklists de validação
docs/06-TEMPLATES.md	Templates prontos

Funcionalidades

• Monitorização - Health check de todos os componentes (Agents, Skills, MCPs, LSPs, SDKs)
• Relacionamentos - Gestão de 800+ mapeamentos entre componentes
• LSPs - Language Server Protocols para agentes de desenvolvimento
• Telemetria - Métricas de uso de agentes, skills, MCPs e LSPs
• Sincronização - Bidireccional entre ficheiros e MySQL
• Descoberta - Plugins relevantes nos marketplaces
• Injecção - Contexto dinâmico para agentes (MCPs + LSPs)
• Decision Trees - Selecção automática de agentes baseada em keywords

Instalação

# Via plugin-dir (desenvolvimento)
claude --plugin-dir ~/mcp-servers/descomplicar-meta-plugin

# Via marketplace (produção)
/plugin marketplace add descomplicar/meta-plugin
/plugin install descomplicar-meta-plugin

Configurar Base de Dados

# Executar SQL de criação das tabelas LSP
mysql -u user -p ealmeida_desk24 < sql/create-lsp-tables.sql

Comandos

Comando	Descrição
/descomplicar:status	Dashboard completo de infraestrutura
/descomplicar:sync	Sincronização ficheiros ↔ MySQL
/descomplicar:discover	Descoberta de plugins
/descomplicar:agent-config	Configuração de recursos por agente
/descomplicar:relationships	Gestão de relacionamentos
/descomplicar:telemetry	Métricas de uso e performance
/descomplicar:decision-trees	Gestão de árvores de decisão
/descomplicar:lsps	Gestão de Language Server Protocols

Skills

Skill	Trigger
infrastructure-manager	Problemas de sistema, health < 90
relationship-manager	Configuração de relacionamentos
plugin-curator	Recomendações de plugins
agent-context-injector	Hook SubagentStart automático
lsp-manager	Gestão de LSPs para dev agents

Agents

Agent	Uso
infrastructure-orchestrator	Diagnóstico e gestão de sistema
plugin-evaluator	Avaliação de plugins

Hooks

Evento	Script	Função
SessionStart	session-init.sh	Quick health check
SubagentStart	inject-agent-context.sh	Injecção de contexto (MCPs + LSPs)
Stop	session-end.sh	Cleanup e logging

Estrutura

descomplicar-meta-plugin/
├── .claude-plugin/
│   └── plugin.json              # Manifesto v1.1.0
├── commands/
│   ├── infra-status.md          # /descomplicar:status
│   ├── infra-sync.md            # /descomplicar:sync
│   ├── discover-plugins.md      # /descomplicar:discover
│   ├── agent-config.md          # /descomplicar:agent-config
│   ├── relationships.md         # /descomplicar:relationships
│   ├── telemetry.md             # /descomplicar:telemetry
│   ├── decision-trees.md        # /descomplicar:decision-trees
│   └── lsps.md                  # /descomplicar:lsps
├── skills/
│   ├── infrastructure-manager/
│   ├── relationship-manager/
│   ├── plugin-curator/
│   ├── agent-context-injector/
│   └── lsp-manager/
├── agents/
│   ├── infrastructure-orchestrator.md
│   └── plugin-evaluator.md
├── docs/
│   ├── 01-GUIA-SKILLS.md
│   ├── 02-GUIA-AGENTS.md
│   ├── 03-GUIA-HOOKS.md
│   ├── 04-GUIA-PLUGINS.md
│   ├── 05-CHECKLISTS.md
│   ├── 06-TEMPLATES.md
│   └── README.md
├── hooks/
│   └── hooks.json
├── scripts/
│   ├── session-init.sh
│   ├── inject-agent-context.sh
│   ├── session-end.sh
│   └── sync-to-mysql.sh
├── sql/
│   └── create-lsp-tables.sql    # Tabelas LSP
├── lib/
│   └── (scripts auxiliares)
└── .mcp.json

Base de Dados

Core Tables (Entidades)

Tabela	Registos	Descrição
cr_agents	46	Agentes especializados
cr_skills	54	Skills invocáveis
cr_mcps	33	Servidores MCP
cr_lsps	11	Language Server Protocols
cr_sdks	29	Software Development Kits
cr_mcp_tools	822	Ferramentas por MCP
cr_plugins	5+	Plugins instalados

Relationship Tables (800+ relacionamentos)

Tabela	Registos	Relacionamento
cr_agent_mcps	483	Agente ↔ MCP (primary/recommended/available)
cr_agent_lsps	~40	Agente ↔ LSP (primary/recommended/available)
cr_sdk_agents	131	SDK ↔ Agente
cr_sdk_skills	75	SDK ↔ Skill
cr_sdk_mcps	56	SDK ↔ MCP
cr_agent_skills	~50	Agente ↔ Skill
cr_skill_mcps	~45	Skill ↔ MCP
cr_agent_collaborations	~30	Agente ↔ Agente

Telemetry Tables

Tabela	Descrição
cr_agent_usage	Tracking uso de agentes
cr_skill_usage	Tracking uso de skills
cr_mcp_tool_usage	Tracking uso de ferramentas MCP
cr_lsp_usage	Tracking uso de LSPs

Intelligence Tables

Tabela	Descrição
cr_decision_trees	Árvores de decisão para selecção de agentes
cr_recommendations	Sugestões de melhorias
cr_component_issues	Issues abertos
cr_reflections	Reflexões do sistema

LSPs Suportados

LSP	Linguagem	Agentes Típicos
intelephense	PHP	php-fullstack-engineer, wordpress-plugin-developer
typescript-language-server	TypeScript/JS	javascript-fullstack-specialist
pyright	Python	dev-helper
gopls	Go	dev-helper
rust-analyzer	Rust	dev-helper
yaml-language-server	YAML	easypanel-specialist, n8n-automation-expert
bash-language-server	Bash	cwp-server-manager, backup-specialist
sql-language-server	SQL	database-design-specialist
vscode-css-languageserver	CSS	web-designer, ui-designer
vscode-html-languageserver	HTML	web-designer, elementor-specialist
vscode-json-languageserver	JSON	n8n-automation-expert

Dependências

• Claude Code >= 1.0.33
• MCPs: desk-crm-v3, filesystem, gitea, mcp-time
• MySQL (ealmeida_desk24)
• jq (opcional, para scripts avançados)

Health Score

Health Score = (
  entities_sync * 20 +
  relationships_consistent * 20 +
  mcps_responsive * 15 +
  lsps_installed * 10 +
  hooks_healthy * 10 +
  decision_trees_valid * 10 +
  telemetry_active * 10 +
  plugins_functional * 5
) / 100

Thresholds:

• = 90: Excelente (verde)

• 70-89: Bom (amarelo)
• < 70: Crítico (vermelho)

Métricas

Métrica	Target
Health Score	>= 90
Órfãos	0
Context injection	< 2s
Sync frequency	6h
LSP coverage (dev agents)	>= 80%

Changelog

v1.1.0 (2026-02-04)

• Adicionado suporte completo a LSPs (11 language servers)
• Nova tabela cr_lsps e cr_agent_lsps
• Novo comando /descomplicar:lsps
• Nova skill lsp-manager
• Telemetria de LSPs (cr_lsp_usage)
• Actualizado health score para incluir LSPs

v1.0.0 (2026-02-04)

• Release inicial
• Suporte a MCPs, relacionamentos, telemetria
• 8 comandos, 5 skills, 2 agents

Autor

Descomplicar® | descomplicar.pt

Licença

MIT