# Execution - T-01 Contrato runtime-agnostic

## Rastreabilidade
- Orquestração: `a-jogada-mais-limpa-sdd-continua-runtime-agnostic-o-core-segue-dono-do-contrato-sdl-8ee3bafff01a`
- Stage: `execution`
- Estado atual: `recorded`
- Tarefa executada: `T-01 - Consolidar contrato runtime-agnostic nas superfícies canônicas`
- Artefato anterior: `04-tasks.md`
- PRD aprovado: `02-prd.md`
- Tech Spec aprovada: `03-techspec.md`
- Context Pack: `.sdd/intelligence/context-packs/a-jogada-mais-limpa-sdd-continua-runtime-agnostic-o-core-segue-dono-do-contrato-sdl-8ee3bafff01a/execution.md`

## Tarefa
Atualizar superfícies canônicas para declarar que o core SDD governa o contrato SDLC e que Rig, Flue, LangGraph, Agno e runtimes futuros são engines/adapters opcionais. O fallback obrigatório permanece Markdown, comandos `sdd`, artifact store local e validações determinísticas.

Fora de escopo desta fatia: implementar execução direta de runtimes, adicionar SDKs novos, mudar stages, mudar checkpoints ou tornar MCP/tool calling obrigatório.

## Resumo da implementação
- Propaguei o contrato runtime-agnostic para as superfícies principais de orquestração: skill compartilhada, skills específicas de clients, comandos/workflows gerados, docs de clients e documentos raiz.
- Atualizei os geradores em `src/main.rs` para que `sdd clients sync` preserve a mesma linguagem em Cursor, Claude Code, Devin, Trae e opencode.
- Alinhei o pacote canônico do plugin em `plugins/orchestration/skills/orchestration/SKILL.md` e o mirror instalado em `.agents`/`.claude`, corrigindo o drift detectado por testes.
- Corrigi superfícies remanescentes que ainda usavam `orchestrator` como caminho principal, mantendo o alias apenas para compatibilidade e promovendo `orchestration` como nome canônico.
- Mantive MCP/trace como observabilidade derivada/read-only e `docs/<slug>/traceability-map.yaml` como fonte local de verdade.
- Corrigi a compatibilidade do slug longo da orquestração com `artifact_slug`, evitando erro de path `File name too long` ao materializar ciclos com entradas naturais extensas.

## Arquivos alterados
- `AGENTS.md`
- `CLAUDE.md`
- `clients/README.md`
- `templates/client-skills/orchestration.md`
- `.agents/skills/orchestration/SKILL.md`
- `.claude/skills/orchestration/SKILL.md`
- `.cursor/skills/orchestration/SKILL.md`
- `.devin/skills/orchestration/SKILL.md`
- `.trae/skills/orchestration/SKILL.md`
- `.claude/commands/orchestration.md`
- `.claude/commands/sdd.md`
- `.claude/commands/dry-run.md`
- `.claude/commands/sdd-doctor.md`
- `.cursor/commands/orchestration.md`
- `.devin/workflows/orchestration.md`
- `.opencode/commands/orchestration.md`
- `.trae/commands/orchestration.md`
- `.agents/skills/orchestration-plugin/skills/orchestration/SKILL.md`
- `.claude/skills/orchestration-plugin/skills/orchestration/SKILL.md`
- `.agents/skills/orchestration-plugin/commands/orchestration.md`
- `.agents/skills/orchestration-plugin/commands/sdd.md`
- `.claude/skills/orchestration-plugin/commands/orchestration.md`
- `.claude/skills/orchestration-plugin/commands/sdd.md`
- `plugins/orchestration/skills/orchestration/SKILL.md`
- `plugins/orchestration/commands/orchestrator.md`
- `plugins/orchestration/commands/sdd.md`
- `src/main.rs`
- `src/domain/orchestrator/demand.rs`
- `tests/cli.rs`
- `docs/a-jogada-mais-limpa-sdd-continua-runtime-agnostic-o-core-segue-dono-do-contrato-sdl-8ee3bafff01a/06-execution.md`

## Testes e evidências
- `rtk cargo fmt`: passou.
- `rtk cargo test capabilities_catalog_doctor_sync_and_recommend_cover_portable_surfaces`: passou, `1 passed`.
- `rtk cargo test orchestration_plugin_skill`: passou, `2 passed`.
- `rtk cargo test orchestration_plugin`: passou, `2 passed`.
- `rtk cargo test`: passou, `402 passed`.
- `rtk cargo run --quiet -- clients doctor --strict`: passou; `SDD clients doctor PASS` e `SDD capabilities doctor PASS`.
- `rtk cargo run --quiet -- capabilities doctor --targets all`: passou; `SDD capabilities doctor PASS`.
- `rtk git diff --check`: passou sem saída.

## Riscos e pendências
- O worktree já continha mudanças não relacionadas antes desta fatia, incluindo ajustes em MCP/runtime adapters, providers, hooks, automations e dependências. Essas mudanças foram preservadas e não revertidas.
- T-02, T-03 e T-04 continuam pendentes: registry de runtime adapters, observabilidade MCP específica de adapters e guardrails adicionais de compatibilidade ainda precisam ser tratados nas próximas fatias.
- Como esta fatia confirmou e propagou uma decisão arquitetural pública, `06-adr.md` foi registrado para documentar a decisão runtime-agnostic e as evidências desta execução.
