nccgs 1.0.0

package/docs/PROJECT-POLICY.md

@@ -0,0 +1,67 @@
+# Project policy
+
+`.nccgs/project.yaml` adapts NCCGS to one project. Keep generic framework behavior out
+of this file; record only choices that change routing, authority, ownership, context,
+verification, closure, or Unity execution for the project.
+
+## Required decisions
+
+- project stage and platforms;
+- enabled departments and bounded orchestration;
+- `quality`, `balanced`, or `inherit` model profile and fallback policy;
+- canonical sources for product, design, architecture, planning, art, narrative,
+  audio, and release;
+- protected/user-owned/generated paths and hand-tuned settings;
+- architecture constraints, packages and services;
+- Unity version, render/UI/input systems and CLI/Pipeline preference;
+- test/build/runtime baselines and recurring Product Owner gates;
+- closure mode, linked artifacts, completion rules and waiver policy.
+
+## Model policy
+
+Use `quality` when result quality is primary and all model tiers are available. Use
+`balanced` when leadership coordination does not need Opus by default. Use `inherit`
+when subscription/context compatibility or explicit user control is more important
+than automatic routing.
+
+Project overrides may pin a specific role/class, but avoid full model IDs unless the
+project intentionally owns upgrade timing.
+
+## Canonical sources and context
+
+Map existing documents where they live. Workflows address semantic roles, not fixed
+folder names. Context packets refer to exact sections and source revisions; they do
+not replace canonical documents.
+
+## Closure example
+
+```yaml
+closure:
+  mode: strict
+  canonical_record: ".nccgs/closures/{feature_id}.md"
+  required_artifacts:
+    - id: implementation-report
+      type: report
+      path_pattern: "project-docs/reports/{feature_id}*.md"
+      required: true
+      completion_rule: exists
+    - id: implementation-register
+      type: register_entry
+      path_pattern: "project-docs/implementation-register.md"
+      required: true
+      completion_rule: entry_present
+    - id: deletion-gate
+      type: checklist
+      path_pattern: "project-docs/gates/{feature_id}*.md"
+      required: true
+      completion_rule: all_conditions
+      expected_conditions: 7
+  done_requires:
+    - implementation
+    - objective_verification
+    - required_artifacts
+    - applicable_manual_gates
+```
+
+Start migration with the strongest live safeguard and weaken it only through an
+explicit Product Owner decision after the replacement has proven its purpose.

package/docs/WORKFLOWS.md

@@ -0,0 +1,61 @@
+# NCCGS workflows
+
+## Risk tiers
+
+| Tier | Typical work | Required structure |
+|---|---|---|
+| FAST | Local, unambiguous, easy rollback | Direct work or one specialist; targeted evidence |
+| STANDARD | Ordinary feature or coordinated change | Contract, context packet, accountable implementer, independent verification, closure |
+| CONTROLLED | Architecture, compatibility, dependency, migration, security, release | Impact/decision record, affected specialists, rollback, adversarial review, full relevant gates |
+
+## End-to-end work
+
+```text
+request
+  -> risk and domain routing
+  -> context packet and readiness
+  -> decisions/plan when needed
+  -> one-owner implementation nodes
+  -> independent verification
+  -> adversarial review for CONTROLLED work
+  -> evidence review
+  -> record synchronization
+  -> configured closure
+```
+
+The primary session composes modules automatically. Explicit specialized commands are
+available when a user wants a bounded workflow or output.
+
+## Workflow families
+
+- **Planning/context**: `project-stage`, `context-pack`, `story-readiness`,
+  `plan-feature`, `sprint-plan`, `milestone-review`, `retrospective`.
+- **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`.
+- **Implementation/quality**: `work`, `qa-plan`, `test`, `bug-triage`,
+  `evidence-review`, `review`, `asset-audit`, `closure`.
+- **Delivery/recovery**: `release-readiness`, `release`, `hotfix`,
+  `incident-recovery`, `localize-game`, `migrate-project`.
+- **Visibility**: `audit`, `status`.
+
+## Role composition examples
+
+A gameplay feature may use game designer → gameplay programmer and Unity systems
+specialist in parallel where ownership differs → verification engineer. A UI feature
+may use UX designer and accessibility specialist for design, UI programmer and Unity
+UI specialist for implementation/integration, then independent verification.
+
+CONTROLLED network-save work adds technical architect, network programmer, security
+engineer, compatibility review, and adversarial review. It does not automatically
+spawn every director or department.
+
+## Evidence states
+
+- IMPLEMENTED: change exists.
+- VERIFIED: objective evidence proves approved criteria.
+- VALIDATED: applicable subjective gate accepted.
+- DONE: all configured objective, artifact and subjective gates closed.
+
+Status labels are evidence claims, not progress decoration.

package/package-assets/setup-vivox-voice-chat-evals.gitignore

@@ -0,0 +1,7 @@
+# API keys - never commit
+.env
+
+# Promptfoo output
+output/
+promptfoo-output/
+*.html

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "nccgs",
+  "version": "1.0.0",
+  "description": "Unity-first game-studio operating system for Claude Code",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "nccgs": "scripts/cli.mjs"
+  },
+  "files": [
+    ".claude/",
+    "docs/",
+    "package-assets/",
+    "scaffold/",
+    "scripts/",
+    "tests/",
+    "CLAUDE.md",
+    "LICENSE",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md",
+    "UPGRADING.md",
+    "VERSION"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "validate": "node scripts/validate.mjs",
+    "test": "node --test tests/framework.test.mjs",
+    "pack:check": "npm pack --dry-run"
+  },
+  "keywords": [
+    "claude-code",
+    "game-development",
+    "unity",
+    "workflow"
+  ]
+}

package/scaffold/.nccgs/bugs/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/.nccgs/closures/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/.nccgs/context/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/.nccgs/decisions/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/.nccgs/evidence/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/.nccgs/features/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/.nccgs/migrations/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/.nccgs/playtests/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/.nccgs/project.yaml

@@ -0,0 +1,103 @@
+schema_version: 2
+
+project:
+  name: "[set during migration/onboarding]"
+  stage: existing
+  platforms: []
+
+studio:
+  profile: unity-production
+  enabled_departments: [leadership, design, programming, unity, content, quality, release]
+  orchestration:
+    max_agent_depth: 1
+    max_parallel_agents: 4
+    single_writer_per_path: true
+    independent_verification: true
+
+models:
+  profile: quality
+  allow_inherit_fallback: true
+  allow_automatic_escalation: true
+  notify_on_escalation: true
+  overrides: {}
+
+workflow:
+  operating_mode: solo
+  autonomy: high
+  default_classification: auto
+  documentation: targeted
+  traceability: targeted
+  review_intensity: risk_based
+
+context:
+  packet_path: ".nccgs/context/{feature_id}.yaml"
+  full_source_reads: on_demand
+  budgets: { fast: 4000, standard: 12000, controlled: 24000 }
+
+authority:
+  implementation_details: claude
+  safe_refactor: claude
+  automated_verification: claude
+  technical_docs_sync: claude
+  gameplay_change: product_owner
+  scope_change: product_owner
+  subjective_acceptance: product_owner
+  dependency_or_service: product_owner
+  irreversible_migration: product_owner
+
+canonical_sources:
+  product_decisions: []
+  game_design: []
+  architecture: []
+  planning: []
+  art_direction: []
+  narrative: []
+  audio: []
+  release: []
+
+unity:
+  version: detect
+  render_pipeline: detect
+  ui_system: detect
+  input_system: detect
+  cli: enabled
+  pipeline: enabled
+  connected_editor_preferred: true
+
+architecture:
+  decisions: []
+  forbidden_patterns: []
+  approved_packages: []
+  approved_services: []
+
+ownership:
+  protected_paths: []
+  user_owned_paths: []
+  user_owned_settings: []
+  generated_paths: []
+
+verification:
+  editmode: detect
+  playmode: detect
+  runtime: unity_cli
+  build_targets: []
+  required_regressions: []
+  recurring_manual_gates: []
+  baseline_policy: no_unexplained_reduction
+
+closure:
+  mode: lean
+  canonical_record: ".nccgs/closures/{feature_id}.md"
+  required_artifacts: []
+  done_requires: [implementation, objective_verification, required_artifacts, applicable_manual_gates]
+
+release:
+  protected_branches: [main, master]
+  required_builds: []
+  publishing_requires_product_owner: true
+
+conventions:
+  source_paths: []
+  test_paths: []
+  documentation_paths: []
+  notes: []

package/scaffold/.nccgs/requirements.yaml

@@ -0,0 +1,10 @@
+schema_version: 1
+requirements: []
+
+# Add only meaningful player-visible contracts, technical invariants, acceptance
+# criteria, and cross-system dependencies. Suggested entry:
+# - id: INVENTORY-001
+#   statement: "Opening inventory pauses local gameplay input."
+#   source: "design/inventory.md#interaction"
+#   status: approved
+#   evidence: []

package/scaffold/.nccgs/reviews/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/.nccgs/state.md

@@ -0,0 +1,40 @@
+# NCCGS state
+
+Updated: [timestamp]
+
+## Active focus
+
+- Feature: none
+- Classification: none
+- Workflow: none
+- Accountable role: none
+- Context packet: none
+
+## Progress
+
+- Last completed checkpoint: NCCGS initialized
+- Current step: configure or migrate project policy
+- Next safe action: run `/migrate-project review` for an existing project
+
+## Decisions pending
+
+- None recorded
+
+## Blockers and gates
+
+- Project policy is not configured
+
+## Evidence snapshot
+
+- None recorded
+
+## Working set
+
+- Modified paths: none
+- Protected paths in scope: none
+- Active agents: none
+
+## Recovery
+
+Read this file, the active context packet, and exact files in Working set. Do not
+reload all project documentation after compaction or session restart.

package/scaffold/.nccgs/templates/agent-handoff.md

@@ -0,0 +1,25 @@
+# Agent handoff: [role] — [feature]
+
+## Outcome
+
+[Completed / Partial / Blocked]
+
+## Changed or produced
+
+- [artifact or path]
+
+## Evidence
+
+- [observable result]
+
+## Risks and deviations
+
+- None recorded
+
+## Decisions needed
+
+- None
+
+## Next owner
+
+[role or workflow]

package/scaffold/.nccgs/templates/architecture-decision.md

@@ -0,0 +1,27 @@
+# ADR-[ID]: [Decision title]
+
+- **Status**: Proposed | Accepted | Superseded | Rejected
+- **Date**: YYYY-MM-DD
+- **Related requirements**: [IDs/links]
+
+## Context
+
+[The durable problem, constraints, affected contracts, and why a decision is needed.]
+
+## Decision
+
+[Chosen direction stated precisely.]
+
+## Alternatives considered
+
+- **[Alternative]**: [material tradeoff and rejection reason]
+
+## Consequences
+
+- **Benefits**: [effects]
+- **Costs/risks**: [effects]
+- **Compatibility/migration**: [save, serialization, network, package, rollback]
+
+## Verification
+
+[Evidence needed to demonstrate the decision is implemented safely.]

package/scaffold/.nccgs/templates/closure-record.md

@@ -0,0 +1,51 @@
+# Feature Closure: [ID] — [Name]
+
+- **Classification**: FAST | STANDARD | CONTROLLED
+- **Closure mode**: lean | linked | strict
+- **Closed**: YYYY-MM-DD
+- **Final state**: IMPLEMENTED | VERIFIED | VALIDATED | DONE | BLOCKED
+
+## Requirements and evidence
+
+| Requirement/criterion | Evidence | Result |
+|---|---|---|
+| [REQ-ID] | [test/runtime/manual reference] | PASS/FAIL/NOT PROVEN/PO GATE |
+
+## Implementation
+
+- [meaningful changed systems/files]
+
+## Verification
+
+- **Compilation**: [result]
+- **EditMode**: [result]
+- **PlayMode**: [result]
+- **Runtime**: [result]
+- **Build**: [result or N/A]
+- **Regression**: [scope and result]
+
+## Documentation synchronization
+
+- [updated canonical/technical/state records]
+
+## Linked closure artifacts
+
+| Artifact ID/type | Path or reference | Required | Completion rule | Status/waiver |
+|---|---|---|---|---|
+| [implementation-report] | [path] | Yes/No | [exists/checklist/sign-off] | PASS/MISSING/INCOMPLETE/WAIVED |
+
+## Closure gate
+
+- **Implementation**: PASS/FAIL
+- **Objective verification**: PASS/FAIL/NOT PROVEN
+- **Required linked artifacts**: PASS/FAIL/N/A
+- **Applicable manual gates**: PASS/WAITING/N/A
+- **Waiver authority**: [PO decision/reference or None]
+
+## PO gates and waivers
+
+- [gate/result/authority or None]
+
+## Known issues and residual risk
+
+- None

package/scaffold/.nccgs/templates/context-packet.yaml

@@ -0,0 +1,17 @@
+schema_version: 1
+feature_id: "[FEATURE-ID]"
+objective: "[approved outcome]"
+classification: STANDARD
+accountable_role: "[nccgs role]"
+domains: []
+requirements: []
+canonical_sections: []
+decision_summaries: []
+ownership: { writable_paths: [], read_only_paths: [], protected_paths: [] }
+constraints: []
+out_of_scope: []
+dependencies: []
+verification: { automated: [], runtime: [], regressions: [], product_owner_gates: [] }
+source_revisions: []
+contradictions: []
+full_source_reads_required: []

package/scaffold/.nccgs/templates/evidence-record.md

@@ -0,0 +1,23 @@
+# Evidence: [feature]
+
+- Environment: [Unity version/platform/branch]
+- Source revision: [commit or working-tree identifier]
+- Requirements covered: [IDs]
+
+## Automated evidence
+
+| Check | Baseline | Result | Skipped | Evidence location |
+|---|---:|---:|---:|---|
+
+## Runtime and build evidence
+
+| Scenario | Expected | Observed | Result |
+|---|---|---|---|
+
+## Regressions and gaps
+
+- [gap or none]
+
+## Product Owner gates
+
+- [scenario and observation request]

package/scaffold/.nccgs/templates/feature-contract.md

@@ -0,0 +1,35 @@
+# Feature Contract: [ID] — [Name]
+
+- **Classification**: FAST | STANDARD | CONTROLLED
+- **Status**: Proposed | Approved | Active | Blocked | Closed
+- **Canonical sources**: [links to relevant sections]
+- **Governing decisions**: [ADR/policy links or None]
+
+## Objective
+
+[Approved outcome and player-facing intent.]
+
+## Requirements
+
+- [REQ-ID] [Requirement statement or canonical link]
+
+## Scope
+
+- **Affected systems**: [systems]
+- **Expected working set**: [files/assets/tests; update after discovery]
+- **Out of scope**: [explicit exclusions]
+
+## Acceptance and evidence
+
+| Criterion | Evidence method | Gate owner |
+|---|---|---|
+| [objective criterion] | [EditMode/PlayMode/runtime/build] | Claude |
+| [subjective criterion] | PO observation | Product Owner |
+
+## Regression obligations
+
+- [downstream behavior that must remain correct]
+
+## Open PO decisions
+
+- None

package/scaffold/.nccgs/templates/migration-plan.md

@@ -0,0 +1,40 @@
+# NCCGS Migration Plan — [Project] — YYYY-MM-DD
+
+## Current state
+
+[Unity/project/workflow summary and repository constraints.]
+
+## Canonical-source and policy map
+
+[Proposed `.nccgs/project.yaml` mappings and ownership boundaries.]
+
+## Closure decision
+
+- **Mode**: lean | linked | strict
+- **Canonical record**: [path pattern]
+- **Required linked artifacts**: [reports/registers/checklists/evidence]
+- **Waiver authority**: [Product Owner or project rule]
+- **Legacy safeguards retained**: [items and rationale]
+
+## Classification
+
+| Artifact/capability | KEEP/ADAPT/MIGRATE/DEPRECATE/REMOVE/MISSING | Evidence and rationale |
+|---|---|---|
+
+## Migration batches
+
+### Batch 1 — [Name]
+
+- **Changes**: [exact reversible changes]
+- **Authority required**: [None or consolidated PO decision]
+- **Backup/rollback**: [method]
+- **Validation**: [observable proof]
+
+## Final proof
+
+- [ ] NCCGS package validates
+- [ ] Project policy and canonical map are complete
+- [ ] Official Unity Skills and Unity CLI/Pipeline are usable
+- [ ] Representative `/work` flow succeeds
+- [ ] Objective and subjective gates route correctly
+- [ ] Legacy conflicts are resolved or explicitly deprecated

package/scaffold/.nccgs/templates/waiver.md

@@ -0,0 +1,11 @@
+# Waiver: [feature] — [blocked item]
+
+- Date: [YYYY-MM-DD]
+- Authority: [Product Owner]
+- Closure item: [exact artifact or gate]
+- Scope: [one feature/release/migration]
+- Rationale: [why proceeding is acceptable]
+- Residual risk: [known consequence]
+- Expiry or review trigger: [condition]
+
+This waiver does not apply to unnamed items.

package/scripts/cli.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const root = path.resolve(scriptDir, "..");
+const [command, ...args] = process.argv.slice(2);
+
+if (!command || command === "help" || command === "--help" || command === "-h") {
+  printHelp();
+  process.exit(0);
+}
+
+if (command === "version" || command === "--version" || command === "-v") {
+  console.log(fs.readFileSync(path.join(root, "VERSION"), "utf8").trim());
+  process.exit(0);
+}
+
+if (command !== "install") {
+  console.error(`Unknown command: ${command}`);
+  printHelp();
+  process.exit(2);
+}
+
+const result = spawnSync(process.execPath, [path.join(scriptDir, "install.mjs"), ...args], {
+  cwd: process.cwd(),
+  stdio: "inherit"
+});
+
+if (result.error) {
+  console.error(`Unable to run the NCCGS installer: ${result.error.message}`);
+  process.exit(1);
+}
+process.exit(result.status ?? 1);
+
+function printHelp() {
+  console.log(`NCCGS
+
+Usage:
+  nccgs install [options]
+  nccgs --version
+
+Install target:
+  The current directory is used by default. Open a terminal in a Unity project
+  or cd into it before running the command.
+
+Options:
+  --dry-run                         Preview without writing files
+  --force                           Back up and replace framework conflicts
+  --model-profile <profile>         quality, balanced, or inherit
+  --project <directory>             Optional explicit target directory
+  --allow-non-unity                 Allow a target without Unity markers`);
+}