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.
- package/.claude/agents/nccgs-adversarial-reviewer.md +7 -1
- package/.claude/agents/nccgs-engine-programmer.md +2 -1
- package/.claude/agents/nccgs-gameplay-programmer.md +2 -1
- package/.claude/agents/nccgs-qa-engineer.md +2 -1
- package/.claude/agents/nccgs-ui-programmer.md +2 -1
- package/.claude/agents/nccgs-unity-build-specialist.md +2 -1
- package/.claude/agents/nccgs-unity-implementer.md +2 -1
- package/.claude/agents/nccgs-unity-systems-specialist.md +2 -1
- package/.claude/agents/nccgs-unity-ui-specialist.md +2 -1
- package/.claude/agents/nccgs-verification-engineer.md +2 -1
- package/.claude/nccgs/VERSION +1 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-accessibility-specialist.md +0 -1
- package/.claude/nccgs/agent-library/nccgs-adversarial-reviewer.md +30 -0
- package/.claude/{agents → nccgs/agent-library}/nccgs-ai-programmer.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-analytics-engineer.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-art-direction-lead.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-audio-direction-lead.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-creative-director.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-documentation-manager.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-economy-designer.md +0 -1
- package/.claude/nccgs/agent-library/nccgs-engine-programmer.md +25 -0
- package/.claude/{agents → nccgs/agent-library}/nccgs-game-design-lead.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-game-designer.md +0 -1
- package/.claude/nccgs/agent-library/nccgs-gameplay-programmer.md +25 -0
- package/.claude/{agents → nccgs/agent-library}/nccgs-level-designer.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-live-ops-designer.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-localization-lead.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-narrative-lead.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-network-programmer.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-performance-analyst.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-producer.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-production-coordinator.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-programming-lead.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-prototyper.md +0 -1
- package/.claude/nccgs/agent-library/nccgs-qa-engineer.md +25 -0
- package/.claude/{agents → nccgs/agent-library}/nccgs-qa-lead.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-release-engineer.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-release-lead.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-security-engineer.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-sound-designer.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-systems-designer.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-technical-architect.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-technical-artist.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-technical-director.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-tools-programmer.md +0 -1
- package/.claude/nccgs/agent-library/nccgs-ui-programmer.md +25 -0
- package/.claude/nccgs/agent-library/nccgs-unity-build-specialist.md +25 -0
- package/.claude/{agents → nccgs/agent-library}/nccgs-unity-content-specialist.md +0 -1
- package/.claude/nccgs/agent-library/nccgs-unity-implementer.md +25 -0
- package/.claude/{agents → nccgs/agent-library}/nccgs-unity-rendering-specialist.md +0 -1
- package/.claude/nccgs/agent-library/nccgs-unity-systems-specialist.md +25 -0
- package/.claude/nccgs/agent-library/nccgs-unity-ui-specialist.md +25 -0
- package/.claude/{agents → nccgs/agent-library}/nccgs-ux-designer.md +0 -1
- package/.claude/nccgs/agent-library/nccgs-verification-engineer.md +25 -0
- package/.claude/{agents → nccgs/agent-library}/nccgs-world-builder.md +0 -1
- package/.claude/{agents → nccgs/agent-library}/nccgs-writer.md +0 -1
- package/.claude/nccgs/constitution.md +13 -0
- package/.claude/nccgs/hooks/agent-audit.mjs +6 -0
- package/.claude/nccgs/hooks/closure-guard.mjs +34 -0
- package/.claude/nccgs/hooks/runtime-observation.mjs +11 -0
- package/.claude/nccgs/hooks/session-start.mjs +8 -1
- package/.claude/nccgs/pipeline.json +176 -0
- package/.claude/nccgs/protocols/agent-contract.md +5 -0
- package/.claude/nccgs/protocols/astra-claude.md +77 -0
- package/.claude/nccgs/protocols/evidence.md +6 -0
- package/.claude/nccgs/protocols/model-routing.md +27 -5
- package/.claude/nccgs/protocols/orchestration.md +5 -0
- package/.claude/nccgs/protocols/task-gates.md +66 -0
- package/.claude/nccgs/routing.generated.md +11 -0
- package/.claude/nccgs/settings.fragment.json +73 -9
- package/.claude/nccgs/studio.json +187 -96
- package/.claude/nccgs/tools/approve-overrides.mjs +81 -0
- package/.claude/nccgs/tools/compile-policy.mjs +83 -0
- package/.claude/nccgs/tools/configure-models.mjs +76 -31
- package/.claude/nccgs/tools/gates.mjs +167 -0
- package/.claude/nccgs/tools/integrity.mjs +69 -0
- package/.claude/nccgs/tools/policy.mjs +62 -0
- package/.claude/nccgs/tools/runtime.mjs +40 -0
- package/.claude/nccgs/tools/task.mjs +77 -0
- package/.claude/nccgs/workflow-catalog.json +91 -14
- package/.claude/skills/accessibility-review/SKILL.md +6 -5
- package/.claude/skills/accessibility-review/references/astra.md +17 -0
- package/.claude/skills/accessibility-review/references/legacy.md +7 -0
- package/.claude/skills/architecture-decision/SKILL.md +6 -5
- package/.claude/skills/architecture-decision/references/astra.md +12 -0
- package/.claude/skills/architecture-decision/references/legacy.md +7 -0
- package/.claude/skills/asset-audit/SKILL.md +6 -5
- package/.claude/skills/asset-audit/references/astra.md +17 -0
- package/.claude/skills/asset-audit/references/legacy.md +7 -0
- package/.claude/skills/audit/SKILL.md +6 -7
- package/.claude/skills/audit/references/astra.md +17 -0
- package/.claude/skills/audit/references/legacy.md +9 -0
- package/.claude/skills/balance-review/SKILL.md +6 -5
- package/.claude/skills/balance-review/references/astra.md +17 -0
- package/.claude/skills/balance-review/references/legacy.md +7 -0
- package/.claude/skills/bug-triage/SKILL.md +6 -5
- package/.claude/skills/bug-triage/references/astra.md +20 -0
- package/.claude/skills/bug-triage/references/legacy.md +7 -0
- package/.claude/skills/closure/SKILL.md +5 -4
- package/.claude/skills/closure/references/astra.md +15 -0
- package/.claude/skills/closure/references/legacy.md +7 -0
- package/.claude/skills/compatibility-review/SKILL.md +6 -5
- package/.claude/skills/compatibility-review/references/astra.md +17 -0
- package/.claude/skills/compatibility-review/references/legacy.md +7 -0
- package/.claude/skills/context-pack/SKILL.md +5 -4
- package/.claude/skills/context-pack/references/astra.md +12 -0
- package/.claude/skills/context-pack/references/legacy.md +7 -0
- package/.claude/skills/dependency-review/SKILL.md +6 -5
- package/.claude/skills/dependency-review/references/astra.md +17 -0
- package/.claude/skills/dependency-review/references/legacy.md +7 -0
- package/.claude/skills/design/SKILL.md +6 -11
- package/.claude/skills/design/references/astra.md +12 -0
- package/.claude/skills/design/references/legacy.md +13 -0
- package/.claude/skills/design-review/SKILL.md +6 -5
- package/.claude/skills/design-review/references/astra.md +17 -0
- package/.claude/skills/design-review/references/legacy.md +7 -0
- package/.claude/skills/evidence-review/SKILL.md +6 -5
- package/.claude/skills/evidence-review/references/astra.md +17 -0
- package/.claude/skills/evidence-review/references/legacy.md +7 -0
- package/.claude/skills/hotfix/SKILL.md +6 -5
- package/.claude/skills/hotfix/references/astra.md +23 -0
- package/.claude/skills/hotfix/references/legacy.md +7 -0
- package/.claude/skills/incident-recovery/SKILL.md +6 -5
- package/.claude/skills/incident-recovery/references/astra.md +20 -0
- package/.claude/skills/incident-recovery/references/legacy.md +7 -0
- package/.claude/skills/localize-game/SKILL.md +6 -5
- package/.claude/skills/localize-game/references/astra.md +20 -0
- package/.claude/skills/localize-game/references/legacy.md +7 -0
- package/.claude/skills/migrate-project/SKILL.md +6 -14
- package/.claude/skills/migrate-project/references/astra.md +23 -0
- package/.claude/skills/migrate-project/references/legacy.md +19 -0
- package/.claude/skills/migrate-project/references/procedure.md +21 -1
- package/.claude/skills/milestone-review/SKILL.md +6 -5
- package/.claude/skills/milestone-review/references/astra.md +12 -0
- package/.claude/skills/milestone-review/references/legacy.md +7 -0
- package/.claude/skills/nccgs-code-review/SKILL.md +15 -0
- package/.claude/skills/nccgs-code-review/references/astra.md +15 -0
- package/.claude/skills/{code-review/SKILL.md → nccgs-code-review/references/legacy.md} +0 -7
- package/.claude/skills/performance-audit/SKILL.md +6 -5
- package/.claude/skills/performance-audit/references/astra.md +17 -0
- package/.claude/skills/performance-audit/references/legacy.md +7 -0
- package/.claude/skills/plan-feature/SKILL.md +6 -5
- package/.claude/skills/plan-feature/references/astra.md +12 -0
- package/.claude/skills/plan-feature/references/legacy.md +7 -0
- package/.claude/skills/playtest/SKILL.md +5 -4
- package/.claude/skills/playtest/references/astra.md +20 -0
- package/.claude/skills/playtest/references/legacy.md +7 -0
- package/.claude/skills/project-stage/SKILL.md +5 -4
- package/.claude/skills/project-stage/references/astra.md +12 -0
- package/.claude/skills/project-stage/references/legacy.md +7 -0
- package/.claude/skills/prototype-feature/SKILL.md +6 -5
- package/.claude/skills/prototype-feature/references/astra.md +20 -0
- package/.claude/skills/prototype-feature/references/legacy.md +7 -0
- package/.claude/skills/qa-plan/SKILL.md +6 -5
- package/.claude/skills/qa-plan/references/astra.md +12 -0
- package/.claude/skills/qa-plan/references/legacy.md +7 -0
- package/.claude/skills/release/SKILL.md +6 -9
- package/.claude/skills/release/references/astra.md +23 -0
- package/.claude/skills/release/references/legacy.md +11 -0
- package/.claude/skills/release-readiness/SKILL.md +6 -5
- package/.claude/skills/release-readiness/references/astra.md +17 -0
- package/.claude/skills/release-readiness/references/legacy.md +7 -0
- package/.claude/skills/retrospective/SKILL.md +6 -5
- package/.claude/skills/retrospective/references/astra.md +12 -0
- package/.claude/skills/retrospective/references/legacy.md +7 -0
- package/.claude/skills/review/SKILL.md +6 -7
- package/.claude/skills/review/references/astra.md +15 -0
- package/.claude/skills/review/references/legacy.md +9 -0
- package/.claude/skills/security-audit/SKILL.md +6 -5
- package/.claude/skills/security-audit/references/astra.md +17 -0
- package/.claude/skills/security-audit/references/legacy.md +7 -0
- package/.claude/skills/sprint-plan/SKILL.md +6 -5
- package/.claude/skills/sprint-plan/references/astra.md +12 -0
- package/.claude/skills/sprint-plan/references/legacy.md +7 -0
- package/.claude/skills/status/SKILL.md +5 -6
- package/.claude/skills/status/references/astra.md +13 -0
- package/.claude/skills/status/references/legacy.md +9 -0
- package/.claude/skills/story-readiness/SKILL.md +5 -4
- package/.claude/skills/story-readiness/references/astra.md +17 -0
- package/.claude/skills/story-readiness/references/legacy.md +7 -0
- package/.claude/skills/test/SKILL.md +6 -7
- package/.claude/skills/test/references/astra.md +20 -0
- package/.claude/skills/test/references/legacy.md +9 -0
- package/.claude/skills/ui-review/SKILL.md +6 -5
- package/.claude/skills/ui-review/references/astra.md +17 -0
- package/.claude/skills/ui-review/references/legacy.md +7 -0
- package/.claude/skills/work/SKILL.md +6 -27
- package/.claude/skills/work/references/astra.md +20 -0
- package/.claude/skills/work/references/closure.md +10 -0
- package/.claude/skills/work/references/feature-contracts.md +4 -0
- package/.claude/skills/work/references/legacy.md +29 -0
- package/README.md +67 -29
- package/UPGRADING.md +54 -4
- package/VERSION +1 -1
- package/docs/ARCHITECTURE.md +30 -13
- package/docs/HUONG-DAN-MIGRATE-VA-SU-DUNG.md +34 -322
- package/docs/MIGRATION-MATRIX.md +1 -1
- package/docs/NCCGS-1.3.md +125 -0
- package/docs/PROJECT-POLICY.md +18 -3
- package/docs/WORKFLOWS.md +20 -14
- package/package-assets/nccgs-project.gitignore +2 -0
- package/package.json +5 -3
- package/scaffold/.nccgs/gates.json +7 -0
- package/scaffold/.nccgs/project.yaml +6 -3
- package/scaffold/.nccgs/state.md +1 -1
- package/scaffold/.nccgs/templates/agent-handoff.md +10 -0
- package/scaffold/.nccgs/templates/closure-record.md +11 -0
- package/scaffold/.nccgs/templates/feature-contract.md +9 -0
- package/scaffold/.nccgs/templates/implementation-report.md +49 -0
- package/scripts/cli.mjs +10 -5
- package/scripts/doctor.mjs +102 -18
- package/scripts/install.mjs +221 -88
- package/scripts/validate.mjs +34 -6
- package/tests/framework.test.mjs +213 -8
- 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,
|
|
4
|
+
allowed-tools: Read, Glob, Grep, Bash, Agent, WebSearch, WebFetch
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Security Audit
|
|
8
8
|
|
|
9
|
-
Read
|
|
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
|
-
|
|
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,
|
|
4
|
+
allowed-tools: Read, Glob, Grep, Write, Edit, Agent, AskUserQuestion
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Sprint Plan
|
|
8
8
|
|
|
9
|
-
Read
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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,
|
|
4
|
+
allowed-tools: Read, Glob, Grep, Write, Edit, Bash, Agent, AskUserQuestion
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Test
|
|
8
8
|
|
|
9
|
-
Read
|
|
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
|
-
|
|
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,
|
|
4
|
+
allowed-tools: Read, Glob, Grep, Bash, Agent
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Ui Review
|
|
8
8
|
|
|
9
|
-
Read
|
|
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
|
-
|
|
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,
|
|
4
|
+
allowed-tools: Read, Glob, Grep, Write, Edit, Bash, Agent, AskUserQuestion, WebSearch, WebFetch
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Work
|
|
8
8
|
|
|
9
|
-
|
|
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
|
-
|
|
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.
|
|
8
|
+
Version 1.3.0 contains:
|
|
9
9
|
|
|
10
|
-
-
|
|
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
|
-
-
|
|
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
|
-
->
|
|
24
|
-
->
|
|
25
|
-
->
|
|
26
|
-
->
|
|
27
|
-
->
|
|
28
|
-
->
|
|
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
|
|
60
|
-
|
|
61
|
-
|
|
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
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
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 |
|
|
86
|
-
|
|
87
|
-
| `
|
|
88
|
-
| `
|
|
89
|
-
| `
|
|
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
|
-
|
|
92
|
-
|
|
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
|