a-gusman-claude

Use quando Codex, Claude Code, outro agente, plataforma ou automacao precisar consultar o Data Engine Knowledge Gateway e pedir acesso governado a dados/APIs via Access Broker CLI. Cobre descoberta de recursos, manifesto, validacao, preview, request, status, drift e descriptor, sem aprovar ou revelar segredos.

Entry point do sistema. Recebe qualquer pedido, classifica, roteia para a melhor combinação de skills/agents/plugins, e monitora. Vai além do óbvio — sugere combos compostos, ativa auxiliares proativos, e delega a plugins canonicals (ADR-0001) quando apropriado.

Maquina especialista em dados Raiz: data-engine API canonical (/v1/kpis/*, /reports/<panel>/data, Envelope v2, KPI Registry Ouro M01..A*) + SQL TOTVS RM + Neon PostgreSQL + Zeev BPM + PBI_RAIZ. Use para: descobrir KPI Ouro, consumir painel canonical, escrever query nova (cascade painel>KPI>dinamica>raw), otimizar SQL lenta, anti-patterns, relatorios, processos Zeev. Tier 0: data-engine. Aplica ADR-041 (TOTVS via Neon Mirror enforced).

Maquina de design UI/UX. 67 estilos, 96 paletas, 57 font pairings, 13 stacks. Design system, componentes, landing pages, dashboards. Integra com shadcn, Figma, v0.

Maquina autonoma de limpeza de dead code (Knip + AST + bundle, confidence tiers, PRs atomicos). Use para tech debt, hand-off, reducao de bundle, cleanup pos-spike, auditoria de saude. Modo --target=harness audita dead skills/hooks/MCPs do proprio Claude Code.

Auditoria completa de software (wrapper FORTRESS). Roda MERIDIAN + SENTINEL + ARCHITECT + CONDUCTOR + LIGHTHOUSE + HARNESS (opcional) em sequencia. Fortress Score = laudo completo.

Arquiteto senior platform + AI-first + data + LGPD para o ecossistema Raiz Educacao. Nao validador — par tecnico que desafia, traz benchmark externo, propoe alternativas, mede trade-offs. 10 modos de operacao. Carrega base do manual + state atual da Raiz como contexto.

Auditor sistematico do proprio harness (skills, agents, hooks, rules, MCP). Detecta drift, prompt injection risk, redundancia semantica, violacao de DoD, cost MCP. Produz HCS (Harness Coverage Score). Invocado por /ag-9-auditar --include-harness.

Auditor de Hooks React. Detecta violacoes das Rules of Hooks, deps faltando/excessivas em useEffect/useMemo/useCallback, candidatos a custom hook, useState que deveria virar useReducer. Use para audit qualidade React proativo.

Maquina autonoma de saude arquitetural. 5D (STRUCTURE/COUPLING/DEBT/PATTERNS/SCALE), imports circulares, tech debt, consistencia. AQS >= 80.

Bug hunter proativo. Scan autonomo de anti-patterns, null refs, race conditions, type mismatches, error handling gaps. Diferente de ag-corrigir-bugs (reativo), este caca bugs ANTES de aparecerem.

Corrige erros TypeScript com auto-routing. Scan (diagnosticar), Fix (batch incremental), Sweep (varredura com ratchet), Audit-any (auditoria proativa de any/inferencias fracas). Substitui workflow manual de typecheck.

Orquestrador supremo. Roda MERIDIAN+SENTINEL+ARCHITECT+CONDUCTOR+LIGHTHOUSE em sequencia. Modo --include-harness adiciona dimensao HARNESS (HCS) auditando o proprio Claude Code. Fortress Score (FS) = laudo completo.

Otimizacao de performance e legibilidade. Mede antes e depois. Nao otimiza sem medir. Use when optimizing code performance.

Otimizador de overhead do proprio harness. Identifica skills caras (tokens x frequencia), candidatas a cache_control, candidatas a depreciacao, MCPs com baixo ROI. Consumido por ag-9-auditar (dimensao HARNESS) e ag-13-limpar-codigo (--target=harness).

Retrospectiva de sessao. Analisa tempo, falhas, decisoes. Compara com sessoes anteriores. Propoe melhorias para skills e memory. Modos: --instincts (revisa _instinct-candidates.md auto-extraidos), --review-stale (revisa memories obsoletos).

Maquina autonoma de construcao. Feature, refactor, UI, issue, integracao, otimizacao — recebe objetivo, entrega PR pronto. Padrao MERIDIAN: fases, convergencia, state, self-healing.

Maquina autonoma de correcao. Bugs, erros TypeScript, tech debt — auto-detecta modo, diagnostica, corrige, verifica em loop convergente. Produz PR com fix verificado.

Metricas e analytics de sessoes Claude Code. Token usage por projeto, patterns de erro recorrentes, commands mais usados, tempo medio de sessao, evolucao de qualidade.

Cria, melhora e avalia skills com evals quantitativos. Use para criar/atualizar/otimizar skill, rodar evals, benchmark de performance, ou otimizar description para triggering.

Diagnostica e corrige bugs. Le errors-log.md antes de comecar para nao repetir tentativas que ja falharam. Use quando algo nao funciona, da erro, quebrou, trava, build falha, ou qualquer comportamento inesperado.

Cria especificacao tecnica detalhada: o que construir, como, quais interfaces, quais edge cases. Spec precisa e implementavel. Use when creating technical specifications.

Analisa reports dos outros agentes, identifica padrões de falha, propõe melhorias nos prompts. O meta-agente anti-frágil.

Debate multi-agente: 2-4 perspectivas (PM, Arquiteto, QA, Security) debatem decisao tecnica. Output: decisao + rationale + dissenting opinions → ADR. Inspirado no Party Mode do BMAD-METHOD.

Quebra spec em fases e tarefas atomicas com dependencias, criterios de done e estimativas. Produz task_plan.md. Use when breaking specs into execution plans.

Maquina de benchmark de software. Crawl SaaS plataformas — navigate all pages, screenshot, analyze with AI, generate detailed SPEC

Maquina autonoma de teste final. QAT textual, UX-QAT visual, benchmark comparativo, ciclo test-fix-retest, E2E batch — PDCA convergente com scores.

Maquina autonoma de qualidade (wrapper MERIDIAN). Descobre app, testa 5 dimensoes (ALIVE/REAL/WORKS/LOOKS/FEELS), corrige, re-testa ate convergencia MQS >= 85. Quality Certificate.

Maquina autonoma de seguranca (wrapper SENTINEL). Security + load testing + LGPD compliance. 6 dimensoes, modo hybrid, convergencia SSS >= 80. Security Certificate.

Analisa padroes de codigo, debitos tecnicos, riscos arquiteturais. Produz diagnostico com prioridades P0-P3. Use when analyzing code quality, tech debt, or architectural risks.

Sub-agent applier de fixes dead code. Recebe findings de ag-escanear-morto-codigo, aplica em PRs atomicos com quality gates. Confidence-aware. Invocado por ag-13-limpar-codigo.

Maquina autonoma de Developer Experience. 5D (SETUP/DOCS/TYPES/TESTS/CI), onboarding em 10min, docs, TypeScript DX, testes, CI. DXS >= 80.

Maquina autonoma de observabilidade. 5D (ERRORS/LOGS/METRICS/ALERTS/TRACES), Sentry, logging, Web Vitals, alertas, OTEL. OBS >= 75.

Captura tela e controla mouse/teclado em apps nativos macOS via router 3-tier (macos-use > macos-automator > computer-use). Para apps BROWSER, preferir Playwright MCP.

Cria novos agentes completos (agent + command + skill opcional). Gera frontmatter, instrucoes, quality gates. Use para criar agents novos, adicionar agXX ao sistema.

Curador trimestral de skills externas (Anthropic + comunidade). Avalia o que pegou no ecossistema, compara com sistema ag local, e recomenda absorver/wrapper/ignorar. Nao instala automaticamente.

Sub-agent de scan multi-tool dead code (Knip + ts-prune + depcheck + ESLint + Madge + bundle + AST custom). Read-only. Output JSON para ag-13-limpar-codigo.

Maquina autonoma de qualidade. Descobre app, testa 5 dimensoes (ALIVE/REAL/WORKS/LOOKS/FEELS), corrige, re-testa ate convergencia. Quality Certificate + Fix PR + baselines.

Audita machines ag-*.md e reference skills em .claude/skills/ identificando candidatos a cache_control: ephemeral. Reporta tokens estimados antes/depois. Injeta markers no modo --apply.

Taxonomia de 86 layouts apresentacao/marketing (hero, pricing, auth, nav, CTA, etc) adaptada do VibeUI. Consultar ANTES de landing pages, onboarding, auth screens.