nccgs 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (215) hide show
  1. package/.claude/agents/nccgs-adversarial-reviewer.md +7 -1
  2. package/.claude/agents/nccgs-engine-programmer.md +2 -1
  3. package/.claude/agents/nccgs-gameplay-programmer.md +2 -1
  4. package/.claude/agents/nccgs-qa-engineer.md +2 -1
  5. package/.claude/agents/nccgs-ui-programmer.md +2 -1
  6. package/.claude/agents/nccgs-unity-build-specialist.md +2 -1
  7. package/.claude/agents/nccgs-unity-implementer.md +2 -1
  8. package/.claude/agents/nccgs-unity-systems-specialist.md +2 -1
  9. package/.claude/agents/nccgs-unity-ui-specialist.md +2 -1
  10. package/.claude/agents/nccgs-verification-engineer.md +2 -1
  11. package/.claude/nccgs/VERSION +1 -1
  12. package/.claude/{agents → nccgs/agent-library}/nccgs-accessibility-specialist.md +0 -1
  13. package/.claude/nccgs/agent-library/nccgs-adversarial-reviewer.md +30 -0
  14. package/.claude/{agents → nccgs/agent-library}/nccgs-ai-programmer.md +0 -1
  15. package/.claude/{agents → nccgs/agent-library}/nccgs-analytics-engineer.md +0 -1
  16. package/.claude/{agents → nccgs/agent-library}/nccgs-art-direction-lead.md +0 -1
  17. package/.claude/{agents → nccgs/agent-library}/nccgs-audio-direction-lead.md +0 -1
  18. package/.claude/{agents → nccgs/agent-library}/nccgs-creative-director.md +0 -1
  19. package/.claude/{agents → nccgs/agent-library}/nccgs-documentation-manager.md +0 -1
  20. package/.claude/{agents → nccgs/agent-library}/nccgs-economy-designer.md +0 -1
  21. package/.claude/nccgs/agent-library/nccgs-engine-programmer.md +25 -0
  22. package/.claude/{agents → nccgs/agent-library}/nccgs-game-design-lead.md +0 -1
  23. package/.claude/{agents → nccgs/agent-library}/nccgs-game-designer.md +0 -1
  24. package/.claude/nccgs/agent-library/nccgs-gameplay-programmer.md +25 -0
  25. package/.claude/{agents → nccgs/agent-library}/nccgs-level-designer.md +0 -1
  26. package/.claude/{agents → nccgs/agent-library}/nccgs-live-ops-designer.md +0 -1
  27. package/.claude/{agents → nccgs/agent-library}/nccgs-localization-lead.md +0 -1
  28. package/.claude/{agents → nccgs/agent-library}/nccgs-narrative-lead.md +0 -1
  29. package/.claude/{agents → nccgs/agent-library}/nccgs-network-programmer.md +0 -1
  30. package/.claude/{agents → nccgs/agent-library}/nccgs-performance-analyst.md +0 -1
  31. package/.claude/{agents → nccgs/agent-library}/nccgs-producer.md +0 -1
  32. package/.claude/{agents → nccgs/agent-library}/nccgs-production-coordinator.md +0 -1
  33. package/.claude/{agents → nccgs/agent-library}/nccgs-programming-lead.md +0 -1
  34. package/.claude/{agents → nccgs/agent-library}/nccgs-prototyper.md +0 -1
  35. package/.claude/nccgs/agent-library/nccgs-qa-engineer.md +25 -0
  36. package/.claude/{agents → nccgs/agent-library}/nccgs-qa-lead.md +0 -1
  37. package/.claude/{agents → nccgs/agent-library}/nccgs-release-engineer.md +0 -1
  38. package/.claude/{agents → nccgs/agent-library}/nccgs-release-lead.md +0 -1
  39. package/.claude/{agents → nccgs/agent-library}/nccgs-security-engineer.md +0 -1
  40. package/.claude/{agents → nccgs/agent-library}/nccgs-sound-designer.md +0 -1
  41. package/.claude/{agents → nccgs/agent-library}/nccgs-systems-designer.md +0 -1
  42. package/.claude/{agents → nccgs/agent-library}/nccgs-technical-architect.md +0 -1
  43. package/.claude/{agents → nccgs/agent-library}/nccgs-technical-artist.md +0 -1
  44. package/.claude/{agents → nccgs/agent-library}/nccgs-technical-director.md +0 -1
  45. package/.claude/{agents → nccgs/agent-library}/nccgs-tools-programmer.md +0 -1
  46. package/.claude/nccgs/agent-library/nccgs-ui-programmer.md +25 -0
  47. package/.claude/nccgs/agent-library/nccgs-unity-build-specialist.md +25 -0
  48. package/.claude/{agents → nccgs/agent-library}/nccgs-unity-content-specialist.md +0 -1
  49. package/.claude/nccgs/agent-library/nccgs-unity-implementer.md +25 -0
  50. package/.claude/{agents → nccgs/agent-library}/nccgs-unity-rendering-specialist.md +0 -1
  51. package/.claude/nccgs/agent-library/nccgs-unity-systems-specialist.md +25 -0
  52. package/.claude/nccgs/agent-library/nccgs-unity-ui-specialist.md +25 -0
  53. package/.claude/{agents → nccgs/agent-library}/nccgs-ux-designer.md +0 -1
  54. package/.claude/nccgs/agent-library/nccgs-verification-engineer.md +25 -0
  55. package/.claude/{agents → nccgs/agent-library}/nccgs-world-builder.md +0 -1
  56. package/.claude/{agents → nccgs/agent-library}/nccgs-writer.md +0 -1
  57. package/.claude/nccgs/constitution.md +13 -0
  58. package/.claude/nccgs/hooks/agent-audit.mjs +6 -0
  59. package/.claude/nccgs/hooks/closure-guard.mjs +34 -0
  60. package/.claude/nccgs/hooks/runtime-observation.mjs +11 -0
  61. package/.claude/nccgs/hooks/session-start.mjs +8 -1
  62. package/.claude/nccgs/pipeline.json +176 -0
  63. package/.claude/nccgs/protocols/agent-contract.md +5 -0
  64. package/.claude/nccgs/protocols/astra-claude.md +77 -0
  65. package/.claude/nccgs/protocols/evidence.md +6 -0
  66. package/.claude/nccgs/protocols/model-routing.md +27 -5
  67. package/.claude/nccgs/protocols/orchestration.md +5 -0
  68. package/.claude/nccgs/protocols/task-gates.md +66 -0
  69. package/.claude/nccgs/routing.generated.md +11 -0
  70. package/.claude/nccgs/settings.fragment.json +73 -9
  71. package/.claude/nccgs/studio.json +187 -96
  72. package/.claude/nccgs/tools/approve-overrides.mjs +81 -0
  73. package/.claude/nccgs/tools/compile-policy.mjs +83 -0
  74. package/.claude/nccgs/tools/configure-models.mjs +76 -31
  75. package/.claude/nccgs/tools/gates.mjs +167 -0
  76. package/.claude/nccgs/tools/integrity.mjs +69 -0
  77. package/.claude/nccgs/tools/policy.mjs +62 -0
  78. package/.claude/nccgs/tools/runtime.mjs +40 -0
  79. package/.claude/nccgs/tools/task.mjs +77 -0
  80. package/.claude/nccgs/workflow-catalog.json +91 -14
  81. package/.claude/skills/accessibility-review/SKILL.md +6 -5
  82. package/.claude/skills/accessibility-review/references/astra.md +17 -0
  83. package/.claude/skills/accessibility-review/references/legacy.md +7 -0
  84. package/.claude/skills/architecture-decision/SKILL.md +6 -5
  85. package/.claude/skills/architecture-decision/references/astra.md +12 -0
  86. package/.claude/skills/architecture-decision/references/legacy.md +7 -0
  87. package/.claude/skills/asset-audit/SKILL.md +6 -5
  88. package/.claude/skills/asset-audit/references/astra.md +17 -0
  89. package/.claude/skills/asset-audit/references/legacy.md +7 -0
  90. package/.claude/skills/audit/SKILL.md +6 -7
  91. package/.claude/skills/audit/references/astra.md +17 -0
  92. package/.claude/skills/audit/references/legacy.md +9 -0
  93. package/.claude/skills/balance-review/SKILL.md +6 -5
  94. package/.claude/skills/balance-review/references/astra.md +17 -0
  95. package/.claude/skills/balance-review/references/legacy.md +7 -0
  96. package/.claude/skills/bug-triage/SKILL.md +6 -5
  97. package/.claude/skills/bug-triage/references/astra.md +20 -0
  98. package/.claude/skills/bug-triage/references/legacy.md +7 -0
  99. package/.claude/skills/closure/SKILL.md +5 -4
  100. package/.claude/skills/closure/references/astra.md +15 -0
  101. package/.claude/skills/closure/references/legacy.md +7 -0
  102. package/.claude/skills/compatibility-review/SKILL.md +6 -5
  103. package/.claude/skills/compatibility-review/references/astra.md +17 -0
  104. package/.claude/skills/compatibility-review/references/legacy.md +7 -0
  105. package/.claude/skills/context-pack/SKILL.md +5 -4
  106. package/.claude/skills/context-pack/references/astra.md +12 -0
  107. package/.claude/skills/context-pack/references/legacy.md +7 -0
  108. package/.claude/skills/dependency-review/SKILL.md +6 -5
  109. package/.claude/skills/dependency-review/references/astra.md +17 -0
  110. package/.claude/skills/dependency-review/references/legacy.md +7 -0
  111. package/.claude/skills/design/SKILL.md +6 -11
  112. package/.claude/skills/design/references/astra.md +12 -0
  113. package/.claude/skills/design/references/legacy.md +13 -0
  114. package/.claude/skills/design-review/SKILL.md +6 -5
  115. package/.claude/skills/design-review/references/astra.md +17 -0
  116. package/.claude/skills/design-review/references/legacy.md +7 -0
  117. package/.claude/skills/evidence-review/SKILL.md +6 -5
  118. package/.claude/skills/evidence-review/references/astra.md +17 -0
  119. package/.claude/skills/evidence-review/references/legacy.md +7 -0
  120. package/.claude/skills/hotfix/SKILL.md +6 -5
  121. package/.claude/skills/hotfix/references/astra.md +23 -0
  122. package/.claude/skills/hotfix/references/legacy.md +7 -0
  123. package/.claude/skills/incident-recovery/SKILL.md +6 -5
  124. package/.claude/skills/incident-recovery/references/astra.md +20 -0
  125. package/.claude/skills/incident-recovery/references/legacy.md +7 -0
  126. package/.claude/skills/localize-game/SKILL.md +6 -5
  127. package/.claude/skills/localize-game/references/astra.md +20 -0
  128. package/.claude/skills/localize-game/references/legacy.md +7 -0
  129. package/.claude/skills/migrate-project/SKILL.md +6 -14
  130. package/.claude/skills/migrate-project/references/astra.md +23 -0
  131. package/.claude/skills/migrate-project/references/legacy.md +19 -0
  132. package/.claude/skills/migrate-project/references/procedure.md +21 -1
  133. package/.claude/skills/milestone-review/SKILL.md +6 -5
  134. package/.claude/skills/milestone-review/references/astra.md +12 -0
  135. package/.claude/skills/milestone-review/references/legacy.md +7 -0
  136. package/.claude/skills/nccgs-code-review/SKILL.md +15 -0
  137. package/.claude/skills/nccgs-code-review/references/astra.md +15 -0
  138. package/.claude/skills/{code-review/SKILL.md → nccgs-code-review/references/legacy.md} +0 -7
  139. package/.claude/skills/performance-audit/SKILL.md +6 -5
  140. package/.claude/skills/performance-audit/references/astra.md +17 -0
  141. package/.claude/skills/performance-audit/references/legacy.md +7 -0
  142. package/.claude/skills/plan-feature/SKILL.md +6 -5
  143. package/.claude/skills/plan-feature/references/astra.md +12 -0
  144. package/.claude/skills/plan-feature/references/legacy.md +7 -0
  145. package/.claude/skills/playtest/SKILL.md +5 -4
  146. package/.claude/skills/playtest/references/astra.md +20 -0
  147. package/.claude/skills/playtest/references/legacy.md +7 -0
  148. package/.claude/skills/project-stage/SKILL.md +5 -4
  149. package/.claude/skills/project-stage/references/astra.md +12 -0
  150. package/.claude/skills/project-stage/references/legacy.md +7 -0
  151. package/.claude/skills/prototype-feature/SKILL.md +6 -5
  152. package/.claude/skills/prototype-feature/references/astra.md +20 -0
  153. package/.claude/skills/prototype-feature/references/legacy.md +7 -0
  154. package/.claude/skills/qa-plan/SKILL.md +6 -5
  155. package/.claude/skills/qa-plan/references/astra.md +12 -0
  156. package/.claude/skills/qa-plan/references/legacy.md +7 -0
  157. package/.claude/skills/release/SKILL.md +6 -9
  158. package/.claude/skills/release/references/astra.md +23 -0
  159. package/.claude/skills/release/references/legacy.md +11 -0
  160. package/.claude/skills/release-readiness/SKILL.md +6 -5
  161. package/.claude/skills/release-readiness/references/astra.md +17 -0
  162. package/.claude/skills/release-readiness/references/legacy.md +7 -0
  163. package/.claude/skills/retrospective/SKILL.md +6 -5
  164. package/.claude/skills/retrospective/references/astra.md +12 -0
  165. package/.claude/skills/retrospective/references/legacy.md +7 -0
  166. package/.claude/skills/review/SKILL.md +6 -7
  167. package/.claude/skills/review/references/astra.md +15 -0
  168. package/.claude/skills/review/references/legacy.md +9 -0
  169. package/.claude/skills/security-audit/SKILL.md +6 -5
  170. package/.claude/skills/security-audit/references/astra.md +17 -0
  171. package/.claude/skills/security-audit/references/legacy.md +7 -0
  172. package/.claude/skills/sprint-plan/SKILL.md +6 -5
  173. package/.claude/skills/sprint-plan/references/astra.md +12 -0
  174. package/.claude/skills/sprint-plan/references/legacy.md +7 -0
  175. package/.claude/skills/status/SKILL.md +5 -6
  176. package/.claude/skills/status/references/astra.md +13 -0
  177. package/.claude/skills/status/references/legacy.md +9 -0
  178. package/.claude/skills/story-readiness/SKILL.md +5 -4
  179. package/.claude/skills/story-readiness/references/astra.md +17 -0
  180. package/.claude/skills/story-readiness/references/legacy.md +7 -0
  181. package/.claude/skills/test/SKILL.md +6 -7
  182. package/.claude/skills/test/references/astra.md +20 -0
  183. package/.claude/skills/test/references/legacy.md +9 -0
  184. package/.claude/skills/ui-review/SKILL.md +6 -5
  185. package/.claude/skills/ui-review/references/astra.md +17 -0
  186. package/.claude/skills/ui-review/references/legacy.md +7 -0
  187. package/.claude/skills/work/SKILL.md +6 -27
  188. package/.claude/skills/work/references/astra.md +20 -0
  189. package/.claude/skills/work/references/closure.md +10 -0
  190. package/.claude/skills/work/references/feature-contracts.md +4 -0
  191. package/.claude/skills/work/references/legacy.md +29 -0
  192. package/README.md +67 -29
  193. package/UPGRADING.md +54 -4
  194. package/VERSION +1 -1
  195. package/docs/ARCHITECTURE.md +30 -13
  196. package/docs/HUONG-DAN-MIGRATE-VA-SU-DUNG.md +34 -322
  197. package/docs/MIGRATION-MATRIX.md +1 -1
  198. package/docs/NCCGS-1.3.md +125 -0
  199. package/docs/PROJECT-POLICY.md +18 -3
  200. package/docs/WORKFLOWS.md +20 -14
  201. package/package-assets/nccgs-project.gitignore +2 -0
  202. package/package.json +5 -3
  203. package/scaffold/.nccgs/gates.json +7 -0
  204. package/scaffold/.nccgs/project.yaml +6 -3
  205. package/scaffold/.nccgs/state.md +1 -1
  206. package/scaffold/.nccgs/templates/agent-handoff.md +10 -0
  207. package/scaffold/.nccgs/templates/closure-record.md +11 -0
  208. package/scaffold/.nccgs/templates/feature-contract.md +9 -0
  209. package/scaffold/.nccgs/templates/implementation-report.md +49 -0
  210. package/scripts/cli.mjs +10 -5
  211. package/scripts/doctor.mjs +102 -18
  212. package/scripts/install.mjs +221 -88
  213. package/scripts/validate.mjs +34 -6
  214. package/tests/framework.test.mjs +213 -8
  215. package/tests/gates.test.mjs +170 -0
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  name: security-audit
3
3
  description: Threat-models and reviews Unity code, networking, services, commerce, secrets, dependencies, validation, and abuse paths without implementing fixes.
4
- allowed-tools: Read, Glob, Grep, Bash, Task, WebSearch, WebFetch
4
+ allowed-tools: Read, Glob, Grep, Bash, Agent, WebSearch, WebFetch
5
5
  ---
6
6
 
7
7
  # Security Audit
8
8
 
9
- Read `.nccgs/project.yaml`, `.nccgs/state.md`, and the active context packet when present. Preserve Product Owner authority and unrelated work.
9
+ Read models.profile in .nccgs/project.yaml; if absent, use the defaultProfile in
10
+ .claude/nccgs/pipeline.json. Load exactly one procedure:
10
11
 
11
- Remain read-only. Identify assets, actors, trust boundaries, entry points, authority, sensitive data, dependencies, and threat assumptions. Inspect relevant code/configuration without exposing secrets. Prioritize exploitable findings by likelihood and impact, provide evidence and mitigations, and distinguish verified vulnerabilities from hardening opportunities. Service, dependency, authority, and privacy changes require Product Owner decisions.
12
-
13
- 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.
12
+ - astra-claude: [Astra/Claude procedure](references/astra.md).
13
+ - quality, balanced, inherit: [Legacy procedure](references/legacy.md).
14
14
 
15
+ Do not load or merge the other branch. Unknown profiles are configuration errors.
@@ -0,0 +1,17 @@
1
+ # Security Audit — astra-claude
2
+
3
+ Read [the pipeline protocol](../../../nccgs/protocols/astra-claude.md) and
4
+ [generated routing](../../../nccgs/routing.generated.md). Use Astra's supplied plan,
5
+ requirements, and exact context references. Never substitute a legacy procedure.
6
+
7
+ Domain objective: Threat-models and reviews Unity code, networking, services, commerce, secrets, dependencies, validation, and abuse paths without implementing fixes.
8
+
9
+ Work only inside the supplied plan and assigned write set. Activate an optional
10
+ specialist with the agents command only when its domain is required. Keep one writer
11
+ per path and use official Unity Skills for Editor/assets/runtime operations.
12
+
13
+ This procedure is read-only: return evidence-backed findings and decisions to Astra
14
+ or the implementer. Supplemental analysis does not replace the mandatory Fable gate.
15
+
16
+ Use [task gate commands](../../../nccgs/protocols/task-gates.md) for evidence and
17
+ state transitions. Report outcome, evidence, pending decisions, and next owner.
@@ -0,0 +1,7 @@
1
+ # Security Audit
2
+
3
+ Read `.nccgs/project.yaml`, `.nccgs/state.md`, and the active context packet when present. Preserve Product Owner authority and unrelated work.
4
+
5
+ Remain read-only. Identify assets, actors, trust boundaries, entry points, authority, sensitive data, dependencies, and threat assumptions. Inspect relevant code/configuration without exposing secrets. Prioritize exploitable findings by likelihood and impact, provide evidence and mitigations, and distinguish verified vulnerabilities from hardening opportunities. Service, dependency, authority, and privacy changes require Product Owner decisions.
6
+
7
+ 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.
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  name: sprint-plan
3
3
  description: Creates a capacity-aware, dependency-ordered short-horizon plan from approved features, risks, Product Owner priority, and verification/closure work.
4
- allowed-tools: Read, Glob, Grep, Write, Edit, Task, AskUserQuestion
4
+ allowed-tools: Read, Glob, Grep, Write, Edit, Agent, AskUserQuestion
5
5
  ---
6
6
 
7
7
  # Sprint Plan
8
8
 
9
- Read `.nccgs/project.yaml`, `.nccgs/state.md`, and the active context packet when present. Preserve Product Owner authority and unrelated work.
9
+ Read models.profile in .nccgs/project.yaml; if absent, use the defaultProfile in
10
+ .claude/nccgs/pipeline.json. Load exactly one procedure:
10
11
 
11
- Read mapped planning sources, priorities, feature readiness, dependencies, known defects, capacity assumptions, and release constraints. Do not invent dates or capacity. Select a coherent goal, order work by dependency and risk, include verification/closure, identify ownership and PO decisions, and expose stretch work separately. Persist in the canonical planning location and keep scope changes explicit.
12
-
13
- 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.
12
+ - astra-claude: [Astra/Claude procedure](references/astra.md).
13
+ - quality, balanced, inherit: [Legacy procedure](references/legacy.md).
14
14
 
15
+ Do not load or merge the other branch. Unknown profiles are configuration errors.
@@ -0,0 +1,12 @@
1
+ # Sprint Plan — astra-claude
2
+
3
+ Read [the pipeline protocol](../../../nccgs/protocols/astra-claude.md) and
4
+ [generated routing](../../../nccgs/routing.generated.md). Use Astra's supplied plan,
5
+ requirements, and exact context references. Never substitute a legacy procedure.
6
+
7
+ Astra owns this workflow and its canonical outputs. Claude only inspects relevant
8
+ inputs and returns factual constraints, missing information, or proposed amendments.
9
+ Do not create a replacement plan/document or sign off as Astra.
10
+
11
+ Use [task gate commands](../../../nccgs/protocols/task-gates.md) for evidence and
12
+ state transitions. Report outcome, evidence, pending decisions, and next owner.
@@ -0,0 +1,7 @@
1
+ # Sprint Plan
2
+
3
+ Read `.nccgs/project.yaml`, `.nccgs/state.md`, and the active context packet when present. Preserve Product Owner authority and unrelated work.
4
+
5
+ Read mapped planning sources, priorities, feature readiness, dependencies, known defects, capacity assumptions, and release constraints. Do not invent dates or capacity. Select a coherent goal, order work by dependency and risk, include verification/closure, identify ownership and PO decisions, and expose stretch work separately. Persist in the canonical planning location and keep scope changes explicit.
6
+
7
+ 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.
@@ -6,11 +6,10 @@ allowed-tools: Read, Glob, Grep, Bash
6
6
 
7
7
  # Status
8
8
 
9
- Remain read-only. Read project policy, state, active context packet, feature contract, evidence and closure records, plus repository status. Do not run broad tests solely for status.
9
+ Read models.profile in .nccgs/project.yaml; if absent, use the defaultProfile in
10
+ .claude/nccgs/pipeline.json. Load exactly one procedure:
10
11
 
11
- Report current objective and risk, accountable role and active specialists, configured model profile and any fallback, implementation/automated/runtime/regression/docs/PO-gate states, closure mode and artifacts, blockers, stale records, and next concrete action.
12
-
13
- For `brief`, omit evidence detail. For `full`, add requirement mapping, source revision freshness, role/model routing, hook health, linked artifact completion, working-tree summary, and recent decisions. For a feature ID, scope the report to that feature.
14
-
15
- Use IMPLEMENTED, VERIFIED, VALIDATED, DONE, or BLOCKED exactly. Never show DONE while a configured artifact, strict checklist, objective check, or manual gate is incomplete without a valid item-specific waiver.
12
+ - astra-claude: [Astra/Claude procedure](references/astra.md).
13
+ - quality, balanced, inherit: [Legacy procedure](references/legacy.md).
16
14
 
15
+ Do not load or merge the other branch. Unknown profiles are configuration errors.
@@ -0,0 +1,13 @@
1
+ # Status — astra-claude
2
+
3
+ Read [the pipeline protocol](../../../nccgs/protocols/astra-claude.md) and
4
+ [generated routing](../../../nccgs/routing.generated.md). Use Astra's supplied plan,
5
+ requirements, and exact context references. Never substitute a legacy procedure.
6
+
7
+ Remain read-only. Read task records, active-agent selection, runtime observations,
8
+ and project evidence. Use task check for the requested next stage. Report actual
9
+ missing/stale gates and requested versus observed model/effort. Never infer DONE
10
+ from prose, configured model pins, or an old closed record.
11
+
12
+ Use [task gate commands](../../../nccgs/protocols/task-gates.md) for evidence and
13
+ state transitions. Report outcome, evidence, pending decisions, and next owner.
@@ -0,0 +1,9 @@
1
+ # Status
2
+
3
+ Remain read-only. Read project policy, state, active context packet, feature contract, evidence and closure records, plus repository status. Do not run broad tests solely for status.
4
+
5
+ Report current objective and risk, accountable role and active specialists, configured model profile and any fallback, implementation/automated/runtime/regression/docs/PO-gate states, closure mode and artifacts, blockers, stale records, and next concrete action.
6
+
7
+ For `brief`, omit evidence detail. For `full`, add requirement mapping, source revision freshness, role/model routing, hook health, linked artifact completion, working-tree summary, and recent decisions. For a feature ID, scope the report to that feature.
8
+
9
+ Use IMPLEMENTED, VERIFIED, VALIDATED, DONE, or BLOCKED exactly. Never show DONE while a configured artifact, strict checklist, objective check, or manual gate is incomplete without a valid item-specific waiver.
@@ -6,9 +6,10 @@ allowed-tools: Read, Glob, Grep, Bash
6
6
 
7
7
  # Story Readiness
8
8
 
9
- Read `.nccgs/project.yaml`, `.nccgs/state.md`, and the active context packet when present. Preserve Product Owner authority and unrelated work.
9
+ Read models.profile in .nccgs/project.yaml; if absent, use the defaultProfile in
10
+ .claude/nccgs/pipeline.json. Load exactly one procedure:
10
11
 
11
- Remain read-only. Check approved objective, stable requirements, acceptance criteria, governing decisions, dependencies, ownership, protected paths, compatibility, testability, and unresolved semantics. Verify the context packet source revisions. Return READY, READY WITH RISKS, or BLOCKED with exact missing inputs and the smallest next action. Do not demand documents that add no implementation value.
12
-
13
- 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.
12
+ - astra-claude: [Astra/Claude procedure](references/astra.md).
13
+ - quality, balanced, inherit: [Legacy procedure](references/legacy.md).
14
14
 
15
+ Do not load or merge the other branch. Unknown profiles are configuration errors.
@@ -0,0 +1,17 @@
1
+ # Story Readiness — astra-claude
2
+
3
+ Read [the pipeline protocol](../../../nccgs/protocols/astra-claude.md) and
4
+ [generated routing](../../../nccgs/routing.generated.md). Use Astra's supplied plan,
5
+ requirements, and exact context references. Never substitute a legacy procedure.
6
+
7
+ Domain objective: Checks whether a feature or story is safe and specific enough to implement, including requirements, decisions, dependencies, ownership, tests, and Product Owner gates.
8
+
9
+ Work only inside the supplied plan and assigned write set. Activate an optional
10
+ specialist with the agents command only when its domain is required. Keep one writer
11
+ per path and use official Unity Skills for Editor/assets/runtime operations.
12
+
13
+ This procedure is read-only: return evidence-backed findings and decisions to Astra
14
+ or the implementer. Supplemental analysis does not replace the mandatory Fable gate.
15
+
16
+ Use [task gate commands](../../../nccgs/protocols/task-gates.md) for evidence and
17
+ state transitions. Report outcome, evidence, pending decisions, and next owner.
@@ -0,0 +1,7 @@
1
+ # Story Readiness
2
+
3
+ Read `.nccgs/project.yaml`, `.nccgs/state.md`, and the active context packet when present. Preserve Product Owner authority and unrelated work.
4
+
5
+ Remain read-only. Check approved objective, stable requirements, acceptance criteria, governing decisions, dependencies, ownership, protected paths, compatibility, testability, and unresolved semantics. Verify the context packet source revisions. Return READY, READY WITH RISKS, or BLOCKED with exact missing inputs and the smallest next action. Do not demand documents that add no implementation value.
6
+
7
+ 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.
@@ -1,16 +1,15 @@
1
1
  ---
2
2
  name: test
3
3
  description: Plans or executes requirement-based Unity verification using automated tests, Unity CLI/Pipeline, runtime, build, regression, profiling, and explicit Product Owner gates. Use to prove behavior or reproduce failures without changing intended semantics.
4
- allowed-tools: Read, Glob, Grep, Write, Edit, Bash, Task, AskUserQuestion
4
+ allowed-tools: Read, Glob, Grep, Write, Edit, Bash, Agent, AskUserQuestion
5
5
  ---
6
6
 
7
7
  # Test
8
8
 
9
- Read policy, context packet, requirements, decisions, implementation, existing tests, and baseline. Classify each target as objective verification, regression, or subjective validation.
9
+ Read models.profile in .nccgs/project.yaml; if absent, use the defaultProfile in
10
+ .claude/nccgs/pipeline.json. Load exactly one procedure:
10
11
 
11
- Use `/qa-plan` when coverage is not obvious. Choose the strongest proportional evidence described in the [evidence protocol](../../nccgs/protocols/evidence.md). Use official Unity Skills and `unity-cli` for Unity operations.
12
-
13
- Run existing relevant checks first. Add deterministic tests only when the surrounding request authorizes implementation; remain read-only for a standalone audit. Capture environment, commands/actions, counts, skips, baseline comparison, runtime/build state, console errors, and regressions.
14
-
15
- Use an independent verification role for STANDARD/CONTROLLED work. Verdicts are PASS, FAIL, NOT PROVEN, PO GATE, or N/A with reason. Do not mark the feature DONE; hand evidence to `/evidence-review` and `/closure`.
12
+ - astra-claude: [Astra/Claude procedure](references/astra.md).
13
+ - quality, balanced, inherit: [Legacy procedure](references/legacy.md).
16
14
 
15
+ Do not load or merge the other branch. Unknown profiles are configuration errors.
@@ -0,0 +1,20 @@
1
+ # Test — astra-claude
2
+
3
+ Read [the pipeline protocol](../../../nccgs/protocols/astra-claude.md) and
4
+ [generated routing](../../../nccgs/routing.generated.md). Use Astra's supplied plan,
5
+ requirements, and exact context references. Never substitute a legacy procedure.
6
+
7
+ Domain objective: Plans or executes requirement-based Unity verification using automated tests, Unity CLI/Pipeline, runtime, build, regression, profiling, and explicit Product Owner gates. Use to prove behavior or reproduce failures without changing intended semantics.
8
+
9
+ Work only inside the supplied plan and assigned write set. Activate an optional
10
+ specialist with the agents command only when its domain is required. Keep one writer
11
+ per path and use official Unity Skills for Editor/assets/runtime operations.
12
+
13
+ For code changes: task init with Astra's plan, bind the session, implement and test,
14
+ record implementation evidence, request independent review, fix and re-review as
15
+ needed, then task check --target report. Only after that check passes write and
16
+ record the report for Astra. Stop at AWAITING_ASTRA_CHECK. Astra checking and the
17
+ Product Owner's explicit acceptance happen outside the Claude implementation session.
18
+
19
+ Use [task gate commands](../../../nccgs/protocols/task-gates.md) for evidence and
20
+ state transitions. Report outcome, evidence, pending decisions, and next owner.
@@ -0,0 +1,9 @@
1
+ # Test
2
+
3
+ Read policy, context packet, requirements, decisions, implementation, existing tests, and baseline. Classify each target as objective verification, regression, or subjective validation.
4
+
5
+ Use `/qa-plan` when coverage is not obvious. Choose the strongest proportional evidence described in the [evidence protocol](../../../nccgs/protocols/evidence.md). Use official Unity Skills and `unity-cli` for Unity operations.
6
+
7
+ Run existing relevant checks first. Add deterministic tests only when the surrounding request authorizes implementation; remain read-only for a standalone audit. Capture environment, commands/actions, counts, skips, baseline comparison, runtime/build state, console errors, and regressions.
8
+
9
+ Use an independent verification role for STANDARD/CONTROLLED work. Verdicts are PASS, FAIL, NOT PROVEN, PO GATE, or N/A with reason. Do not mark the feature DONE; hand evidence to `/evidence-review` and `/closure`.
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  name: ui-review
3
3
  description: Performs a read-only review of Unity UI behavior, architecture, navigation, responsiveness, localization, accessibility, performance, and UX conformance.
4
- allowed-tools: Read, Glob, Grep, Bash, Task
4
+ allowed-tools: Read, Glob, Grep, Bash, Agent
5
5
  ---
6
6
 
7
7
  # Ui Review
8
8
 
9
- Read `.nccgs/project.yaml`, `.nccgs/state.md`, and the active context packet when present. Preserve Product Owner authority and unrelated work.
9
+ Read models.profile in .nccgs/project.yaml; if absent, use the defaultProfile in
10
+ .claude/nccgs/pipeline.json. Load exactly one procedure:
10
11
 
11
- Read approved UX flows, UI requirements, platform/input policy, accessibility targets, implementation, scenes/assets, and tests. Pair UX and Unity UI lenses without conflating them. Inspect state ownership, navigation, focus, errors, scaling, layout expansion, binding, lifecycle, allocations, and runtime evidence. Report prioritized findings and subjective PO scenarios; do not redesign or edit.
12
-
13
- 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.
12
+ - astra-claude: [Astra/Claude procedure](references/astra.md).
13
+ - quality, balanced, inherit: [Legacy procedure](references/legacy.md).
14
14
 
15
+ Do not load or merge the other branch. Unknown profiles are configuration errors.
@@ -0,0 +1,17 @@
1
+ # Ui Review — astra-claude
2
+
3
+ Read [the pipeline protocol](../../../nccgs/protocols/astra-claude.md) and
4
+ [generated routing](../../../nccgs/routing.generated.md). Use Astra's supplied plan,
5
+ requirements, and exact context references. Never substitute a legacy procedure.
6
+
7
+ Domain objective: Performs a read-only review of Unity UI behavior, architecture, navigation, responsiveness, localization, accessibility, performance, and UX conformance.
8
+
9
+ Work only inside the supplied plan and assigned write set. Activate an optional
10
+ specialist with the agents command only when its domain is required. Keep one writer
11
+ per path and use official Unity Skills for Editor/assets/runtime operations.
12
+
13
+ This procedure is read-only: return evidence-backed findings and decisions to Astra
14
+ or the implementer. Supplemental analysis does not replace the mandatory Fable gate.
15
+
16
+ Use [task gate commands](../../../nccgs/protocols/task-gates.md) for evidence and
17
+ state transitions. Report outcome, evidence, pending decisions, and next owner.
@@ -0,0 +1,7 @@
1
+ # Ui Review
2
+
3
+ Read `.nccgs/project.yaml`, `.nccgs/state.md`, and the active context packet when present. Preserve Product Owner authority and unrelated work.
4
+
5
+ Read approved UX flows, UI requirements, platform/input policy, accessibility targets, implementation, scenes/assets, and tests. Pair UX and Unity UI lenses without conflating them. Inspect state ownership, navigation, focus, errors, scaling, layout expansion, binding, lifecycle, allocations, and runtime evidence. Report prioritized findings and subjective PO scenarios; do not redesign or edit.
6
+
7
+ 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.
@@ -1,36 +1,15 @@
1
1
  ---
2
2
  name: work
3
3
  description: Runs end-to-end Unity feature, bug-fix, refactor, tooling, content-integration, or other concrete project work. Routes by domain and risk, composes specialist roles, verifies independently, synchronizes records, and closes configured gates.
4
- allowed-tools: Read, Glob, Grep, Write, Edit, Bash, Task, AskUserQuestion, WebSearch, WebFetch
4
+ allowed-tools: Read, Glob, Grep, Write, Edit, Bash, Agent, AskUserQuestion, WebSearch, WebFetch
5
5
  ---
6
6
 
7
7
  # Work
8
8
 
9
- Complete the approved outcome rather than stopping at a plan.
9
+ Read models.profile in .nccgs/project.yaml; if absent, use the defaultProfile in
10
+ .claude/nccgs/pipeline.json. Load exactly one procedure:
10
11
 
11
- ## Route
12
-
13
- Read project policy and state, inspect Git status, and classify FAST, STANDARD, or CONTROLLED using [classification](references/classification.md). Identify affected domains before selecting roles from `../../nccgs/studio.json`.
14
-
15
- - FAST normally stays in the main session or uses one specialist.
16
- - STANDARD uses a context packet, an accountable implementer, and independent verification.
17
- - CONTROLLED adds the relevant decision owner and adversarial review.
18
-
19
- Read the [orchestration protocol](../../nccgs/protocols/orchestration.md) for multi-role work. Do not build a ceremonial management chain.
20
-
21
- ## Contract
22
-
23
- Use [feature contracts](references/feature-contracts.md). Create or refresh a context packet through `/context-pack` for STANDARD or CONTROLLED work. Resolve Product Owner decisions that affect semantics, scope, canon, compatibility, dependencies, or irreversibility; continue safe independent nodes while decisions are pending.
24
-
25
- ## Execute
26
-
27
- Build a dependency graph with one writer per path. Route distinct domains to their specialists. Use official Unity Skills for operation mechanics and `unity-cli` for connected Editor, tests, builds, and runtime evidence. Agents receive the context packet path and bounded ownership, not the entire chat or document set.
28
-
29
- Fix in-scope failures, inspect the final diff, and preserve unrelated work.
30
-
31
- ## Verify and close
32
-
33
- Use [verification](references/verification.md) and the shared [evidence protocol](../../nccgs/protocols/evidence.md). Map objective evidence to requirements, run proportional regression, and separate PO gates. CONTROLLED work receives `/review` or `/evidence-review` from an independent role.
34
-
35
- Synchronize state and technical records, then run `/closure`. Report classification, roles/models used, changed files, evidence, blockers, PO gates, residual risk, and final state.
12
+ - astra-claude: [Astra/Claude procedure](references/astra.md).
13
+ - quality, balanced, inherit: [Legacy procedure](references/legacy.md).
36
14
 
15
+ Do not load or merge the other branch. Unknown profiles are configuration errors.
@@ -0,0 +1,20 @@
1
+ # Work — astra-claude
2
+
3
+ Read [the pipeline protocol](../../../nccgs/protocols/astra-claude.md) and
4
+ [generated routing](../../../nccgs/routing.generated.md). Use Astra's supplied plan,
5
+ requirements, and exact context references. Never substitute a legacy procedure.
6
+
7
+ Domain objective: Runs end-to-end Unity feature, bug-fix, refactor, tooling, content-integration, or other concrete project work. Routes by domain and risk, composes specialist roles, verifies independently, synchronizes records, and closes configured gates.
8
+
9
+ Work only inside the supplied plan and assigned write set. Activate an optional
10
+ specialist with the agents command only when its domain is required. Keep one writer
11
+ per path and use official Unity Skills for Editor/assets/runtime operations.
12
+
13
+ For code changes: task init with Astra's plan, bind the session, implement and test,
14
+ record implementation evidence, request independent review, fix and re-review as
15
+ needed, then task check --target report. Only after that check passes write and
16
+ record the report for Astra. Stop at AWAITING_ASTRA_CHECK. Astra checking and the
17
+ Product Owner's explicit acceptance happen outside the Claude implementation session.
18
+
19
+ Use [task gate commands](../../../nccgs/protocols/task-gates.md) for evidence and
20
+ state transitions. Report outcome, evidence, pending decisions, and next owner.
@@ -48,3 +48,13 @@ and next candidate. Git and closure records hold history.
48
48
  Technical records may be synchronized autonomously. Canonical player-facing design
49
49
  changes require an accepted PO decision. If code and canon disagree, fix or escalate;
50
50
  never rewrite canon silently.
51
+
52
+ ## Mandatory astra-claude gates
53
+
54
+ For astra-claude, lean mode does not remove Fable review, the reviewed report,
55
+ Astra checking, or explicit Product Owner acceptance. Require Fable PASS on the
56
+ final snapshot, then the report, then Astra PASS, then Product Owner ACCEPTED on
57
+ that same snapshot. Claude records factual progress/evidence and hands off at
58
+ AWAITING_ASTRA_CHECK. Astra owns final documentation and closure. Missing or stale
59
+ sign-offs block DONE; changes require renewed review and downstream acceptance.
60
+ Only an explicit Product Owner policy change can alter this sequence.
@@ -30,3 +30,7 @@ debugging.
30
30
  Requirement IDs belong in `.nccgs/requirements.yaml` only for player-visible
31
31
  contracts, technical invariants, acceptance criteria, and cross-system dependencies.
32
32
  Do not assign IDs to private class structure or every documentation sentence.
33
+
34
+ Under astra-claude, Astra authors and revises these contracts and context packets.
35
+ Claude consumes them, records newly discovered facts in evidence, and requests
36
+ revisions from Astra instead of rewriting planning or canonical documents.
@@ -0,0 +1,29 @@
1
+ # Work
2
+
3
+ Complete the approved outcome rather than stopping at a plan.
4
+
5
+ ## Route
6
+
7
+ Read project policy and state, inspect Git status, and classify FAST, STANDARD, or CONTROLLED using [classification](../references/classification.md). Identify affected domains before selecting roles from `../../nccgs/studio.json`.
8
+
9
+ - FAST normally stays in the main session or uses one specialist.
10
+ - STANDARD uses a context packet, an accountable implementer, and independent verification.
11
+ - CONTROLLED adds the relevant decision owner and adversarial review.
12
+
13
+ Read the [orchestration protocol](../../../nccgs/protocols/orchestration.md) for multi-role work. Do not build a ceremonial management chain.
14
+
15
+ ## Contract
16
+
17
+ Use [feature contracts](../references/feature-contracts.md). Create or refresh a context packet through `/context-pack` for STANDARD or CONTROLLED work. Resolve Product Owner decisions that affect semantics, scope, canon, compatibility, dependencies, or irreversibility; continue safe independent nodes while decisions are pending.
18
+
19
+ ## Execute
20
+
21
+ Build a dependency graph with one writer per path. Route distinct domains to their specialists. Use official Unity Skills for operation mechanics and `unity-cli` for connected Editor, tests, builds, and runtime evidence. Agents receive the context packet path and bounded ownership, not the entire chat or document set.
22
+
23
+ Fix in-scope failures, inspect the final diff, and preserve unrelated work.
24
+
25
+ ## Verify and close
26
+
27
+ Use [verification](../references/verification.md) and the shared [evidence protocol](../../../nccgs/protocols/evidence.md). Map objective evidence to requirements, run proportional regression, and separate PO gates. CONTROLLED work receives `/review` or `/evidence-review` from an independent role.
28
+
29
+ Synchronize state and technical records, then run `/closure`. Report classification, roles/models used, changed files, evidence, blockers, PO gates, residual risk, and final state.
package/README.md CHANGED
@@ -5,27 +5,33 @@ specialization of a full game-development team with project-aware governance,
5
5
  bounded orchestration, configurable model routing, official Unity Skills, objective
6
6
  evidence, and strict closure.
7
7
 
8
- Version 1.1 contains:
8
+ Version 1.3.0 contains:
9
9
 
10
- - 45 studio agents across leadership, design, programming, Unity, content, quality,
11
- and release;
10
+ - 10 active core agents and 35 optional specialist roles in a 45-agent library;
12
11
  - 36 composable NCCGS workflows with eight primary entrypoints;
13
12
  - 11 path-scoped project rules;
14
- - 8 cross-platform Node lifecycle/safety hooks;
13
+ - 11 cross-platform Node lifecycle/safety hook commands;
15
14
  - 22 unmodified official Unity Skills with a SHA-256 manifest;
16
15
  - brownfield migration, context packets, evidence records, closure modes, model
17
- profiles, installer backup, and behavioral framework tests.
16
+ profiles, installer backup, and behavioral framework tests;
17
+ - executable task gates, runtime observations, generated routing from one policy,
18
+ and separate Astra/legacy workflow instructions.
19
+
20
+ Read the [NCCGS 1.3 operating guide](docs/NCCGS-1.3.md) for setup and evidence schemas.
21
+ Install the npm release with the commands below, or use this checkout's
22
+ `scripts/cli.mjs` when working from source.
18
23
 
19
24
  ## Operating architecture
20
25
 
21
26
  ```text
22
27
  Product Owner
23
- -> Claude Code primary orchestrator
24
- -> NCCGS policy, context packet, risk and model router
25
- -> specialized studio roles (bounded to one delegation level)
26
- -> official Unity Skills
27
- -> Unity CLI/Pipeline and Editor
28
- -> independent evidence, review, and closure
28
+ -> Astra: planning, contracts, and canonical documents
29
+ -> Claude Opus 5.5 / xhigh: implementation and tests
30
+ -> Fable / high: independent review (Opus fixes -> Fable re-review)
31
+ -> reviewed report to Astra
32
+ -> Astra: plan/evidence check and document updates
33
+ -> Product Owner: final acceptance
34
+ -> DONE when all gates pass
29
35
  ```
30
36
 
31
37
  NCCGS does not simulate a hierarchy for ceremony. It selects specialized roles when
@@ -53,12 +59,20 @@ npx nccgs@latest update
53
59
  npx nccgs@latest doctor
54
60
  ```
55
61
 
62
+ To adopt the Astra/Opus/Fable pipeline in an existing project, add
63
+ `--model-profile astra-claude` to both update commands. Without this option, updates
64
+ preserve the project's current profile. Publishing a new release does not modify
65
+ Unity projects automatically; run the update command in each project.
66
+
56
67
  The current directory is the installation target. `--project <directory>` remains
57
68
  available for automation, but is not needed for ordinary use.
58
69
 
59
- Updates are hash-aware. Files that still match the previous install state are backed
60
- up and replaced automatically; project-modified files block the update until they
61
- are reviewed. Use `--force` only to back up and replace intentional overrides.
70
+ Updates are hash-aware and line-ending-aware. Files that still match the previous
71
+ install state update automatically even when Git converted CRLF to LF. Genuine
72
+ project modifications are preserved, recorded in `.nccgs/framework-overrides.json`,
73
+ and routed through one `/migrate-project` review instead of blocking the whole
74
+ framework update. `--force` remains an explicit discard-and-replace escape hatch;
75
+ it is not the normal upgrade path.
62
76
 
63
77
  The installer validates the package, backs up replaced framework/settings files to
64
78
  `.nccgs/backups/<timestamp>/`, copies `.claude/`, initializes missing `.nccgs/`
@@ -70,28 +84,51 @@ Select a model profile during installation when needed:
70
84
 
71
85
  ```powershell
72
86
  npx nccgs@latest update --model-profile quality
87
+ npx nccgs@latest update --model-profile astra-claude
73
88
  npx nccgs@latest update --model-profile balanced
74
89
  npx nccgs@latest update --model-profile inherit
75
90
  ```
76
91
 
77
- Open a new Claude Code session after first-time adoption of an existing project and
78
- run `/migrate-project` once. It performs review, plan, apply, and verify as one
79
- CONTROLLED operation, pausing only for a real Product Owner decision or unsafe side
80
- effect. Ordinary framework updates report `No project migration required` and need
81
- no Claude migration command.
92
+ For `astra-claude`, Astra first prepares the migration plan and maps existing project
93
+ obligations into `.nccgs/gates.json`. Claude then runs `/migrate-project` against that
94
+ plan. Legacy profiles retain their combined review/plan/apply/verify workflow.
95
+ Ordinary framework updates need no migration when the installer reports none.
82
96
 
83
97
  ## Model routing
84
98
 
85
- | Profile | Lightweight | Standard | Deep | Leadership |
86
- |---|---|---|---|---|
87
- | `quality` (default) | Haiku | Sonnet | Opus | Opus |
88
- | `balanced` | Haiku | Sonnet | Opus | Sonnet |
89
- | `inherit` | Session model | Session model | Session model | Session model |
99
+ | Profile | Claude implementation/support | Independent reviewer | Effort |
100
+ |---|---|---|---|
101
+ | `astra-claude` (default) | Pinned `claude-opus-5-5` | `fable` | Implementation `xhigh`; review `high` |
102
+ | `quality` | Haiku lightweight; Sonnet standard; Opus deep/leadership | Opus | Session |
103
+ | `balanced` | As quality, with Sonnet leadership | Opus | Session |
104
+ | `inherit` | Session model | Session model | Session |
105
+
106
+ In `astra-claude`, Astra owns planning and canonical documents outside Claude Code.
107
+ All Claude coding/support roles use Opus 5.5/xhigh; planning roles are consultants
108
+ only. Every code change, including FAST work, requires independent Fable review
109
+ before Claude produces the final report for Astra. Astra checks it, updates documents,
110
+ and requests explicit Product Owner acceptance. Claude does not declare DONE itself.
111
+ See [the complete handoff protocol](.claude/nccgs/protocols/astra-claude.md).
112
+
113
+ The configurator sets agent model/effort and the project's main session settings.
114
+ The canonical source is `.claude/nccgs/pipeline.json`; `npm run policy:build`
115
+ generates routing outputs and `npm run policy:check` detects drift. Optional roles
116
+ are activated with `nccgs agents --enable <role>` and preserved through updates.
117
+ No silent model/effort fallback is accepted for this profile. Existing projects keep
118
+ their current profile on ordinary updates; select `--model-profile astra-claude`
119
+ explicitly to adopt this chain. Legacy profiles remain available by explicit choice.
120
+ Opus 5.5 requires Claude Code 2.1.280 or later. Fable is an alias: record its actual
121
+ resolved model and effort from runtime evidence, not configuration alone.
122
+
123
+ To use a source checkout directly, run its CLI with the target Unity project,
124
+ first with `--dry-run`:
125
+
126
+ ```powershell
127
+ node "D:\path\to\NCCGS\scripts\cli.mjs" update --project "D:\path\to\UnityProject" --model-profile astra-claude --dry-run
128
+ ```
90
129
 
91
- Role selection happens before model selection. Risk may escalate a task, but a title
92
- alone does not justify Opus. If a pinned model is unavailable or conflicts with the
93
- current context mode, project policy can allow the primary session to continue using
94
- the inherited model and report the fallback.
130
+ Use `install` for first adoption. Remove `--dry-run` to apply. NCCGS prepares a
131
+ file-backed report for Astra; it does not automatically send messages between apps.
95
132
 
96
133
  Reconfigure an installed project:
97
134
 
@@ -113,7 +150,7 @@ node .\.claude\nccgs\tools\configure-models.mjs --project . --profile inherit
113
150
  | `/status` | Current work, roles/models, evidence, blockers, closure, and next action |
114
151
 
115
152
  Thirty-six discoverable workflows include focused modules for architecture decisions,
116
- context packets, story readiness, code/design/evidence review, closure, QA planning,
153
+ context packets, story readiness, NCCGS code/design/evidence review, closure, QA planning,
117
154
  triage, performance, security, accessibility, balance, prototypes, playtests,
118
155
  localization, hotfixes, milestones, assets, compatibility, incidents, and UI review.
119
156
  Ordinary natural-language requests still work; the user does not need to manually
@@ -124,6 +161,7 @@ chain these modules.
124
161
  ```text
125
162
  .nccgs/
126
163
  project.yaml authority, model, studio, context, ownership and gate policy
164
+ framework-overrides.json reviewed project-specific framework customizations
127
165
  state.md compact recovery checkpoint
128
166
  requirements.yaml targeted requirement registry
129
167
  context/ task-specific source and ownership maps