nccgs 1.0.0 → 1.1.1

package/.claude/nccgs/VERSION

@@ -1 +1 @@
-1.0.0
+1.1.1

package/.claude/nccgs/tools/approve-overrides.mjs

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { fingerprintFile } from "./integrity.mjs";
+
+const ownDir = path.dirname(fileURLToPath(import.meta.url));
+const args = process.argv.slice(2);
+const projectArg = args.indexOf("--project");
+const project = path.resolve(projectArg >= 0 ? args[projectArg + 1] : path.resolve(ownDir, "../../../.."));
+const approvePending = args.includes("--approve-pending");
+const manifestPath = path.join(project, ".nccgs", "framework-overrides.json");
+
+if (projectArg >= 0 && !args[projectArg + 1]) {
+  console.error("--project requires a directory path.");
+  process.exit(2);
+}
+if (!fs.existsSync(manifestPath)) {
+  console.log("No NCCGS framework overrides are recorded.");
+  process.exit(0);
+}
+
+let manifest;
+try { manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8")); }
+catch (error) {
+  console.error(`Invalid framework override manifest: ${error.message}`);
+  process.exit(2);
+}
+if (manifest.schemaVersion !== 1) {
+  console.error(`Unsupported framework override schema: ${manifest.schemaVersion ?? "unknown"}`);
+  process.exit(2);
+}
+for (const item of manifest.overrides ?? []) {
+  if (!isManagedRelative(item.path) || !new Set(["preserve", "absent"]).has(item.disposition)
+      || !new Set(["approved", "pending_review"]).has(item.status)) {
+    console.error(`Invalid framework override record: ${item.path ?? "path missing"}`);
+    process.exit(2);
+  }
+}
+
+const pending = (manifest.overrides ?? []).filter((item) => item.status !== "approved");
+if (!approvePending) {
+  if (!pending.length) console.log("All NCCGS framework overrides are approved.");
+  else {
+    console.log(`${pending.length} NCCGS framework override(s) await migration review:`);
+    for (const item of pending) console.log(`- ${item.path} (${item.disposition})`);
+    console.log("After reviewing/rebasing every item, run again with --approve-pending.");
+  }
+  process.exit(pending.length ? 1 : 0);
+}
+
+for (const item of pending) {
+  const file = path.join(project, ...item.path.split("/"));
+  if (item.disposition === "absent") {
+    if (fs.existsSync(file)) {
+      console.error(`Cannot approve absent override because the file exists: ${item.path}`);
+      process.exit(2);
+    }
+    item.sha256 = null;
+    item.canonicalSha256 = null;
+  } else {
+    if (!fs.existsSync(file)) {
+      console.error(`Cannot approve preserved override because the file is missing: ${item.path}`);
+      process.exit(2);
+    }
+    Object.assign(item, fingerprintFile(file));
+  }
+  item.status = "approved";
+  item.reviewedAt = new Date().toISOString();
+}
+
+manifest.updatedAt = new Date().toISOString();
+fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+console.log(`Approved ${pending.length} NCCGS framework override(s) after migration review.`);
+
+function isManagedRelative(value) {
+  if (typeof value !== "string" || !value.startsWith(".claude/")) return false;
+  const parts = value.split("/");
+  return !parts.includes("") && !parts.includes(".") && !parts.includes("..");
+}

package/.claude/nccgs/tools/configure-models.mjs

@@ -6,6 +6,10 @@ const ownDir = path.dirname(fileURLToPath(import.meta.url));
 const args = process.argv.slice(2);
 const projectArg = args.indexOf("--project");
 const profileArg = args.indexOf("--profile");
+const skippedPaths = new Set();
+for (let index = 0; index < args.length; index++) {
+  if (args[index] === "--skip-path" && args[index + 1]) skippedPaths.add(args[index + 1].replace(/\\/g, "/"));
+}
 const project = path.resolve(projectArg >= 0 ? args[projectArg + 1] : path.resolve(ownDir, "../../../.."));
 const catalogPath = path.join(project, ".claude", "nccgs", "studio.json");
 const catalog = JSON.parse(fs.readFileSync(catalogPath, "utf8"));
@@ -19,6 +23,7 @@ if (!profile) throw new Error(`Unknown model profile '${profileName}'. Expected:
 let changed = 0;
 for (const agent of catalog.agents) {
   const file = path.join(project, ".claude", "agents", `${agent.name}.md`);
+  if (skippedPaths.has(`.claude/agents/${agent.name}.md`)) continue;
   if (!fs.existsSync(file)) continue;
   let text = fs.readFileSync(file, "utf8");
   const model = profile[agent.modelClass];

package/.claude/nccgs/tools/integrity.mjs

@@ -0,0 +1,69 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+
+const utf8 = new TextDecoder("utf-8", { fatal: true });
+
+export function sha256(value) {
+  return crypto.createHash("sha256").update(value).digest("hex");
+}
+
+export function textContent(value) {
+  const buffer = Buffer.isBuffer(value) ? value : Buffer.from(value);
+  if (buffer.includes(0)) return null;
+  try { return utf8.decode(buffer); }
+  catch { return null; }
+}
+
+export function normalizeLf(value) {
+  const text = textContent(value);
+  if (text === null) return null;
+  return `${text.replace(/\r\n?/g, "\n").replace(/\n*$/, "")}\n`;
+}
+
+export function fingerprintBuffer(value) {
+  const buffer = Buffer.isBuffer(value) ? value : Buffer.from(value);
+  const normalized = normalizeLf(buffer);
+  return {
+    sha256: sha256(buffer),
+    ...(normalized === null ? {} : { canonicalSha256: sha256(Buffer.from(normalized, "utf8")) })
+  };
+}
+
+export function fingerprintFile(file) {
+  return fingerprintBuffer(fs.readFileSync(file));
+}
+
+export function equivalentBuffers(left, right) {
+  const a = fingerprintBuffer(left);
+  const b = fingerprintBuffer(right);
+  if (a.sha256 === b.sha256) return true;
+  return Boolean(a.canonicalSha256 && a.canonicalSha256 === b.canonicalSha256);
+}
+
+export function equivalentFiles(left, right) {
+  return equivalentBuffers(fs.readFileSync(left), fs.readFileSync(right));
+}
+
+export function matchesFingerprint(file, expected) {
+  if (!expected || !fs.existsSync(file)) return false;
+  const buffer = fs.readFileSync(file);
+  const actual = fingerprintBuffer(buffer);
+  if (expected.sha256 && actual.sha256 === expected.sha256) return true;
+  if (expected.canonicalSha256 && actual.canonicalSha256 === expected.canonicalSha256) return true;
+
+  // NCCGS 1.1.0 stored only a raw hash. Accept the two normal Git text
+  // representations so a checkout's LF policy does not manufacture drift.
+  if (expected.sha256 && actual.canonicalSha256) {
+    const lf = normalizeLf(buffer);
+    if (sha256(Buffer.from(lf, "utf8")) === expected.sha256) return true;
+    const crlf = lf.replace(/\n/g, "\r\n");
+    if (sha256(Buffer.from(crlf, "utf8")) === expected.sha256) return true;
+  }
+  return false;
+}
+
+export function sameFingerprint(left, right) {
+  if (!left || !right) return false;
+  if (left.sha256 && right.sha256 && left.sha256 === right.sha256) return true;
+  return Boolean(left.canonicalSha256 && right.canonicalSha256 && left.canonicalSha256 === right.canonicalSha256);
+}

package/.claude/nccgs/workflow-catalog.json

@@ -130,7 +130,7 @@
       "defaultClassification": "STANDARD"
     },
     {
-      "name": "code-review",
+      "name": "nccgs-code-review",
       "type": "module",
       "primaryRoles": [
         "nccgs-programming-lead"

package/.claude/skills/migrate-project/SKILL.md

@@ -6,16 +6,20 @@ allowed-tools: Read, Glob, Grep, Write, Edit, Bash, Task, AskUserQuestion
 
 # Migrate project
 
-Treat brownfield adoption and NCCGS upgrades as CONTROLLED work. Read the complete [migration procedure](references/procedure.md). Default to `review` when no mode is given.
+Treat brownfield adoption and migrations explicitly requested by the installer as CONTROLLED work. Read the complete [migration procedure](references/procedure.md). Default to `full` when no mode is given. Do not require migration merely because NCCGS was updated when the installer reported `No project migration required`.
+
+When `.nccgs/framework-overrides.json` exists, treat every `pending_review` entry as preserved project truth, not installer debris. Compare the project version with the current NCCGS version, keep or rebase the customization deliberately, and record the decision in the migration plan. Only after every pending item has been reviewed and the final bytes or intentional absence are correct, run `node .claude/nccgs/tools/approve-overrides.mjs --project . --approve-pending`. Never approve first to make `doctor` green.
 
 ## Modes
 
+- `full` (default): run review, plan, apply, and verify in one invocation. Continue across phase boundaries without asking for ceremonial approval. Pause only for an unresolved Product Owner decision, destructive action, external side effect, or authority outside the current request.
 - `review`: read-only inventory and KEEP/ADAPT/MIGRATE/DEPRECATE/REMOVE/MISSING classification.
 - `plan`: write a dated reversible plan and proposed schema-2 policy without overwriting project truth.
 - `apply`: execute an approved plan in validated batches with backups.
 - `verify`: prove policy, routing, hooks, Unity integration, evidence, closure, and a representative work path.
 
-Migration decisions must cover canonical sources, ownership/protected paths, architecture, Unity tooling, model profile/fallback, enabled departments, context packets, verification baselines, closure safeguards, Git tracking, local settings, obsolete global skills, and rollback.
+Migration decisions must cover canonical sources, ownership/protected paths, architecture, Unity tooling, model profile/fallback, enabled departments, context packets, verification baselines, closure safeguards, Git tracking, local settings, preserved framework overrides, obsolete global skills, and rollback.
 
-Never remove reports, registers, checklists, user settings, source assets, or legacy instructions until their live purpose is mapped and the Product Owner approves the replacement. Do not infer canon from code. Return batches, commits, preserved evidence, unresolved decisions, rollback, and final migration state.
+In `full` mode, write the plan before applying it, preserve the same evidence and rollback guarantees as the individual modes, and stop safely if review finds a decision that would materially change project truth. A reversible plan created within the same invocation is approved for in-scope application unless project policy explicitly requires a separate approval.
 
+Never remove reports, registers, checklists, user settings, source assets, or legacy instructions until their live purpose is mapped and the Product Owner approves the replacement. Do not infer canon from code. Return batches, commits, preserved evidence, unresolved decisions, rollback, and final migration state.

package/.claude/skills/migrate-project/references/procedure.md

@@ -1,5 +1,17 @@
 # Brownfield migration procedure
 
+## Full run
+
+`/migrate-project` without a mode executes Review -> Plan -> Apply -> Verify as one
+CONTROLLED operation. Keep the phase boundaries in the migration record, but do not
+make the user invoke each phase separately. Continue automatically when changes are
+reversible, backed up, within the requested adoption/migration scope, and do not
+alter unresolved project truth. Stop before apply only when review exposes a genuine
+Product Owner decision, destructive action, external side effect, or authority gap.
+
+If the NCCGS installer and current schema indicate that an ordinary framework update
+requires no project migration, report that fact and do not manufacture migration work.
+
 ## Review
 
 1. Inspect repository status and project root without modifying it.
@@ -16,6 +28,10 @@
    strongest active safeguard until the PO explicitly accepts a weaker model.
 7. Determine the project model profile, enabled departments, permitted fallback,
    orchestration depth/parallelism, context-packet locations, and hook compatibility.
+8. If `.nccgs/framework-overrides.json` exists, inspect every override. Diff its
+   preserved bytes or intentional absence against the installed upstream version,
+   and distinguish a still-needed project policy from a customization now supplied
+   by NCCGS. Line-ending-only differences are not overrides.
 
 ## Plan
 
@@ -30,6 +46,7 @@ Create `.nccgs/migrations/<date>-migration-plan.md` with:
 - ordered reversible batches and dependencies;
 - exact broad/irreversible decisions requiring PO authority;
 - backup/rollback method;
+- an explicit KEEP/REBASE/RETIRE decision for every pending framework override;
 - validation for each batch and final end-to-end proof.
 
 Prioritize authority and policy conflicts, then model/routing conflicts, Unity
@@ -52,6 +69,12 @@ traceability/evidence, lifecycle hooks, workflow replacement, and cleanup.
 - Do not leave two active agents/skills advertising mutually exclusive Unity
   execution bridges. Disable obsolete global routing signals outside the repository
   through an explicit user action.
+- Preserve pending framework overrides while reviewing them. Rebase each retained
+  override onto the newly installed upstream content when needed. After all entries
+  match the migration decisions, run
+  `node .claude/nccgs/tools/approve-overrides.mjs --project . --approve-pending`.
+  Approval records the final hashes; it is the last apply step, never a substitute
+  for the review.
 
 ## Verify
 
@@ -60,4 +83,5 @@ role/workflow catalogs, bounded delegation, hook health, context packet freshnes
 canonical map, requirements/state, Unity Skills integrity, CLI/Pipeline operation,
 relevant tests, runtime evidence, and subjective-gate routing. Verify that required
 linked artifacts block DONE in `linked` or `strict` mode. Use a small representative
-task or dry run when product changes are not authorized.
+task or dry run when product changes are not authorized. Run `npx nccgs@latest doctor`
+and require zero pending framework overrides before declaring migration complete.

package/.claude/skills/{code-review → nccgs-code-review}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: code-review
+name: nccgs-code-review
 description: Performs a read-only code review against requirements, architecture, Unity constraints, ownership, tests, performance, security, and regression risk.
 allowed-tools: Read, Glob, Grep, Bash, Task
 ---
@@ -11,4 +11,3 @@ Read `.nccgs/project.yaml`, `.nccgs/state.md`, and the active context packet whe
 Read the context packet, final diff, governing decisions, affected callers, and tests. Route distinct Unity, networking, security, performance, or UI lenses when needed. Report only actionable findings with severity, exact evidence, impact, and remediation direction. Verify that tests assert requirements and that serialized/lifecycle behavior is addressed. Do not edit or praise generally; state when no material issue is found.
 
 Return outcome, evidence, affected records, blockers or decisions, residual risk, and the exact next workflow. Do not claim DONE unless this is the `closure` skill and every configured gate passes.
-

package/README.md

@@ -5,7 +5,7 @@ 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:
+Version 1.1.1 contains:
 
 - 45 studio agents across leadership, design, programming, Unity, content, quality,
   and release;
@@ -48,13 +48,21 @@ npx nccgs@latest install
 For an existing NCCGS installation:
 
 ```powershell
-npx nccgs@latest install --dry-run
-npx nccgs@latest install --force
+npx nccgs@latest update --dry-run
+npx nccgs@latest update
+npx nccgs@latest doctor
 ```
 
 The current directory is the installation target. `--project <directory>` remains
 available for automation, but is not needed for ordinary use.
 
+Updates are hash-aware and line-ending-aware. Files that still match the previous
+install state update automatically even when Git converted CRLF to LF. Genuine
+project modifications are preserved, recorded in `.nccgs/framework-overrides.json`,
+and routed through one `/migrate-project` review instead of blocking the whole
+framework update. `--force` remains an explicit discard-and-replace escape hatch;
+it is not the normal upgrade path.
+
 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
@@ -64,13 +72,16 @@ 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
+npx nccgs@latest update --model-profile quality
+npx nccgs@latest update --model-profile balanced
+npx nccgs@latest update --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.
+Open a new Claude Code session after first-time adoption of an existing project and
+run `/migrate-project` once. It performs review, plan, apply, and verify as one
+CONTROLLED operation, pausing only for a real Product Owner decision or unsafe side
+effect. Ordinary framework updates report `No project migration required` and need
+no Claude migration command.
 
 ## Model routing
 
@@ -105,7 +116,7 @@ node .\.claude\nccgs\tools\configure-models.mjs --project . --profile inherit
 | `/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,
+context packets, story readiness, NCCGS 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
@@ -116,6 +127,7 @@ chain these modules.
 ```text
 .nccgs/
   project.yaml       authority, model, studio, context, ownership and gate policy
+  framework-overrides.json  reviewed project-specific framework customizations
   state.md           compact recovery checkpoint
   requirements.yaml targeted requirement registry
   context/           task-specific source and ownership maps

package/UPGRADING.md

@@ -4,23 +4,40 @@ 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
+npx nccgs@latest update --dry-run
+npx nccgs@latest update
+npx nccgs@latest doctor
 ```
 
-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:
+Version 1.1.1 makes updates hash-aware, line-ending-aware, and override-aware.
+Managed files that still match the previous install state update automatically;
+CRLF/LF conversion alone is accepted as the same text. Genuine project-modified or
+intentionally missing framework files are preserved and recorded in
+`.nccgs/framework-overrides.json` as `pending_review`. The rest of the framework is
+updated normally, so `--force` is no longer required to get past intentional local
+customizations. Existing `.nccgs/project.yaml` remains project-owned and is never
+blindly overwritten.
+
+When pending overrides are reported, open a fresh Claude Code session and run
+`/migrate-project` once. The workflow reviews and rebases each override, migrates the
+project policy when needed, and records approval of the final hashes. A direct
+`doctor` remains red until pending override review is complete. Use `--force` only
+when you intentionally want to back up and discard every detected customization.
+
+NCCGS 1.1.1 also names its specialized review command `/nccgs-code-review` to avoid
+colliding with Claude Code's built-in `/code-review` command.
+
+When the installer reports that project migration is required, open a new Claude
+Code session and run one command:
 
 ```text
-/migrate-project review
-/migrate-project plan
-/migrate-project apply
-/migrate-project verify
+/migrate-project
 /status full
 ```
 
+The workflow retains review, plan, apply, and verify internally. Do not run it after
+an ordinary update when the installer reports `No project migration required`.
+
 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

package/VERSION

@@ -1 +1 @@
-1.0.0
+1.1.1

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

@@ -1,6 +1,6 @@
-# Hướng dẫn migrate và sử dụng NCCGS 1.0
+# Hướng dẫn migrate và sử dụng NCCGS 1.1.1
 
-NCCGS 1.0 là studio operating system dành cho Unity project trong Claude Code. Nó
+NCCGS 1.1.1 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.
 
@@ -38,13 +38,21 @@ npx nccgs@latest install
 Nếu project đã có NCCGS:
 
 ```powershell
-npx nccgs@latest install --dry-run
-npx nccgs@latest install --force
+npx nccgs@latest update --dry-run
+npx nccgs@latest update
+npx nccgs@latest doctor
 ```
 
 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.
 
+Từ 1.1.1, update kiểm tra cả raw hash và hash text đã chuẩn hóa line ending. Việc Git
+đổi CRLF/LF không còn bị báo nhầm là sửa file. File thật sự đã customize hoặc cố ý
+xóa sẽ được giữ nguyên, ghi vào `.nccgs/framework-overrides.json` với trạng thái
+`pending_review`, còn các file an toàn khác vẫn cập nhật bình thường. Sau đó chỉ cần
+chạy `/migrate-project` một lần để review/rebase và phê duyệt các override. Không cần
+`--force`; chỉ dùng cờ đó khi thực sự muốn backup rồi loại bỏ customization.
+
 Installer sẽ:
 
 1. validate NCCGS;
@@ -55,6 +63,10 @@ Installer sẽ:
 6. cấu hình model cho agents;
 7. thêm NCCGS import vào `CLAUDE.md`.
 
+Nếu installer báo `Project migration required`, mở Claude Code session mới và chạy
+`/migrate-project`. `doctor` trực tiếp sẽ tiếp tục báo pending cho tới khi workflow
+đã review xong mọi override; đây là safety gate có chủ đích.
+
 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
@@ -68,7 +80,7 @@ Sau khi cài, đóng phiên Claude Code cũ và mở phiên mới tại project
 Cài với profile cụ thể:
 
 ```powershell
-npx nccgs@latest install --force --model-profile quality
+npx nccgs@latest update --model-profile quality
 ```
 
 Đổi profile trong project đã cài:
@@ -82,12 +94,17 @@ khoản hoặc context mode hiện tại, dùng `inherit` hoặc cho phép inher
 
 ## 4. Migrate project cũ
 
-Migration gồm bốn bước:
+Thông thường chỉ cần gọi một command:
 
 ```text
-review -> plan -> apply -> verify
+/migrate-project
 ```
 
+NCCGS vẫn thực hiện bốn phase `review -> plan -> apply -> verify` ở bên trong một
+lần chạy. Nó chỉ dừng khi có quyết định Product Owner thật sự, thao tác destructive,
+external side effect hoặc thiếu authority. Các mode riêng dưới đây vẫn tồn tại để
+debug hoặc kiểm soát thủ công.
+
 ### Review
 
 ```text
@@ -175,7 +192,7 @@ NCCGS sẽ tự chọn:
 | `/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`,
+Các workflow chuyên biệt như `/architecture-decision`, `/nccgs-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.
 
@@ -258,7 +275,7 @@ Sau migration:
 ```powershell
 git add .claude .nccgs CLAUDE.md
 git status --short
-git commit -m "chore: adopt NCCGS 1.0 studio workflow"
+git commit -m "chore: adopt NCCGS 1.1 studio workflow"
 ```
 
 Luôn đọc diff trước commit.

package/docs/MIGRATION-MATRIX.md

@@ -1,6 +1,6 @@
-# CCGS to NCCGS 1.0 migration matrix
+# CCGS to NCCGS 1.1 migration matrix
 
-| CCGS capability | NCCGS 1.0 treatment | Reason |
+| CCGS capability | NCCGS 1.1 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 |

package/docs/WORKFLOWS.md

@@ -33,7 +33,7 @@ available when a user wants a bounded workflow or output.
 - **Design**: `design`, `design-review`, `balance-review`, `accessibility-review`,
   `ui-review`, `prototype-feature`, `playtest`.
 - **Technical**: `architecture-decision`, `dependency-review`,
-  `compatibility-review`, `code-review`, `performance-audit`, `security-audit`.
+  `compatibility-review`, `nccgs-code-review`, `performance-audit`, `security-audit`.
 - **Implementation/quality**: `work`, `qa-plan`, `test`, `bug-triage`,
   `evidence-review`, `review`, `asset-audit`, `closure`.
 - **Delivery/recovery**: `release-readiness`, `release`, `hotfix`,

package/package-assets/nccgs-project.gitignore

@@ -0,0 +1,2 @@
+backups/
+runtime/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nccgs",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Unity-first game-studio operating system for Claude Code",
   "license": "MIT",
   "type": "module",

package/scripts/cli.mjs

@@ -19,13 +19,15 @@ if (command === "version" || command === "--version" || command === "-v") {
   process.exit(0);
 }
 
-if (command !== "install") {
+if (!new Set(["install", "update", "doctor"]).has(command)) {
   console.error(`Unknown command: ${command}`);
   printHelp();
   process.exit(2);
 }
 
-const result = spawnSync(process.execPath, [path.join(scriptDir, "install.mjs"), ...args], {
+const script = command === "doctor" ? "doctor.mjs" : "install.mjs";
+const forwardedArgs = command === "update" ? ["--update-only", ...args] : args;
+const result = spawnSync(process.execPath, [path.join(scriptDir, script), ...forwardedArgs], {
   cwd: process.cwd(),
   stdio: "inherit"
 });
@@ -41,6 +43,8 @@ function printHelp() {
 
 Usage:
   nccgs install [options]
+  nccgs update [options]
+  nccgs doctor [options]
   nccgs --version
 
 Install target:
@@ -49,7 +53,7 @@ Install target:
 
 Options:
   --dry-run                         Preview without writing files
-  --force                           Back up and replace framework conflicts
+  --force                           Back up and discard detected project overrides
   --model-profile <profile>         quality, balanced, or inherit
   --project <directory>             Optional explicit target directory
   --allow-non-unity                 Allow a target without Unity markers`);