# Skill Workspace Monorepo Migration

## Status

- `completed`

## Owner

- Codex

## Started At

- `2026-03-20`

## Goal

- Execute `Milestone 10: Skill Workspace Monorepo Migration` by moving the repository toward a true multi-package monorepo whose primary deliverables are skills and skill runtimes.

## Scope

- bootstrap the shared workspace structure described in `docs/skill-workspace-monorepo.md`
- complete migration phases incrementally, committing after each completed phase
- keep packaging, roadmap, and validation flows synchronized as the migration proceeds

## Checklist

- [x] create or adopt an active execution roadmap for the migration workstream
- [x] Phase 1: bootstrap `go.work`, expanded workspace manifests, package roots, and declarative skill bundle metadata
- [x] Phase 2: extract shared coordination code into `packages/coord-core`
- [x] Phase 3: extract `inbox-runtime` and `orch-runtime`
- [x] Phase 4: extract `orchd-runtime`
- [x] Phase 5: import `repo-memory-runtime` and add `skills/repo-memory`
- [x] Phase 6: remove root runtime ownership and normalize package-based packaging

## Files

- `docs/roadmaps/archive/skill-workspace-monorepo-migration.md`
- `docs/skill-workspace-monorepo.md`
- `docs/implementation-roadmap.md`
- `go.work`
- `pnpm-workspace.yaml`
- `package.json`
- `packages/`
- `scripts/`

## Decisions

- keep one long-lived active roadmap for the full migration rather than opening a new execution trace for every individual phase
- complete and commit one migration phase at a time so the workspace remains bisectable

## Blockers

- none

## Next Step

- resume product work on top of the package-owned runtime workspace, starting with whichever user-facing feature slice has priority next

## Completion Summary

- bootstrapped the repository as a multi-package workspace with `go.work`, expanded JS workspace discovery, and declarative skill bundle metadata
- extracted the shared coordination kernel into `packages/coord-core`
- extracted package-owned runtimes for `inbox`, `orch`, `orchd`, and `repo-memory`
- switched the root skill packaging flow to build from package entrypoints, including the new `repo-memory` bundle
- removed the legacy root runtime implementation directories under `internal/`, leaving root `cmd/*` as compatibility shims while package-owned runtimes remain the source of truth