ai-workflow-skill/docs/roadmaps/active/skill-workspace-monorepo-migration.md

Skill Workspace Monorepo Migration

Status

• in_progress

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

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

Files

• docs/roadmaps/active/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

• start Phase 2 by extracting the shared coordination kernel into packages/coord-core, using the new workspace and bundle metadata scaffold as the stable base for subsequent package moves