nccgs 1.0.0

package/CLAUDE.md

@@ -0,0 +1,6 @@
+# NCCGS project bootstrap
+
+@.claude/nccgs/constitution.md
+
+Project-specific decisions live in `.nccgs/project.yaml`. Keep this file small;
+put local additions in that policy file or in canonical project documents.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Donchitos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,162 @@
+# NCCGS
+
+NCCGS is a Unity-first studio operating system for Claude Code. It combines the
+specialization of a full game-development team with project-aware governance,
+bounded orchestration, configurable model routing, official Unity Skills, objective
+evidence, and strict closure.
+
+Version 1.0 contains:
+
+- 45 studio agents across leadership, design, programming, Unity, content, quality,
+  and release;
+- 36 composable NCCGS workflows with eight primary entrypoints;
+- 11 path-scoped project rules;
+- 8 cross-platform Node lifecycle/safety hooks;
+- 22 unmodified official Unity Skills with a SHA-256 manifest;
+- brownfield migration, context packets, evidence records, closure modes, model
+  profiles, installer backup, and behavioral framework tests.
+
+## Operating architecture
+
+```text
+Product Owner
+  -> Claude Code primary orchestrator
+  -> NCCGS policy, context packet, risk and model router
+  -> specialized studio roles (bounded to one delegation level)
+  -> official Unity Skills
+  -> Unity CLI/Pipeline and Editor
+  -> independent evidence, review, and closure
+```
+
+NCCGS does not simulate a hierarchy for ceremony. It selects specialized roles when
+their domain knowledge or isolation improves the result. The primary session owns
+the execution graph, assigns one writer per path, and keeps implementation separate
+from independent verification.
+
+## Install
+
+Requirements: Claude Code, Node.js, a Unity project, and Unity CLI/Pipeline when live
+Editor automation is needed.
+
+Open PowerShell in the Unity project root, or `cd` into it, then run:
+
+```powershell
+npx nccgs@latest install --dry-run
+npx nccgs@latest install
+```
+
+For an existing NCCGS installation:
+
+```powershell
+npx nccgs@latest install --dry-run
+npx nccgs@latest install --force
+```
+
+The current directory is the installation target. `--project <directory>` remains
+available for automation, but is not needed for ordinary use.
+
+The installer validates the package, backs up replaced framework/settings files to
+`.nccgs/backups/<timestamp>/`, copies `.claude/`, initializes missing `.nccgs/`
+scaffold files without overwriting project truth, merges managed hooks into shared
+`.claude/settings.json`, configures agent models, and adds the NCCGS constitution
+import to `CLAUDE.md`.
+
+Select a model profile during installation when needed:
+
+```powershell
+npx nccgs@latest install --force --model-profile quality
+npx nccgs@latest install --force --model-profile balanced
+npx nccgs@latest install --force --model-profile inherit
+```
+
+Open a new Claude Code session after installation. Run `/migrate-project review` for
+an existing project; installing framework files alone is not migration.
+
+## Model routing
+
+| Profile | Lightweight | Standard | Deep | Leadership |
+|---|---|---|---|---|
+| `quality` (default) | Haiku | Sonnet | Opus | Opus |
+| `balanced` | Haiku | Sonnet | Opus | Sonnet |
+| `inherit` | Session model | Session model | Session model | Session model |
+
+Role selection happens before model selection. Risk may escalate a task, but a title
+alone does not justify Opus. If a pinned model is unavailable or conflicts with the
+current context mode, project policy can allow the primary session to continue using
+the inherited model and report the fallback.
+
+Reconfigure an installed project:
+
+```powershell
+node .\.claude\nccgs\tools\configure-models.mjs --project . --profile inherit
+```
+
+## Primary workflows
+
+| Command | Purpose |
+|---|---|
+| `/work` | End-to-end implementation, bug fix, refactor, tooling, or content integration |
+| `/design` | Player-facing design and canonical requirements |
+| `/audit` | Read-only multidomain diagnosis and gap analysis |
+| `/migrate-project` | Review, plan, apply, or verify adoption/upgrades |
+| `/test` | Requirement-based automated/runtime/build verification |
+| `/review` | Independent adversarial review |
+| `/release` | Reproducible release candidate and guarded external actions |
+| `/status` | Current work, roles/models, evidence, blockers, closure, and next action |
+
+Thirty-six discoverable workflows include focused modules for architecture decisions,
+context packets, story readiness, code/design/evidence review, closure, QA planning,
+triage, performance, security, accessibility, balance, prototypes, playtests,
+localization, hotfixes, milestones, assets, compatibility, incidents, and UI review.
+Ordinary natural-language requests still work; the user does not need to manually
+chain these modules.
+
+## Project-owned state
+
+```text
+.nccgs/
+  project.yaml       authority, model, studio, context, ownership and gate policy
+  state.md           compact recovery checkpoint
+  requirements.yaml targeted requirement registry
+  context/           task-specific source and ownership maps
+  features/          persistent STANDARD/CONTROLLED contracts and plans
+  decisions/         durable architecture decisions
+  evidence/          test/runtime/build evidence
+  reviews/           independent review artifacts when persistence adds value
+  closures/          canonical feature closure records
+  migrations/        migration and upgrade plans/ledgers
+  backups/           local installer backups, ignored by Git
+  runtime/           local hook audit events, ignored by Git
+```
+
+Existing GDDs, ADRs, reports, registers, tests, and asset layouts stay where the
+project already owns them. Map their semantic roles in `project.yaml`.
+
+## Official Unity Skills
+
+Unity Skills under `.claude/skills/` are an unmodified snapshot from
+`Unity-Technologies/skills`. NCCGS roles define intent and constraints; official
+skills define current Unity operation mechanics. Project-specific conventions belong
+in `.nccgs/project.yaml`, not in vendored skill files.
+
+```powershell
+node .\scripts\sync-unity-skills.mjs --source "D:\path\to\UnitySkills" --dry-run
+node .\scripts\sync-unity-skills.mjs --source "D:\path\to\UnitySkills"
+npm run validate
+```
+
+## Validate NCCGS
+
+```powershell
+npm run validate
+npm test
+```
+
+Validation covers catalogs, model assignments, delegation boundaries, hooks, schema,
+links, official Unity Skill hashes, and installer structure. Behavioral tests cover
+role references, model reconfiguration, destructive-command blocking, and installer
+dry-run behavior.
+
+See [architecture](docs/ARCHITECTURE.md), [workflows](docs/WORKFLOWS.md),
+[project policy](docs/PROJECT-POLICY.md), [migration matrix](docs/MIGRATION-MATRIX.md),
+and the [Vietnamese migration and usage guide](docs/HUONG-DAN-MIGRATE-VA-SU-DUNG.md).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,23 @@
+# Third-party notices
+
+## Claude Code Game Studios
+
+NCCGS was informed by the workflow, traceability, brownfield adoption, and QA
+ideas in Donchitos/Claude-Code-Game-Studios. The supplied source is MIT licensed.
+NCCGS replaces its multi-engine agent hierarchy rather than redistributing that
+hierarchy verbatim.
+
+Source: https://github.com/Donchitos/Claude-Code-Game-Studios
+
+## Unity Skills
+
+The directories identified in `.claude/nccgs/unity-skills-manifest.json` are an
+unmodified snapshot of Unity Technologies' Unity Skills. Unity Skills are
+copyright Unity Technologies and are governed by the Unity Companion License for
+Unity-dependent projects.
+
+Source: https://github.com/Unity-Technologies/skills
+
+License: https://unity3d.com/legal/licenses/unity_companion_license
+
+Do not remove this notice when redistributing NCCGS with the vendored snapshot.

package/UPGRADING.md

@@ -0,0 +1,32 @@
+# Upgrading NCCGS
+
+Always inspect a dry run and preserve project policy.
+
+```powershell
+cd "D:\path\to\UnityProject"
+npx nccgs@latest install --dry-run
+npx nccgs@latest install --force
+```
+
+Version 1.0 is a framework and policy-schema upgrade from 0.2. The installer updates
+framework files and merges managed hooks, but deliberately does not overwrite an
+existing `.nccgs/project.yaml`. After installation, open a new Claude Code session
+and run:
+
+```text
+/migrate-project review
+/migrate-project plan
+/migrate-project apply
+/migrate-project verify
+/status full
+```
+
+The migration plan must move schema 1 policy to schema 2, choose a model profile,
+enable departments, configure context packets and orchestration, preserve closure
+artifacts, verify hooks, and resolve obsolete global skills. Keep
+`.claude/settings.local.json` local. Commit shared `.claude/` and `.nccgs/`; nested
+`.nccgs/.gitignore` excludes backups and runtime audit events.
+
+Use `--model-profile inherit` during installation if pinned models are unavailable.
+All replaced shared framework/settings files are backed up under
+`.nccgs/backups/<timestamp>/`.

package/VERSION

@@ -0,0 +1 @@
+1.0.0

package/docs/ARCHITECTURE.md

@@ -0,0 +1,73 @@
+# NCCGS architecture
+
+## Design objective
+
+NCCGS optimizes correctness, specialization, context efficiency, recoverability, and
+evidence. File or agent count is not an objective. A component exists when it owns a
+distinct decision surface, failure mode, artifact, or verification lens.
+
+## Layers
+
+1. **Kernel** — constitution, authority, project policy, ownership, state, closure.
+2. **Router** — domain/risk classification, model profile, context packet, execution
+   graph and write ownership.
+3. **Studio roles** — 45 leadership, lead, specialist, Unity, quality, and release
+   agents with shared handoff contracts.
+4. **Workflow modules** — 36 composable skills with eight user-facing entrypoints.
+5. **Unity operations** — unmodified official Unity Skills and Unity CLI/Pipeline.
+6. **Automation** — Node hooks for recovery, audit and safety.
+7. **Evaluation** — structural validation and executable behavioral tests.
+
+## Bounded orchestration
+
+The primary Claude Code session is the sole orchestrator. It constructs a DAG,
+selects the smallest complete role set, passes a context packet, assigns one writer
+per path, and merges handoffs. Studio agents do not recursively delegate.
+
+This preserves domain decomposition while preventing context-amplifying chains such
+as director → lead → engine lead → specialist. Read-only agents may run concurrently;
+overlapping writes are serialized.
+
+## Context architecture
+
+The feature contract stores approved scope. The context packet stores the current
+working-set map: source anchors and revisions, decision summaries, ownership,
+dependencies, verification, and reasons for any full-source read. Agents receive the
+packet path and exact responsibility rather than copies of every canonical document.
+
+State, packets, and handoffs are file-backed so compaction and session restarts do not
+require reconstructing truth from chat history.
+
+## Model architecture
+
+Each catalog role has a capability class: lightweight, standard, deep, or leadership.
+An installation profile compiles that class into agent frontmatter. The package
+defaults to quality but supports balanced and inherit profiles without duplicating
+agent prompts.
+
+The router selects role/domain first and model second. Risk escalation is evidence
+based. Project policy records fallback behavior so model availability failure does
+not become an unexplained task blocker.
+
+## Unity boundary
+
+NCCGS does not copy Unity API/CLI procedures into agent prompts. Studio roles own
+product and technical intent; official Unity Skills own operation mechanics. The
+SHA-256 manifest makes upstream modifications visible.
+
+## Evidence and closure
+
+Implementation and verification are separate work nodes. STANDARD work normally has
+independent verification; CONTROLLED work adds adversarial review. Evidence is mapped
+to requirements and source revision.
+
+One canonical closure record links existing project artifacts. `lean`, `linked`, and
+`strict` policies determine what blocks DONE. Waivers are item-specific and retain
+Product Owner authority.
+
+## Extension rules
+
+Add a role only for a distinct domain contract. Add a workflow when a repeated
+sequence, gate, or artifact benefits from independent discovery and testing. Put
+conditional detail in references. Do not modify official Unity Skills for local
+policy, and do not hard-code one project's paths in framework files.

package/docs/HUONG-DAN-MIGRATE-VA-SU-DUNG.md

@@ -0,0 +1,324 @@
+# Hướng dẫn migrate và sử dụng NCCGS 1.0
+
+NCCGS 1.0 là studio operating system dành cho Unity project trong Claude Code. Nó
+không thay thế cách chat trực tiếp; nó tự phân loại rủi ro, chọn workflow, agent và
+model phù hợp, sử dụng official Unity Skills, thu thập bằng chứng và áp dụng closure.
+
+## 1. Thành phần
+
+- 45 studio agents chuyên biệt.
+- 36 NCCGS workflows; 8 entrypoint chính.
+- 3 model profiles: `quality`, `balanced`, `inherit`.
+- 11 path-scoped rules.
+- 8 Node hooks cho recovery, audit và safety.
+- 22 official Unity Skills giữ nguyên và kiểm tra hash.
+
+```text
+Bạn
+  -> Claude Code chính
+  -> NCCGS router (domain + risk + model)
+  -> studio agents cần thiết
+  -> official Unity Skills + Unity CLI/Pipeline
+  -> evidence + review + closure
+```
+
+Claude Code chính là orchestrator duy nhất. Agent không tự tạo thêm cây subagent.
+Mỗi path chỉ có một writing owner trong một batch.
+
+## 2. Cài mới hoặc cập nhật
+
+Trong PowerShell:
+
+```powershell
+cd "D:\path\to\UnityProject"
+npx nccgs@latest install --dry-run
+npx nccgs@latest install
+```
+
+Nếu project đã có NCCGS:
+
+```powershell
+npx nccgs@latest install --dry-run
+npx nccgs@latest install --force
+```
+
+NCCGS mặc định cài vào directory hiện tại. Bạn không cần truyền đường dẫn project;
+hãy mở PowerShell tại Unity project root hoặc dùng `cd` đến đó trước.
+
+Installer sẽ:
+
+1. validate NCCGS;
+2. backup file framework/settings bị thay thế vào `.nccgs/backups/<timestamp>/`;
+3. cập nhật `.claude/`;
+4. chỉ tạo những scaffold file `.nccgs/` còn thiếu, không ghi đè project truth;
+5. merge NCCGS hooks vào `.claude/settings.json` mà không xóa settings khác;
+6. cấu hình model cho agents;
+7. thêm NCCGS import vào `CLAUDE.md`.
+
+Sau khi cài, đóng phiên Claude Code cũ và mở phiên mới tại project root.
+
+## 3. Chọn model profile
+
+| Profile | Cách dùng |
+|---|---|
+| `quality` | Mặc định; Opus cho deep/leadership, Sonnet cho implementation, Haiku cho việc nhẹ |
+| `balanced` | Giữ Opus cho deep reasoning, leadership thông thường chạy Sonnet |
+| `inherit` | Bỏ toàn bộ model pin; agents dùng model của phiên chính |
+
+Cài với profile cụ thể:
+
+```powershell
+npx nccgs@latest install --force --model-profile quality
+```
+
+Đổi profile trong project đã cài:
+
+```powershell
+node .\.claude\nccgs\tools\configure-models.mjs --project . --profile inherit
+```
+
+Profile được ghi trong `.nccgs/project.yaml`. Nếu model pin không dùng được với tài
+khoản hoặc context mode hiện tại, dùng `inherit` hoặc cho phép inherit fallback.
+
+## 4. Migrate project cũ
+
+Migration gồm bốn bước:
+
+```text
+review -> plan -> apply -> verify
+```
+
+### Review
+
+```text
+/migrate-project review
+```
+
+Review là read-only. Nó phải tìm canonical sources, architecture, ownership,
+protected paths, Unity tooling, tests/baselines, reports/registers/checklists, global
+skills xung đột, model policy, hooks, local settings và Git state.
+
+Mỗi artifact nhận một nhãn: KEEP, ADAPT, MIGRATE, DEPRECATE, REMOVE hoặc MISSING.
+
+### Plan
+
+```text
+/migrate-project plan
+```
+
+Plan phải có policy schema 2 được đề xuất, batches có rollback, model profile,
+departments, context packets, hook merge, Unity integration, verification, closure,
+Git tracking và những quyết định Product Owner cần chốt.
+
+Hai quyết định thường gặp:
+
+```text
+D1: Use strict closure mode. Keep existing implementation reports, register
+entries, evidence, and safety checklists as required linked artifacts. They block
+DONE unless an item-specific Product Owner waiver exists.
+
+D2: Commit shared .claude/ and .nccgs/ framework and policy to Git. Keep
+.claude/settings.local.json local. Ignore only .nccgs/backups/ and .nccgs/runtime/.
+```
+
+### Apply
+
+```text
+/migrate-project apply
+```
+
+Claude áp dụng từng batch, xem diff, validate và cập nhật ledger trước khi sang batch
+tiếp theo. Xóa dữ liệu, đổi canon/gameplay, dependency/service, compatibility hoặc
+migration không thể hoàn tác cần bạn phê duyệt.
+
+### Verify
+
+```text
+/migrate-project verify
+/status full
+```
+
+Verify kiểm tra schema 2, model routing/fallback, 45 agent files, 36 workflow files,
+hooks, context packet, official Unity Skill hashes, CLI/Pipeline, compile/tests,
+baseline, evidence mapping và closure gate.
+
+`VERIFIED, not DONE` không phải lỗi nếu artifact, decision hoặc PO gate còn thiếu.
+
+## 5. Dùng NCCGS hằng ngày
+
+Bạn có thể chat như trước:
+
+```text
+Implement campaign walkthrough sessions C–G from the canonical design documents.
+Preserve protected tuning values and verify the result in Unity.
+```
+
+NCCGS sẽ tự chọn:
+
+- risk tier FAST/STANDARD/CONTROLLED;
+- domains và studio roles;
+- model theo profile;
+- context packet và working set;
+- tests, runtime/build evidence và review cần thiết;
+- closure artifacts và PO gates.
+
+### Entry commands
+
+| Command | Dùng khi |
+|---|---|
+| `/work` | Implement/fix/refactor/integrate hoàn chỉnh |
+| `/design` | Thiết kế hoặc thay đổi player-facing semantics |
+| `/audit` | Chẩn đoán read-only |
+| `/migrate-project` | Cài/migrate/nâng cấp framework |
+| `/test` | Thu thập bằng chứng objective |
+| `/review` | Review độc lập, không sửa |
+| `/release` | Tạo release candidate |
+| `/status` | Xem trạng thái, model, agents, evidence và blockers |
+
+Các workflow chuyên biệt như `/architecture-decision`, `/code-review`,
+`/performance-audit`, `/security-audit`, `/balance-review`, `/playtest`, `/hotfix`,
+`/incident-recovery` có thể gọi trực tiếp, nhưng thông thường `/work` tự phối hợp.
+
+## 6. Context packet
+
+STANDARD và CONTROLLED work dùng:
+
+```text
+.nccgs/context/<feature-id>.yaml
+```
+
+Packet chứa link/anchor tới requirements, decisions, ownership, dependencies và
+verification; nó không copy toàn bộ GDD/ADR. Agent chỉ đọc full source khi summary
+thiếu, stale, mâu thuẫn hoặc risk yêu cầu.
+
+Nếu muốn chuẩn bị riêng:
+
+```text
+/context-pack FEATURE-ID
+/story-readiness FEATURE-ID
+/plan-feature FEATURE-ID
+```
+
+## 7. Model và agents hoạt động thế nào?
+
+NCCGS chọn domain role trước rồi áp model class. Ví dụ:
+
+```text
+CONTROLLED save migration
+  -> technical architect (Opus)
+  -> engine/network specialists (Sonnet)
+  -> verification engineer (Sonnet)
+  -> adversarial reviewer (Opus)
+```
+
+Một bug FAST thường không gọi cả studio. Một feature UI STANDARD có thể dùng UX,
+accessibility, UI programmer, Unity UI specialist và verification, nhưng các phần
+read-only/không trùng ownership mới được chạy song song.
+
+## 8. Evidence và closure
+
+- IMPLEMENTED: thay đổi tồn tại.
+- VERIFIED: bằng chứng objective chứng minh requirement.
+- VALIDATED: subjective gate đã được bạn chấp nhận.
+- DONE: mọi objective, artifact và PO gate bắt buộc đã đóng.
+
+Implementation không tự chứng minh chính nó. STANDARD work nên có independent
+verification; CONTROLLED work có adversarial review.
+
+Closure modes:
+
+- `lean`: closure record đủ, link khác optional;
+- `linked`: artifact `required` chặn DONE;
+- `strict`: mọi artifact/checklist khai báo chặn DONE nếu không có waiver cụ thể.
+
+Không hạ closure mode chỉ để trạng thái chuyển xanh.
+
+## 9. Git
+
+Khuyến nghị commit:
+
+```text
+.claude/
+.nccgs/
+CLAUDE.md
+```
+
+Không commit:
+
+```text
+.claude/settings.local.json
+.nccgs/backups/
+.nccgs/runtime/
+```
+
+Nested `.nccgs/.gitignore` đã bỏ qua backup và runtime events.
+
+Sau migration:
+
+```powershell
+git add .claude .nccgs CLAUDE.md
+git status --short
+git commit -m "chore: adopt NCCGS 1.0 studio workflow"
+```
+
+Luôn đọc diff trước commit.
+
+## 10. Xử lý blocker thường gặp
+
+### Global Unity MCP skill còn hoạt động
+
+Di chuyển/xóa legacy global skill khỏi user skills directory, mở phiên Claude mới,
+rồi chạy `/status full`. Đây không phải 22 official Unity Skills trong project.
+
+### Report thiếu register entry
+
+Đọc từng report, dùng report và Git history để backfill. Không đoán commit. Nếu không
+xác định được, ghi unknown và để item bị block cho tới khi có quyết định/waiver riêng.
+
+### Model agent không spawn được
+
+Chuyển sang `inherit`, mở phiên mới và verify routing. Đừng coi lỗi model/context là
+lỗi implementation.
+
+### `project.yaml` vẫn schema 1/template
+
+Installer không ghi đè policy. Chạy lại migration plan/apply để nâng schema và map
+project truth.
+
+### Hook xung đột settings cũ
+
+Xem `.claude/settings.json` và bản backup timestamp. Installer chỉ thay các hook có
+command `.claude/nccgs/hooks/`, giữ nhóm hook và permission khác.
+
+## 11. Validate và rollback
+
+Trong NCCGS source:
+
+```powershell
+npm run validate
+npm test
+```
+
+Nếu upgrade lỗi, dừng thay đổi mới, xem `.nccgs/backups/<timestamp>/`, phục hồi đúng
+file framework/settings hoặc Git revert commit nâng cấp, mở phiên mới, rồi chạy
+`/migrate-project verify`. Không dùng destructive reset khi worktree còn dữ liệu.
+
+## 12. Checklist hoàn tất migration
+
+- [ ] Project policy dùng schema 2.
+- [ ] Canonical sources và ownership được map.
+- [ ] Model profile/fallback được quyết định.
+- [ ] Departments và orchestration depth được cấu hình.
+- [ ] Context packet mẫu hoạt động.
+- [ ] Managed Node hooks hoạt động.
+- [ ] Official Unity Skills khớp manifest.
+- [ ] Unity CLI/Pipeline và compile/tests đạt baseline.
+- [ ] D1 closure và D2 Git tracking được ghi nhận.
+- [ ] Legacy routing conflicts được xử lý.
+- [ ] Closure gate chặn đúng artifact thiếu.
+- [ ] Representative `/work` path thành công.
+- [ ] `/status full` không còn blocker ngoài ý muốn.
+- [ ] Framework/policy đã được commit.
+
+Sau đó quay lại feature sản phẩm có giá trị cao nhất; không tiếp tục làm framework
+nếu không còn blocker thực tế.

package/docs/MIGRATION-MATRIX.md

@@ -0,0 +1,23 @@
+# CCGS to NCCGS 1.0 migration matrix
+
+| CCGS capability | NCCGS 1.0 treatment | Reason |
+|---|---|---|
+| Three-tier studio hierarchy | ADAPT into 44 roles and a central one-level orchestrator | Preserve specialization without recursive context chains |
+| Opus/Sonnet/Haiku agent pins | ADAPT into quality/balanced/inherit profiles | Preserve model routing while handling compatibility and cost |
+| 73 large workflow skills | ADAPT into 36 composable workflows and focused references | Preserve lifecycle coverage without repeated prompt/context payload |
+| Team commands spawning departments | MIGRATE to risk/domain execution DAGs | Select roles by deliverable, not ceremony |
+| Per-file approval protocol | REMOVE for ordinary authorized implementation | Keep approval at product, compatibility, dependency and irreversible boundaries |
+| Fixed `src/design/production` layout | MIGRATE to semantic canonical-source mapping | Support existing Unity repositories without moving truth |
+| Full ADR rereads per story | REMOVE; use revisioned context packets and anchored summaries | Avoid duplicated context and stale contracts |
+| Bash lifecycle hooks | MIGRATE to managed Node hooks | Cross-platform behavior and deterministic validation |
+| Agent audit/session recovery | KEEP and move to `.nccgs/runtime` plus state/context packets | Preserve observability without Git churn |
+| Rules for code/content domains | ADAPT to Unity paths plus project policy | Keep scoped constraints without assuming one architecture |
+| Multiple reports/checklists | KEEP as linked closure artifacts | Preserve data-loss and compliance safeguards |
+| Engine-specific agents for three engines | Package design supports profiles; Unity installation activates Unity roles | Avoid routing competition inside a Unity project |
+| Unity agent operation instructions | MIGRATE to official Unity Skills | One current, hash-verified operational source |
+| Skill testing framework specs | ADAPT into catalog validation and executable behavior tests | Test observable invariants, not wording alone |
+| User memory in directors | MIGRATE to project files/state/context | Prevent cross-project memory bleed and staleness |
+
+NCCGS keeps CCGS's breadth where specialization improves results and replaces only
+mechanisms that duplicate context, hard-code layout, fragment authority, or obscure
+accountability.