# 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

- [x] inspect remaining references to root `cmd/` and deleted root `internal/` runtime paths
- [x] update current docs and test indexes to point at package-owned runtime paths
- [x] remove the root `cmd/` files and any now-unneeded root shim wiring
- [x] validate package-owned runtime and skill packaging workflows after the cleanup
- [x] 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