# 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](STANDARDS.md) | Regras oficiais do ecossistema |
| [docs/01-GUIA-SKILLS.md](docs/01-GUIA-SKILLS.md) | Guia definitivo para skills |
| [docs/02-GUIA-AGENTS.md](docs/02-GUIA-AGENTS.md) | Guia definitivo para agents |
| [docs/03-GUIA-HOOKS.md](docs/03-GUIA-HOOKS.md) | Guia completo de hooks (12 eventos) |
| [docs/04-GUIA-PLUGINS.md](docs/04-GUIA-PLUGINS.md) | Guia de plugins |
| [docs/05-CHECKLISTS.md](docs/05-CHECKLISTS.md) | Checklists de validação |
| [docs/06-TEMPLATES.md](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

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

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