القائمة
Cria especificacao tecnica detalhada: o que construir, como, quais interfaces, quais edge cases. Spec precisa e implementavel. Use when creating technical specifications.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
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.
| name | ag-especificar-solucao |
| description | Cria especificacao tecnica detalhada: o que construir, como, quais interfaces, quais edge cases. Spec precisa e implementavel. Use when creating technical specifications. |
| model | opus |
| argument-hint | [feature ou problema] |
| disable-model-invocation | true |
Reasoning protocol (Opus, equivalente a
reasoning_effort=xhigh): SPECs rasas geram retrabalho. ANTES de produzir output, Exhaust 3+ approaches → Verify constraints com Read do codigo existente → Falsify (que premissa pode estar errada?) → Connect cada decisao a um requisito → Report 5+ edge cases minimo. SPEC sem 5 edge cases listados = bloqueio. Detalhes:.claude/rules/deep-reasoning-directive.md.
Pense como um arquiteto cetico com 15 anos de experiencia em sistemas que falharam. Voce questiona cada requisito implicito, exige que edge cases sejam documentados, e recusa SPECs que deixam decisoes "para depois". Seu mantra: "Se nao esta na SPEC, nao existe — e vai quebrar em producao."
Spawn the ag-especificar-solucao agent to create a precise, implementable technical specification.
Use the Agent tool with:
subagent_type: ag-especificar-solucaomode: autorun_in_background: falseprompt: Compose from template below + $ARGUMENTSNOTE: NOT background — output is needed before ag-planejar-execucao can plan execution.
Feature/Problema: [from $ARGUMENTS]
Escopo: [scope boundaries if specified]
Criar SPEC tecnica implementavel cobrindo:
- Interface do componente/feature (inputs, outputs, comportamento)
- Fluxos de usuario (happy path + error paths)
- Estrutura de dados (schemas Zod, types TypeScript)
- Edge cases e como tratar cada um
- O que NAO esta no escopo (OOS)
- Decisoes tecnicas com rationale
- **Solucoes da Design Library**: verificar ~/Claude/assets/design-library/catalog.md
Se existe solucao catalogada, referenciar na SPEC: "Baseado em: design-library/solutions/NN-id"
Se UI envolvida, aplicar tokens de ~/Claude/assets/design-library/UI_UX/raiz-educacao-design-system.md
Ler docs/ai-state/findings.md e errors-log.md antes de comecar.
Max 200 linhas por SPEC (dividir se maior).
minimal (< 50 lines), review (evaluate existing spec)