Bỏ qua để đến nội dung
DOL Wiki

Repo-level Domain Workspace Migration Implementation Plan

Plans601 words3 min read
active

Execution note: Use executing-plans to implement this plan task-by-task.

Goal: Chuyển repo sang mô hình domain-first ở cấp workspace, trong đó Domains/** là cửa vào chính cho tài liệu sản phẩm và Shared/** là cửa vào chính cho tài liệu dùng chung.

Architecture: Domain trở thành trục cấp repo. Mỗi domain có 3 workspace chuẩn: Product Discovery, Feature Package, UX Design. Product Discovery, Feature Package, Design System, Knowledge Base, và Operations đã được đưa vào home mới trong docs/Domains/** hoặc docs/Shared/**. Ecosystem UX canon nằm tại docs/Shared/Shared Capabilities/Ecosystem Experience/**. AI routing đổi sang thứ tự domain -> workspace -> surface -> shared -> support.

Tech Stack: Markdown docs, context routers (docs/context/*.mdc), AI rules (.agent/rules/*.md), context verification scripts.

Task 1: Create repo-level entry skeleton

Phần tiêu đề “Task 1: Create repo-level entry skeleton”

Files:

Step 1: Build the repo-level skeleton

  • Create Domains/** and Shared/** at repo level.
  • Write concise overview docs that explain what belongs there and what remains source bridge.

Step 2: Keep boundaries explicit

  • Lock the rule that domain narrative belongs in docs/Domains/**.
  • Lock the rule that docs/Shared/** only contains shared workspaces.

Task 2: Add domain workspace overviews

Phần tiêu đề “Task 2: Add domain workspace overviews”

Files:

  • Create: docs/Domains/DOL English/**
  • Create: docs/Domains/DOL Academy/**
  • Create: docs/Domains/DOL Kid/**

Step 1: Add one domain root per domain

  • Each root overview must point to Product Discovery, Feature Package, and UX Design.

Step 2: Add one workspace overview per lane

  • English gets a fully mapped bridge because it is the current baseline.
  • Academy and Kid get clear skeletons with honest reserved skeleton status where source material is still thin.

Task 3: Repoint AI routing and contributor guidance

Phần tiêu đề “Task 3: Repoint AI routing and contributor guidance”

Files:

  • Modify: docs/README.md
  • Modify: .agent/rules/rule-domain-split-guard.md
  • Modify: docs/context/base-context-index.mdc
  • Modify: docs/context/domains.mdc
  • Create: docs/context/shared-workspaces.mdc

Step 1: Update repo navigation docs

  • Make docs/Domains/** the main domain-first entry.
  • Make docs/Shared/** the main shared entry.

Step 2: Update AI rules

  • Add workspace as a required routing dimension.
  • Keep UX Design as the default workspace only when prompt type is still ambiguous.

Task 4: Demote stale claims in UX-only bridge docs

Phần tiêu đề “Task 4: Demote stale claims in UX-only bridge docs”

Files:

Step 1: Re-label the UX-only bridge

  • These docs should describe themselves as UX workspace docs, not repo-wide entry docs.

Step 2: Link back to repo-level structure

  • Add references to docs/Domains/** and docs/Shared/** so AI does not stop too early in UX Design.

Task 5: Verify and keep the migration reversible

Phần tiêu đề “Task 5: Verify and keep the migration reversible”

Files:

  • Verify: docs/context/*.mdc
  • Verify: docs/Domains/**
  • Verify: docs/Shared/**

Step 1: Run verification gates

  • Run: npm run context:guard
  • Run: npm run context:benchmark
  • Run: npm run context:stale
  • Expected: all pass.

Step 2: Run commit preview

  • Run: npm run docs:commit:preview
  • Expected: preview shows changed docs without committing.

Definition of Done

Phần tiêu đề “Definition of Done”
  • docs/Domains/** exists and is readable as the repo-level domain entry.
  • docs/Shared/** exists and is readable as the repo-level shared entry.
  • docs/context and .agent/rules route AI via domain -> workspace.
  • docs/Domains/DOL English/Product Discovery/** and docs/Domains/DOL English/Feature Package/** remain active English workspace bodies; ecosystem UX canon no longer depends on a root docs/UX Design/** bridge.
  • context:guard, context:benchmark, and context:stale all pass.