ealmeida/descomplicar-meta-plugin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
descomplicar-meta-plugin/README.md
Emanuel Almeida 692475a315 feat(v1.5.2): Execute database migrations and complete setup 
- Execute all 6 migrations on Desk CRM production database
- Create missing tables: cr_lsps, cr_agent_lsps, cr_lsp_usage
- Create archive tables: cr_*_usage_archive (4 tables)
- Create system tables: cr_migrations, cr_maintenance_log
- Make all scripts executable (chmod +x)
- Total cr_* tables: 38

Migration files:
- 001_initial_schema.sql
- 002_add_lsps.sql
- 003_add_relationships.sql
- 004_add_telemetry.sql
- 005_add_archive_tables.sql
- 006_add_maintenance_log.sql

Scripts:
- session-init.sh, session-end.sh
- inject-context.sh, inject-agent-context.sh
- record-usage.sh, db-backup.sh, sync-to-mysql.sh

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 16:18:02 +00:00

254 lines
8.1 KiB
Markdown
Raw Permalink Blame History

# 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
Reference in New Issue View Git Blame Copy Permalink