ai-workflow-skill/docs/roadmaps/archive/remove-root-cmd-compat-shims.md

Remove Root Cmd Compatibility Shims

Status

• completed

Owner

• Codex

Started At

• 2026-03-20

Goal

• Remove the legacy root cmd/ compatibility shims now that package-owned runtimes are the source of truth, and clean up the remaining current docs and test indexes that still point at deleted root runtime paths.

Scope

• remove root cmd/inbox, cmd/orch, and cmd/orchd
• update current docs and test-plan indexes that still reference removed root runtime paths
• keep package-owned runtime workflows and skill packaging validated after the cleanup

Checklist

• inspect remaining references to root cmd/ and deleted root internal/ runtime paths
• update current docs and test indexes to point at package-owned runtime paths
• remove the root cmd/ files and any now-unneeded root shim wiring
• validate package-owned runtime and skill packaging workflows after the cleanup
• update roadmap state and archive this workstream if complete

Files

• docs/roadmaps/archive/remove-root-cmd-compat-shims.md
• cmd/
• docs/implementation-roadmap.md
• docs/tests/
• docs/skill-workspace-monorepo.md
• docs/web-product-monorepo.md
• go.mod

Decisions

• treat archived roadmaps as historical records; fix only current source-of-truth docs and current test indexes unless a broken archived reference blocks real workflows

Blockers

• none

Next Step

• continue routine feature work on top of the package-owned runtime workspace without recreating root-owned Go entrypoints

Completion Summary

• updated the current inbox and orch test-plan indexes so they now point at package-owned runtime test files instead of deleted root internal/cli/* paths
• removed the root cmd/ compatibility shims and the now-unneeded root Go module files so package-owned runtimes under packages/*/cmd/* are the only maintained Go entrypoints
• added a root pnpm run go:test script that validates package-owned Go runtimes directly, replacing reliance on a root Go module
• synchronized the current implementation and web monorepo docs with the package-owned runtime layout after the cleanup