nccgs 2.1.1 → 3.0.0-rc.2
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/CHANGELOG.md +76 -235
- package/LICENSE +1 -1
- package/README.md +87 -206
- package/THIRD_PARTY_NOTICES.md +6 -34
- package/bin/nccgs.mjs +96 -0
- package/cli/doctor.mjs +82 -0
- package/cli/feedback.mjs +13 -0
- package/cli/install.mjs +111 -0
- package/cli/release.mjs +59 -0
- package/cli/run.mjs +35 -0
- package/cli/spawn.mjs +20 -0
- package/cli/uninstall.mjs +43 -0
- package/cli/update-check.mjs +66 -0
- package/docs/EVIDENCE-VERIFICATION.md +22 -0
- package/package.json +23 -30
- package/runtime/core/diag.mjs +43 -0
- package/runtime/core/feedback-policy.mjs +54 -0
- package/runtime/core/fs.mjs +80 -0
- package/runtime/core/job-object.mjs +73 -0
- package/runtime/core/modes.mjs +87 -0
- package/runtime/core/process-tree.mjs +109 -0
- package/runtime/core/project.mjs +113 -0
- package/runtime/core/snapshot.mjs +114 -0
- package/runtime/hooks/common.mjs +22 -0
- package/runtime/hooks/done-guard.mjs +15 -0
- package/runtime/hooks/guard-mcp.mjs +8 -0
- package/runtime/hooks/guard-shell.mjs +16 -0
- package/runtime/hooks/guard-write.mjs +25 -0
- package/runtime/hooks/session-log.mjs +7 -0
- package/runtime/hooks/session-start.mjs +40 -0
- package/runtime/hooks/unity-transport.mjs +12 -0
- package/runtime/modes.json +39 -0
- package/runtime/task/cost.mjs +103 -0
- package/runtime/task/criteria.mjs +128 -0
- package/runtime/task/feedback.mjs +136 -0
- package/runtime/task/ledger.mjs +109 -0
- package/runtime/task/plan.mjs +69 -0
- package/runtime/task/project.mjs +79 -0
- package/runtime/task/report.mjs +252 -0
- package/runtime/task/task.mjs +238 -0
- package/runtime/unity/assets.mjs +51 -0
- package/runtime/unity/playtest.mjs +145 -0
- package/runtime/unity/unity.mjs +350 -0
- package/scripts/check-job-object.mjs +18 -0
- package/scripts/sync-unity-skills.mjs +35 -119
- package/template/CLAUDE.md +39 -0
- package/template/agents/fast-fix.md +9 -0
- package/template/agents/implementer.md +19 -0
- package/template/agents/playtester.md +15 -0
- package/template/agents/reviewer.md +19 -0
- package/template/agents/scout.md +9 -0
- package/template/ponytail/README.md +8 -0
- package/{.claude/nccgs/packages → template}/ponytail/engineering.md +10 -0
- package/template/protocols/evidence.md +52 -0
- package/template/protocols/playtest.md +45 -0
- package/template/protocols/review.md +34 -0
- package/template/protocols/unity-cli-notes.md +56 -0
- package/template/settings.fragment.json +33 -0
- package/template/skills/art-bible/SKILL.md +19 -0
- package/template/skills/asset-spec/SKILL.md +19 -0
- package/template/skills/brainstorm/SKILL.md +17 -0
- package/template/skills/feedback/SKILL.md +16 -0
- package/template/skills/map-systems/SKILL.md +25 -0
- package/template/skills/playtest/SKILL.md +17 -0
- package/template/skills/status/SKILL.md +18 -0
- package/template/skills/test/SKILL.md +34 -0
- package/template/skills/unity-foundation/SKILL.md +17 -0
- package/template/skills/vertical-slice/SKILL.md +17 -0
- package/template/skills/work/SKILL.md +65 -0
- package/tools/feedback-worker/README.md +12 -0
- package/tools/feedback-worker/worker.js +39 -0
- package/tools/feedback-worker/wrangler.toml +12 -0
- package/unity-skills/2d-pixel-perfect/SKILL.md +208 -0
- package/unity-skills/2d-pixel-perfect/references/api-reference.md +81 -0
- package/unity-skills/2d-pixel-perfect/references/camera-setup-builtin.cs +40 -0
- package/unity-skills/2d-pixel-perfect/references/camera-setup-urp.cs +49 -0
- package/unity-skills/2d-pixel-perfect/references/pipeline-detection.cs +50 -0
- package/unity-skills/2d-pixel-perfect/references/sprite-settings.cs +37 -0
- package/unity-skills/asset-transformer-toolkit/SECURITY.md +15 -0
- package/unity-skills/asset-transformer-toolkit/SKILL.md +39 -0
- package/unity-skills/asset-transformer-toolkit/references/create-importer.md +121 -0
- package/unity-skills/asset-transformer-toolkit/references/lods.md +61 -0
- package/unity-skills/asset-transformer-toolkit/references/rule-api.md +154 -0
- package/unity-skills/asset-transformer-toolkit/references/ruleblock-api.md +37 -0
- package/unity-skills/asset-transformer-toolkit/references/ruleset-api.md +138 -0
- package/unity-skills/asset-transformer-toolkit/references/rulesets-and-actions.md +227 -0
- package/unity-skills/audio-setup-mixers/SECURITY.md +16 -0
- package/unity-skills/audio-setup-mixers/SKILL.md +127 -0
- package/unity-skills/audio-setup-mixers/references/api.md +162 -0
- package/unity-skills/build-gtk/SKILL.md +242 -0
- package/unity-skills/build-gtk/references/graph-api.md +324 -0
- package/unity-skills/build-gtk/references/pitfalls.md +86 -0
- package/unity-skills/build-gtk/references/runtime-and-visualization.md +196 -0
- package/unity-skills/build-gtk/references/state-machine-api.md +286 -0
- package/unity-skills/build-live-game/SKILL.md +255 -0
- package/{.claude/skills → unity-skills}/build-live-game/references/achievements.md +132 -154
- package/{.claude/skills → unity-skills}/build-live-game/references/apis.md +10 -19
- package/{.claude/skills → unity-skills}/build-live-game/references/authentication.md +14 -20
- package/{.claude/skills → unity-skills}/build-live-game/references/battlepass.md +269 -225
- package/unity-skills/build-live-game/references/blueprints-and-samples.md +75 -0
- package/unity-skills/build-live-game/references/cloud-code-cloudbehaviours.md +1111 -0
- package/unity-skills/build-live-game/references/cloud-code-modules.md +1276 -0
- package/unity-skills/build-live-game/references/cloud-code.md +58 -0
- package/{.claude/skills → unity-skills}/build-live-game/references/cloud-save.md +15 -25
- package/{.claude/skills → unity-skills}/build-live-game/references/deployment.md +33 -18
- package/{.claude/skills → unity-skills}/build-live-game/references/player-account.md +31 -23
- package/{.claude/skills → unity-skills}/build-live-game/references/tooling.md +0 -56
- package/unity-skills/build-live-game/references/ugs-cli.md +86 -0
- package/unity-skills/craft-game-floors/SECURITY.md +23 -0
- package/unity-skills/craft-game-floors/SKILL.md +134 -0
- package/unity-skills/craft-game-floors/references/art-direction.md +85 -0
- package/unity-skills/craft-game-floors/references/camera-rigs.md +51 -0
- package/unity-skills/craft-game-floors/references/character-motion.md +35 -0
- package/unity-skills/craft-game-floors/references/game-audio.md +47 -0
- package/unity-skills/craft-game-floors/references/game-feel.md +68 -0
- package/unity-skills/craft-game-floors/references/game-shell.md +45 -0
- package/unity-skills/craft-game-floors/references/live-floor.md +35 -0
- package/unity-skills/craft-game-floors/references/placeholder-assets.md +35 -0
- package/unity-skills/craft-game-floors/references/scene-lighting.md +52 -0
- package/unity-skills/craft-game-floors/references/toon-shading.md +34 -0
- package/unity-skills/craft-game-floors/references/vfx.md +40 -0
- package/unity-skills/craft-game-floors/references/visual-scorecard.md +43 -0
- package/unity-skills/create-2d-physics/SECURITY.md +16 -0
- package/unity-skills/create-2d-physics/SKILL.md +128 -0
- package/unity-skills/create-2d-physics/references/2d-physics-core.md +155 -0
- package/unity-skills/create-2d-physics/references/legacy-2d-physics.md +45 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/SKILL.md +12 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/references/hexagonalruletile.md +71 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/references/palette-create.md +38 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile-createempty.md +35 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile-createfromsegment.md +212 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile.md +90 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/scripts/CreatePaletteTemplate.cs +148 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/scripts/ManualWorkflowExample.cs +63 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/scripts/RuleTileGenerator.cs +61 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/scripts/TilemapRuleTileCreateFromSegment.cs +225 -0
- package/unity-skills/generate-editor-search-query/SECURITY.md +17 -0
- package/unity-skills/generate-editor-search-query/SKILL.md +117 -0
- package/unity-skills/generate-editor-search-query/references/open-search-window.md +70 -0
- package/unity-skills/generate-editor-search-query/references/query-patterns.md +124 -0
- package/{.claude/skills → unity-skills}/implement-in-app-purchases/SKILL.md +1 -2
- package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/api-notes.md +25 -28
- package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-convert-native-google-billing.md +1 -1
- package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-implement-iap-d2c.md +40 -5
- package/{.claude/skills → unity-skills}/initialize-ai-navigation/SKILL.md +4 -4
- package/{.claude/skills → unity-skills}/initialize-ai-navigation/references/navigation-system.md +3 -3
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/CHANGELOG.md +12 -0
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/README.md +9 -5
- package/unity-skills/levelplay-unity-integration/SKILL.md +442 -0
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/banner-api.md +15 -8
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/best-practices.md +604 -536
- package/unity-skills/levelplay-unity-integration/references/dependency-resolution.md +94 -0
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/ilrd-api.md +2 -2
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/initialization-api.md +221 -0
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/interstitial-api.md +11 -3
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/ios-setup.md +6 -34
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/migration-sdk-9.md +1 -1
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/privacy-settings.md +14 -29
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/rewarded-api.md +20 -4
- package/unity-skills/levelplay-unity-integration/references/testing-and-validation.md +222 -0
- package/unity-skills/levelplay-unity-integration/references/troubleshooting.md +99 -0
- package/unity-skills/localization/SKILL.md +347 -0
- package/{.claude/skills → unity-skills}/localization/references/api-notes.md +4 -0
- package/unity-skills/localization/resources/L10nBatchProcessor.cs +191 -0
- package/unity-skills/manage-sprite-atlas/SKILL.md +351 -0
- package/unity-skills/manage-sprite-atlas/references/addressables-delivery.md +58 -0
- package/unity-skills/manage-sprite-atlas/references/api.md +382 -0
- package/unity-skills/manage-sprite-atlas/references/best-practices.md +183 -0
- package/unity-skills/manage-sprite-atlas/references/common-errors.md +123 -0
- package/unity-skills/manage-sprite-atlas/references/custom-packing.md +147 -0
- package/unity-skills/manage-sprite-atlas/references/manual-authoring.md +39 -0
- package/unity-skills/manage-sprite-atlas/resources/authoringvsruntime.cs +176 -0
- package/unity-skills/manage-sprite-atlas/resources/buildaddressablespostprocess.cs +59 -0
- package/unity-skills/manage-sprite-atlas/resources/cacheloadedatlases.cs +145 -0
- package/unity-skills/manage-sprite-atlas/resources/cleanupbatchoperations.cs +119 -0
- package/unity-skills/manage-sprite-atlas/resources/createandconfiguremasteratlas.cs +57 -0
- package/unity-skills/manage-sprite-atlas/resources/custompackersetup.cs +88 -0
- package/unity-skills/manage-sprite-atlas/resources/deprecatedmethods.cs +142 -0
- package/unity-skills/manage-sprite-atlas/resources/dontmodifywithoutsaving.cs +120 -0
- package/unity-skills/manage-sprite-atlas/resources/dontpackinruntimebuilds.cs +190 -0
- package/unity-skills/manage-sprite-atlas/resources/dontscriptspriteatlasineditor.cs +114 -0
- package/unity-skills/manage-sprite-atlas/resources/editorconfiguration.cs +95 -0
- package/unity-skills/manage-sprite-atlas/resources/enablespritepacking.cs +172 -0
- package/unity-skills/manage-sprite-atlas/resources/gridspritepacker.cs +50 -0
- package/unity-skills/manage-sprite-atlas/resources/handlelatebinding.cs +147 -0
- package/unity-skills/manage-sprite-atlas/resources/handlenullcases.cs +141 -0
- package/unity-skills/manage-sprite-atlas/resources/migratev1tov2.cs +335 -0
- package/unity-skills/manage-sprite-atlas/resources/multipagepacker.cs +80 -0
- package/unity-skills/manage-sprite-atlas/resources/optimizetexturesettings.cs +191 -0
- package/unity-skills/manage-sprite-atlas/resources/packerdebugging.cs +158 -0
- package/unity-skills/manage-sprite-atlas/resources/packtransform.cs +51 -0
- package/unity-skills/manage-sprite-atlas/resources/platformnames.cs +127 -0
- package/unity-skills/manage-sprite-atlas/resources/queryspritesefficiently.cs +222 -0
- package/unity-skills/manage-sprite-atlas/resources/registercallbacks.cs +152 -0
- package/unity-skills/manage-sprite-atlas/resources/runtimeatlasloader.cs +15 -0
- package/unity-skills/manage-sprite-atlas/resources/runtimespriteaccess.cs +19 -0
- package/unity-skills/manage-sprite-atlas/resources/savespriteatlasasset.cs +107 -0
- package/unity-skills/manage-sprite-atlas/resources/scriptablepacker.cs +81 -0
- package/unity-skills/manage-sprite-atlas/resources/setincludeinbuild.cs +164 -0
- package/unity-skills/manage-sprite-atlas/resources/sizeoptimizedpacker.cs +88 -0
- package/unity-skills/manage-sprite-atlas/resources/spriteatlaslatebinding.cs +123 -0
- package/unity-skills/manage-sprite-atlas/resources/spriteatlasprebuildgenerator.cs +219 -0
- package/unity-skills/manage-sprite-atlas/resources/spritedata.cs +35 -0
- package/unity-skills/manage-sprite-atlas/resources/spritepack.cs +39 -0
- package/unity-skills/manage-sprite-atlas/resources/texturedata.cs +15 -0
- package/unity-skills/manage-sprite-atlas/resources/updatebuildscripts.cs +357 -0
- package/unity-skills/manage-sprite-atlas/resources/updatesettingsconfiguration.cs +135 -0
- package/unity-skills/manage-sprite-atlas/resources/usevariantswisely.cs +179 -0
- package/unity-skills/manage-sprite-atlas/resources/variantatlas.cs +39 -0
- package/unity-skills/manifest.json +1155 -0
- package/unity-skills/migrate-birp-to-urp/SECURITY.md +16 -0
- package/unity-skills/migrate-birp-to-urp/SKILL.md +543 -0
- package/unity-skills/migrate-birp-to-urp/references/capturing-the-editor.md +66 -0
- package/unity-skills/migrate-birp-to-urp/references/complex-shader-situations.md +272 -0
- package/unity-skills/migrate-birp-to-urp/references/custom-shader-triage.md +123 -0
- package/unity-skills/migrate-birp-to-urp/references/implementation-patterns.md +529 -0
- package/unity-skills/migrate-birp-to-urp/references/migration-workflow.md +265 -0
- package/unity-skills/migrate-birp-to-urp/references/quality-settings-map.md +69 -0
- package/unity-skills/new-unity-project/SECURITY.md +26 -0
- package/unity-skills/new-unity-project/SKILL.md +386 -0
- package/unity-skills/new-unity-project/references/skill-setup.md +66 -0
- package/unity-skills/optimize-audio/SECURITY.md +16 -0
- package/{.claude/skills → unity-skills}/optimize-audio/SKILL.md +17 -17
- package/{.claude/skills → unity-skills}/optimize-audio/resources/audio-import-api.md +8 -5
- package/{.claude/skills → unity-skills}/optimize-text-mesh-pro/SKILL.md +1 -11
- package/unity-skills/optimize-web/SECURITY.md +16 -0
- package/{.claude/skills → unity-skills}/optimize-web/SKILL.md +164 -27
- package/unity-skills/optimize-web/scripts/WebOptimizer.cs +46 -0
- package/unity-skills/optimize-web/scripts/toktx-examples.sh +11 -0
- package/{.claude/skills → unity-skills}/physics-3d-collision/SKILL.md +2 -2
- package/unity-skills/physics-3d-collision/references/troubleshooting.md +8 -0
- package/unity-skills/project-auditor-fixes/SKILL.md +64 -0
- package/{.claude/skills → unity-skills}/setup-multiplayer-services/SKILL.md +1 -4
- package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/SKILL.md +1 -1
- package/{.claude/skills → unity-skills}/shader-graph-create-custom-node/SKILL.md +1 -1
- package/unity-skills/sprite-editor/SECURITY.md +16 -0
- package/{.claude/skills → unity-skills}/sprite-editor/SKILL.md +9 -9
- package/{.claude/skills → unity-skills}/sprite-editor/references/templates.md +1 -1
- package/unity-skills/sprite-segment-3x3grid/SKILL.md +136 -0
- package/unity-skills/sprite-segment-3x3grid/scripts/SpriteGridAnalysis.cs +119 -0
- package/{.claude/skills → unity-skills}/ui/SKILL.md +1 -1
- package/{.claude/skills → unity-skills}/ui-imgui/SKILL.md +1 -7
- package/{.claude/skills → unity-skills}/ui-ugui/SKILL.md +3 -9
- package/{.claude/skills → unity-skills}/ui-uitk/SKILL.md +8 -14
- package/{.claude/skills → unity-skills}/ui-uitk/references/custom-elements.md +1 -1
- package/unity-skills/unity-cli/CHANGELOG.md +515 -0
- package/unity-skills/unity-cli/SECURITY.md +68 -0
- package/unity-skills/unity-cli/SKILL.md +723 -0
- package/unity-skills/unity-cli/references/auth-license-cloud.md +318 -0
- package/unity-skills/unity-cli/references/build-run-test.md +555 -0
- package/unity-skills/unity-cli/references/cloud-automation.md +736 -0
- package/{.claude/skills → unity-skills}/unity-cli/references/collaboration.md +166 -105
- package/unity-skills/unity-cli/references/config-hub.md +239 -0
- package/unity-skills/unity-cli/references/diagnostics-maintenance.md +720 -0
- package/unity-skills/unity-cli/references/docs-workflow.md +179 -0
- package/unity-skills/unity-cli/references/editors-install.md +476 -0
- package/unity-skills/unity-cli/references/integration-advanced.md +1130 -0
- package/unity-skills/unity-cli/references/playmode-verification-loop.md +279 -0
- package/unity-skills/unity-cli/references/projects-templates.md +996 -0
- package/unity-skills/unity-cli/references/version-control.md +612 -0
- package/{.claude/skills → unity-skills}/unity-package-management/SKILL.md +60 -12
- package/{.claude/skills → unity-skills}/unity-package-management/references/select-packages.md +39 -21
- package/unity-skills/unity-pipeline/SECURITY.md +17 -0
- package/unity-skills/unity-pipeline/SKILL.md +335 -0
- package/unity-skills/urp-postprocessing/SECURITY.md +16 -0
- package/{.claude/skills → unity-skills}/urp-postprocessing/SKILL.md +12 -12
- package/{.claude/skills → unity-skills}/urp-postprocessing/references/code-templates.md +39 -8
- package/{.claude/skills → unity-skills}/validate-urp-render-graph-renderer-feature/SKILL.md +1 -1
- package/.claude/agents/nccgs-adversarial-reviewer.md +0 -43
- package/.claude/agents/nccgs-engine-programmer.md +0 -27
- package/.claude/agents/nccgs-fast-implementer.md +0 -30
- package/.claude/agents/nccgs-game-designer.md +0 -26
- package/.claude/agents/nccgs-gameplay-programmer.md +0 -26
- package/.claude/agents/nccgs-qa-engineer.md +0 -27
- package/.claude/agents/nccgs-task-scout.md +0 -24
- package/.claude/agents/nccgs-ui-programmer.md +0 -27
- package/.claude/agents/nccgs-unity-build-specialist.md +0 -27
- package/.claude/agents/nccgs-unity-implementer.md +0 -28
- package/.claude/agents/nccgs-unity-systems-specialist.md +0 -27
- package/.claude/agents/nccgs-unity-ui-specialist.md +0 -27
- package/.claude/agents/nccgs-verification-engineer.md +0 -27
- package/.claude/nccgs/MEMORY.md +0 -66
- package/.claude/nccgs/THIRD_PARTY_NOTICES.md +0 -29
- package/.claude/nccgs/VERSION +0 -1
- package/.claude/nccgs/agent-library/nccgs-accessibility-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-adversarial-reviewer.md +0 -41
- package/.claude/nccgs/agent-library/nccgs-ai-programmer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-analytics-engineer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-art-direction-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-audio-direction-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-creative-director.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-documentation-manager.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-economy-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-engine-programmer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-fast-implementer.md +0 -28
- package/.claude/nccgs/agent-library/nccgs-game-design-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-game-designer.md +0 -24
- package/.claude/nccgs/agent-library/nccgs-gameplay-programmer.md +0 -24
- package/.claude/nccgs/agent-library/nccgs-level-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-live-ops-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-localization-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-narrative-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-network-programmer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-performance-analyst.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-producer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-production-coordinator.md +0 -22
- package/.claude/nccgs/agent-library/nccgs-programming-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-prototyper.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-qa-engineer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-qa-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-release-engineer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-release-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-security-engineer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-sound-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-systems-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-task-scout.md +0 -22
- package/.claude/nccgs/agent-library/nccgs-technical-architect.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-technical-artist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-technical-director.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-tools-programmer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-ui-programmer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-unity-build-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-unity-content-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-unity-implementer.md +0 -26
- package/.claude/nccgs/agent-library/nccgs-unity-rendering-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-unity-systems-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-unity-ui-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-ux-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-verification-engineer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-world-builder.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-writer.md +0 -25
- package/.claude/nccgs/constitution.md +0 -187
- package/.claude/nccgs/hooks/agent-audit.mjs +0 -16
- package/.claude/nccgs/hooks/closure-guard.mjs +0 -59
- package/.claude/nccgs/hooks/common.mjs +0 -42
- package/.claude/nccgs/hooks/post-compact.mjs +0 -1
- package/.claude/nccgs/hooks/pre-compact.mjs +0 -8
- package/.claude/nccgs/hooks/protect-git.mjs +0 -22
- package/.claude/nccgs/hooks/protect-write.mjs +0 -17
- package/.claude/nccgs/hooks/runtime-observation.mjs +0 -11
- package/.claude/nccgs/hooks/session-start.mjs +0 -29
- package/.claude/nccgs/hooks/session-stop.mjs +0 -7
- package/.claude/nccgs/hooks/unity-transport-guard.mjs +0 -11
- package/.claude/nccgs/packages/ponytail/README.md +0 -46
- package/.claude/nccgs/packages/ponytail/manifest.json +0 -24
- package/.claude/nccgs/pipeline.json +0 -260
- package/.claude/nccgs/protocols/agent-contract.md +0 -101
- package/.claude/nccgs/protocols/astra-claude.md +0 -111
- package/.claude/nccgs/protocols/bounded-repair.md +0 -246
- package/.claude/nccgs/protocols/context-packets.md +0 -23
- package/.claude/nccgs/protocols/delivery-acceptance.md +0 -105
- package/.claude/nccgs/protocols/design-lifecycle.md +0 -139
- package/.claude/nccgs/protocols/editor-session-evidence.md +0 -52
- package/.claude/nccgs/protocols/evidence.md +0 -31
- package/.claude/nccgs/protocols/model-routing.md +0 -46
- package/.claude/nccgs/protocols/orchestration.md +0 -74
- package/.claude/nccgs/protocols/review-handoff.md +0 -101
- package/.claude/nccgs/protocols/shared-workflow-context.md +0 -33
- package/.claude/nccgs/protocols/standalone-gates.md +0 -329
- package/.claude/nccgs/protocols/standalone-pilot.md +0 -144
- package/.claude/nccgs/protocols/standalone.md +0 -207
- package/.claude/nccgs/protocols/task-autonomy.md +0 -55
- package/.claude/nccgs/protocols/task-gates.md +0 -144
- package/.claude/nccgs/protocols/task-slices.md +0 -106
- package/.claude/nccgs/protocols/unity-boundary.md +0 -31
- package/.claude/nccgs/routing.generated.md +0 -49
- package/.claude/nccgs/settings.fragment.json +0 -213
- package/.claude/nccgs/studio.json +0 -472
- package/.claude/nccgs/tools/approve-overrides.mjs +0 -81
- package/.claude/nccgs/tools/autonomy.mjs +0 -40
- package/.claude/nccgs/tools/command-process.mjs +0 -50
- package/.claude/nccgs/tools/command-tokens.mjs +0 -22
- package/.claude/nccgs/tools/compile-policy.mjs +0 -121
- package/.claude/nccgs/tools/configure-models.mjs +0 -96
- package/.claude/nccgs/tools/criteria.mjs +0 -121
- package/.claude/nccgs/tools/delivery-budget.mjs +0 -52
- package/.claude/nccgs/tools/design-readiness.mjs +0 -158
- package/.claude/nccgs/tools/editor-session-evidence.mjs +0 -66
- package/.claude/nccgs/tools/evidence.mjs +0 -153
- package/.claude/nccgs/tools/gates.mjs +0 -297
- package/.claude/nccgs/tools/handoff.mjs +0 -51
- package/.claude/nccgs/tools/hook-transport.mjs +0 -34
- package/.claude/nccgs/tools/inputs.mjs +0 -108
- package/.claude/nccgs/tools/installation-guard.mjs +0 -55
- package/.claude/nccgs/tools/integrity.mjs +0 -69
- package/.claude/nccgs/tools/lifecycle.mjs +0 -542
- package/.claude/nccgs/tools/native-completion.mjs +0 -30
- package/.claude/nccgs/tools/orchestration.mjs +0 -680
- package/.claude/nccgs/tools/paths.mjs +0 -60
- package/.claude/nccgs/tools/policy.mjs +0 -107
- package/.claude/nccgs/tools/process-lock.mjs +0 -74
- package/.claude/nccgs/tools/repair-packet.mjs +0 -106
- package/.claude/nccgs/tools/returned-handoff.mjs +0 -47
- package/.claude/nccgs/tools/review-budget.mjs +0 -171
- package/.claude/nccgs/tools/review-handoff.mjs +0 -66
- package/.claude/nccgs/tools/runtime.mjs +0 -71
- package/.claude/nccgs/tools/session-budget.mjs +0 -67
- package/.claude/nccgs/tools/shared-context-guard.mjs +0 -60
- package/.claude/nccgs/tools/shared-context.mjs +0 -25
- package/.claude/nccgs/tools/task-slices.mjs +0 -147
- package/.claude/nccgs/tools/task.mjs +0 -145
- package/.claude/nccgs/tools/tool-guard.mjs +0 -120
- package/.claude/nccgs/tools/unity-repair.mjs +0 -128
- package/.claude/nccgs/tools/unity-transport.mjs +0 -170
- package/.claude/nccgs/tools/verification-jobs.mjs +0 -171
- package/.claude/nccgs/tools/verification-worker.mjs +0 -71
- package/.claude/nccgs/tools/windows-compiler-server.cs +0 -163
- package/.claude/nccgs/tools/windows-job.cs +0 -103
- package/.claude/nccgs/unity-skills-manifest.json +0 -727
- package/.claude/nccgs/workflow-catalog.json +0 -654
- package/.claude/rules/nccgs-canonical-docs.md +0 -19
- package/.claude/rules/nccgs-editor-tools.md +0 -12
- package/.claude/rules/nccgs-localization.md +0 -12
- package/.claude/rules/nccgs-networking.md +0 -13
- package/.claude/rules/nccgs-performance.md +0 -14
- package/.claude/rules/nccgs-rendering.md +0 -16
- package/.claude/rules/nccgs-security.md +0 -13
- package/.claude/rules/nccgs-tests.md +0 -18
- package/.claude/rules/nccgs-ui.md +0 -14
- package/.claude/rules/nccgs-unity-assets.md +0 -21
- package/.claude/rules/nccgs-unity-code.md +0 -22
- package/.claude/skills/accessibility-review/SKILL.md +0 -22
- package/.claude/skills/accessibility-review/references/astra.md +0 -17
- package/.claude/skills/accessibility-review/references/legacy.md +0 -7
- package/.claude/skills/architecture-decision/SKILL.md +0 -22
- package/.claude/skills/architecture-decision/references/astra.md +0 -12
- package/.claude/skills/architecture-decision/references/legacy.md +0 -7
- package/.claude/skills/asset-audit/SKILL.md +0 -22
- package/.claude/skills/asset-audit/references/astra.md +0 -17
- package/.claude/skills/asset-audit/references/legacy.md +0 -7
- package/.claude/skills/audit/SKILL.md +0 -22
- package/.claude/skills/audit/references/astra.md +0 -17
- package/.claude/skills/audit/references/dimensions.md +0 -46
- package/.claude/skills/audit/references/legacy.md +0 -9
- package/.claude/skills/balance-review/SKILL.md +0 -22
- package/.claude/skills/balance-review/references/astra.md +0 -17
- package/.claude/skills/balance-review/references/legacy.md +0 -7
- package/.claude/skills/bug-triage/SKILL.md +0 -22
- package/.claude/skills/bug-triage/references/astra.md +0 -27
- package/.claude/skills/bug-triage/references/legacy.md +0 -7
- package/.claude/skills/build-live-game/SKILL.md +0 -317
- package/.claude/skills/build-live-game/references/cloud-code.md +0 -563
- package/.claude/skills/closure/SKILL.md +0 -22
- package/.claude/skills/closure/references/astra.md +0 -15
- package/.claude/skills/closure/references/legacy.md +0 -7
- package/.claude/skills/compatibility-review/SKILL.md +0 -22
- package/.claude/skills/compatibility-review/references/astra.md +0 -17
- package/.claude/skills/compatibility-review/references/legacy.md +0 -7
- package/.claude/skills/context-pack/SKILL.md +0 -22
- package/.claude/skills/context-pack/references/astra.md +0 -12
- package/.claude/skills/context-pack/references/legacy.md +0 -7
- package/.claude/skills/dependency-review/SKILL.md +0 -22
- package/.claude/skills/dependency-review/references/astra.md +0 -17
- package/.claude/skills/dependency-review/references/legacy.md +0 -7
- package/.claude/skills/design/SKILL.md +0 -24
- package/.claude/skills/design/references/astra.md +0 -12
- package/.claude/skills/design/references/legacy.md +0 -13
- package/.claude/skills/design-review/SKILL.md +0 -24
- package/.claude/skills/design-review/references/astra.md +0 -17
- package/.claude/skills/design-review/references/legacy.md +0 -7
- package/.claude/skills/evidence-review/SKILL.md +0 -22
- package/.claude/skills/evidence-review/references/astra.md +0 -17
- package/.claude/skills/evidence-review/references/legacy.md +0 -7
- package/.claude/skills/hotfix/SKILL.md +0 -22
- package/.claude/skills/hotfix/references/astra.md +0 -30
- package/.claude/skills/hotfix/references/legacy.md +0 -7
- package/.claude/skills/incident-recovery/SKILL.md +0 -22
- package/.claude/skills/incident-recovery/references/astra.md +0 -27
- package/.claude/skills/incident-recovery/references/legacy.md +0 -7
- package/.claude/skills/levelplay-unity-integration/SKILL.md +0 -1126
- package/.claude/skills/localization/SKILL.md +0 -135
- package/.claude/skills/localization/resources/L10nBatchProcessor.cs +0 -69
- package/.claude/skills/localize-game/SKILL.md +0 -22
- package/.claude/skills/localize-game/references/astra.md +0 -27
- package/.claude/skills/localize-game/references/legacy.md +0 -7
- package/.claude/skills/migrate-project/SKILL.md +0 -22
- package/.claude/skills/migrate-project/references/astra.md +0 -30
- package/.claude/skills/migrate-project/references/legacy.md +0 -19
- package/.claude/skills/migrate-project/references/procedure.md +0 -96
- package/.claude/skills/milestone-review/SKILL.md +0 -22
- package/.claude/skills/milestone-review/references/astra.md +0 -12
- package/.claude/skills/milestone-review/references/legacy.md +0 -7
- package/.claude/skills/nccgs-code-review/SKILL.md +0 -22
- package/.claude/skills/nccgs-code-review/references/astra.md +0 -21
- package/.claude/skills/nccgs-code-review/references/legacy.md +0 -7
- package/.claude/skills/new-unity-project/SKILL.md +0 -179
- package/.claude/skills/performance-audit/SKILL.md +0 -22
- package/.claude/skills/performance-audit/references/astra.md +0 -17
- package/.claude/skills/performance-audit/references/legacy.md +0 -7
- package/.claude/skills/physics-3d-collision/references/troubleshooting.md +0 -41
- package/.claude/skills/plan-feature/SKILL.md +0 -22
- package/.claude/skills/plan-feature/references/astra.md +0 -12
- package/.claude/skills/plan-feature/references/legacy.md +0 -7
- package/.claude/skills/playtest/SKILL.md +0 -22
- package/.claude/skills/playtest/references/astra.md +0 -31
- package/.claude/skills/playtest/references/legacy.md +0 -7
- package/.claude/skills/project-stage/SKILL.md +0 -22
- package/.claude/skills/project-stage/references/astra.md +0 -12
- package/.claude/skills/project-stage/references/legacy.md +0 -7
- package/.claude/skills/prototype-feature/SKILL.md +0 -22
- package/.claude/skills/prototype-feature/references/astra.md +0 -31
- package/.claude/skills/prototype-feature/references/legacy.md +0 -7
- package/.claude/skills/qa-plan/SKILL.md +0 -22
- package/.claude/skills/qa-plan/references/astra.md +0 -12
- package/.claude/skills/qa-plan/references/legacy.md +0 -7
- package/.claude/skills/release/SKILL.md +0 -22
- package/.claude/skills/release/references/astra.md +0 -30
- package/.claude/skills/release/references/legacy.md +0 -11
- package/.claude/skills/release-readiness/SKILL.md +0 -22
- package/.claude/skills/release-readiness/references/astra.md +0 -17
- package/.claude/skills/release-readiness/references/legacy.md +0 -7
- package/.claude/skills/retrospective/SKILL.md +0 -22
- package/.claude/skills/retrospective/references/astra.md +0 -12
- package/.claude/skills/retrospective/references/legacy.md +0 -7
- package/.claude/skills/review/SKILL.md +0 -22
- package/.claude/skills/review/references/astra.md +0 -21
- package/.claude/skills/review/references/legacy.md +0 -9
- package/.claude/skills/security-audit/SKILL.md +0 -22
- package/.claude/skills/security-audit/references/astra.md +0 -17
- package/.claude/skills/security-audit/references/legacy.md +0 -7
- package/.claude/skills/sprint-plan/SKILL.md +0 -22
- package/.claude/skills/sprint-plan/references/astra.md +0 -12
- package/.claude/skills/sprint-plan/references/legacy.md +0 -7
- package/.claude/skills/status/SKILL.md +0 -22
- package/.claude/skills/status/references/astra.md +0 -19
- package/.claude/skills/status/references/legacy.md +0 -9
- package/.claude/skills/story-readiness/SKILL.md +0 -24
- package/.claude/skills/story-readiness/references/astra.md +0 -17
- package/.claude/skills/story-readiness/references/legacy.md +0 -7
- package/.claude/skills/test/SKILL.md +0 -22
- package/.claude/skills/test/references/astra.md +0 -27
- package/.claude/skills/test/references/legacy.md +0 -9
- package/.claude/skills/ui-review/SKILL.md +0 -22
- package/.claude/skills/ui-review/references/astra.md +0 -17
- package/.claude/skills/ui-review/references/legacy.md +0 -7
- package/.claude/skills/unity-cli/CHANGELOG.md +0 -233
- package/.claude/skills/unity-cli/SECURITY.md +0 -22
- package/.claude/skills/unity-cli/SKILL.md +0 -414
- package/.claude/skills/unity-cli/references/auth-license-cloud.md +0 -146
- package/.claude/skills/unity-cli/references/build-run-test.md +0 -349
- package/.claude/skills/unity-cli/references/config-hub.md +0 -103
- package/.claude/skills/unity-cli/references/diagnostics-maintenance.md +0 -326
- package/.claude/skills/unity-cli/references/editors-install.md +0 -327
- package/.claude/skills/unity-cli/references/integration-advanced.md +0 -472
- package/.claude/skills/unity-cli/references/projects-templates.md +0 -574
- package/.claude/skills/work/SKILL.md +0 -22
- package/.claude/skills/work/references/astra.md +0 -32
- package/.claude/skills/work/references/classification.md +0 -41
- package/.claude/skills/work/references/closure.md +0 -60
- package/.claude/skills/work/references/feature-contracts.md +0 -36
- package/.claude/skills/work/references/legacy.md +0 -29
- package/.claude/skills/work/references/verification.md +0 -26
- package/CLAUDE.md +0 -10
- package/MEMORY.md +0 -109
- package/UPGRADING.md +0 -130
- package/VERSION +0 -1
- package/docs/ARCHITECTURE.md +0 -131
- package/docs/ASSET-PRODUCTION-GRAPHIFY-PLAN.md +0 -230
- package/docs/BOUNDED-REPAIR.md +0 -80
- package/docs/EDITOR-SESSION-EVIDENCE.md +0 -52
- package/docs/HANDOFF-AUTOMATION.md +0 -144
- package/docs/HUONG-DAN-MIGRATE-VA-SU-DUNG.md +0 -117
- package/docs/MIGRATION-MATRIX.md +0 -23
- package/docs/NCCGS-1.3.md +0 -13
- package/docs/NCCGS-1.4.1.md +0 -149
- package/docs/NCCGS-1.4.md +0 -184
- package/docs/NCCGS-1.5-IMPLEMENTATION-PLAN.md +0 -378
- package/docs/NCCGS-1.5-PILOT.md +0 -130
- package/docs/NCCGS-1.5.md +0 -237
- package/docs/PHASE-1-OPERATIONS.md +0 -278
- package/docs/PHASE-2-OPERATIONS.md +0 -183
- package/docs/PROJECT-POLICY.md +0 -94
- package/docs/RELEASE-STATUS.md +0 -150
- package/docs/TASK-SLICING.md +0 -57
- package/docs/UNINSTALL.md +0 -134
- package/docs/UPGRADE-QUALIFICATION.md +0 -45
- package/docs/WFK17-HOOK-REPAIR.md +0 -71
- package/docs/WORKFLOWS.md +0 -85
- package/package-assets/nccgs-project.gitignore +0 -2
- package/package-assets/setup-vivox-voice-chat-evals.gitignore +0 -7
- package/scaffold/.nccgs/autonomy.json +0 -4
- package/scaffold/.nccgs/bugs/.gitkeep +0 -1
- package/scaffold/.nccgs/closures/.gitkeep +0 -1
- package/scaffold/.nccgs/context/.gitkeep +0 -1
- package/scaffold/.nccgs/decisions/.gitkeep +0 -1
- package/scaffold/.nccgs/evidence/.gitkeep +0 -1
- package/scaffold/.nccgs/execution.json +0 -10
- package/scaffold/.nccgs/features/.gitkeep +0 -1
- package/scaffold/.nccgs/gates.json +0 -7
- package/scaffold/.nccgs/inputs.json +0 -6
- package/scaffold/.nccgs/migrations/.gitkeep +0 -1
- package/scaffold/.nccgs/playtests/.gitkeep +0 -1
- package/scaffold/.nccgs/project.yaml +0 -109
- package/scaffold/.nccgs/requirements.yaml +0 -10
- package/scaffold/.nccgs/reviews/.gitkeep +0 -1
- package/scaffold/.nccgs/state.md +0 -40
- package/scaffold/.nccgs/templates/agent-handoff.md +0 -37
- package/scaffold/.nccgs/templates/architecture-decision.md +0 -27
- package/scaffold/.nccgs/templates/closure-record.md +0 -62
- package/scaffold/.nccgs/templates/context-packet.yaml +0 -17
- package/scaffold/.nccgs/templates/design-contract.json +0 -34
- package/scaffold/.nccgs/templates/evidence-record.md +0 -23
- package/scaffold/.nccgs/templates/feature-contract.md +0 -60
- package/scaffold/.nccgs/templates/implementation-report.md +0 -52
- package/scaffold/.nccgs/templates/migration-plan.md +0 -40
- package/scaffold/.nccgs/templates/repair-packet.json +0 -14
- package/scaffold/.nccgs/templates/repair-unity-code.json +0 -18
- package/scaffold/.nccgs/templates/repair-unity-editor.json +0 -21
- package/scaffold/.nccgs/templates/task-slices.json +0 -28
- package/scaffold/.nccgs/templates/waiver.md +0 -11
- package/scripts/benchmark-snapshot.mjs +0 -205
- package/scripts/benchmark-v15.mjs +0 -173
- package/scripts/cli.mjs +0 -205
- package/scripts/doctor.mjs +0 -261
- package/scripts/install.mjs +0 -530
- package/scripts/recover-session.mjs +0 -89
- package/scripts/run.mjs +0 -86
- package/scripts/supervise.mjs +0 -152
- package/scripts/uninstall.mjs +0 -292
- package/scripts/validate.mjs +0 -285
- package/scripts/work-handoff.mjs +0 -38
- package/tests/autonomy.test.mjs +0 -126
- package/tests/benchmark-v15.test.mjs +0 -65
- package/tests/design-readiness.test.mjs +0 -200
- package/tests/editor-session-evidence.test.mjs +0 -45
- package/tests/evidence.test.mjs +0 -186
- package/tests/fixtures/compiler-shutdown.cs +0 -67
- package/tests/fixtures/native-provider.mjs +0 -61
- package/tests/framework.test.mjs +0 -740
- package/tests/gates.test.mjs +0 -479
- package/tests/hook-repair.test.mjs +0 -106
- package/tests/lifecycle-v15.test.mjs +0 -346
- package/tests/native-completion-notices.test.mjs +0 -181
- package/tests/orchestration-v15.test.mjs +0 -596
- package/tests/phase1.test.mjs +0 -427
- package/tests/phase2.test.mjs +0 -250
- package/tests/policy-v15.test.mjs +0 -234
- package/tests/ponytail-package.test.mjs +0 -75
- package/tests/returned-handoff-notices.test.mjs +0 -170
- package/tests/review-budget.test.mjs +0 -177
- package/tests/runtime-v15.test.mjs +0 -1198
- package/tests/session-budget.test.mjs +0 -34
- package/tests/task-slices.test.mjs +0 -285
- package/tests/uninstall.test.mjs +0 -477
- package/tests/unity-generated.test.mjs +0 -140
- package/tests/unity-transport.test.mjs +0 -348
- /package/{.claude/nccgs/packages → template}/ponytail/LICENSE +0 -0
- /package/{.claude/nccgs/packages → template}/ponytail/NOTICE.md +0 -0
- /package/{.claude/nccgs/packages → template}/ponytail/complexity-review.md +0 -0
- /package/{.claude/skills → unity-skills}/build-live-game/references/remote-config.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/README.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/codeless-catalog.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-adapty.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-essentialkit.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-revenuecat.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-unipay.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/migration-v4-to-v5.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-add-iap-to-new-project.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-convert-native-storekit.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/platform-notes.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/pre-check.md +0 -0
- /package/{.claude/skills → unity-skills}/localization/resources/LocalizedFontAsset.cs +0 -0
- /package/{.claude/skills → unity-skills}/optimize-audio/resources/platform-settings.md +0 -0
- /package/{.claude/skills → unity-skills}/optimize-web/resources/WebOptimizer.cs +0 -0
- /package/{.claude/skills → unity-skills}/optimize-web/resources/toktx-examples.sh +0 -0
- /package/{.claude/skills → unity-skills}/physics-3d-collision/resources/CollisionDebugger.cs +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/dgs-entrypoint.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/entrypoints.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/examples.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/implementation-fit.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/underlying-services.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/workflows-prerequisites.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/.env.example +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/README.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/promptfooconfig.yaml +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/init-and-login.yaml +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/text-chat.yaml +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/voice-channels.yaml +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/events-and-participants.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/init-and-login.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/text-chat.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/troubleshooting.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/voice-channels.md +0 -0
- /package/{.claude/skills → unity-skills}/shader-graph-create-custom-node/resources/all_hints.hlsl +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/references/api_reference.md +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/references/background.md +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/AutomaticSliceTexture.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GenerateNewSpriteRects.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GetTextureSourceImageSize.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GetTextureToSlice.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GridSliceTexture.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/IsometricSliceTexture.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/README.md +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/SetPivotExample.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/SpriteToPng.cs +0 -0
- /package/{.claude/skills → unity-skills}/ui-imgui/references/gui-elements.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-imgui/references/templates.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-ugui/references/scrollview-setup.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/common-issues.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/painter2d.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/pointermanipulator-guide.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/svg-icons.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/ui-runtime-binding.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/uss-guide.md +0 -0
- /package/{.claude/skills → unity-skills}/urp-postprocessing/references/effect-reference.md +0 -0
|
@@ -1,378 +0,0 @@
|
|
|
1
|
-
> Historical development/reference document. Version, status, commands and plans
|
|
2
|
-
> below describe their original scope, not the current package defaults. Read
|
|
3
|
-
> [current release guidance](RELEASE-STATUS.md) before use. Research/benchmark proposals
|
|
4
|
-
> do not automatically add requirements to a delivery contract.
|
|
5
|
-
|
|
6
|
-
# Kế hoạch triển khai NCCGS 1.5 và đánh giá điều kiện phát hành 2.0
|
|
7
|
-
|
|
8
|
-
Ngày lập: 02/10/2026, múi giờ Asia/Saigon. Trạng thái: đề xuất triển khai để review. Đối tượng: Product Owner, người triển khai NCCGS và người đánh giá độc lập.
|
|
9
|
-
|
|
10
|
-
Mục tiêu là để NCCGS nhận prompt hoặc plan của người dùng, tự phân loại công việc, chọn cách triển khai vừa đủ, kiểm thử và báo cáo có bằng chứng. NCCGS phải làm được việc này khi không có Astra. Astra hoặc reviewer bên ngoài chỉ là lớp kiểm tra được bật riêng.
|
|
11
|
-
|
|
12
|
-
Tài liệu này là kế hoạch cho 1.5 và điều kiện nâng lên 2.0. Nền 1.4.1 đã được triển khai ngày 02/10/2026; báo cáo kỹ thuật riêng nằm tại `reports/NCCGS-1.4.1-IMPLEMENTATION-REPORT.md` trong repository. Game demo, standalone core 1.5 và benchmark tác vụ với model thật chưa được triển khai. Các con số về số lượt chạy và ngưỡng nghiệm thu bên dưới là đề xuất cần khóa trước thí nghiệm, không phải kết quả đã đo. Phép đo snapshot tổng hợp của 1.4.1 được báo cáo riêng, không thay thế benchmark game.
|
|
13
|
-
|
|
14
|
-
## 1. Phạm vi và chiến lược phiên bản
|
|
15
|
-
|
|
16
|
-
| Mốc | Mục đích | Điều kiện chuyển tiếp |
|
|
17
|
-
|---|---|---|
|
|
18
|
-
| 1.4.1 | Sửa lỗi nền ảnh hưởng tính toàn vẹn, cài đặt và khả năng kiểm tra lại bằng chứng; giữ nghĩa workflow cũ | Kiểm thử hồi quy và migration qua; đủ an toàn để cài vào dự án demo cô lập |
|
|
19
|
-
| 1.5 preview | Bổ sung core độc lập, phân loại thích ứng, policy review ngoài và ghi nhận hiệu quả | Chạy hết vòng đời bằng fixture và phiên model thật nhỏ, không cần Astra |
|
|
20
|
-
| 1.5 candidate | Hoàn thiện hành vi, tài liệu và tính tương thích; đóng băng cấu hình ứng viên | Chạy benchmark game và stress test theo giao thức đã khóa |
|
|
21
|
-
| 1.5 stable hoặc 2.0 candidate | Quyết định theo kết quả và thay đổi hợp đồng công khai | Chất lượng, hiệu quả, migration và khả năng vận hành đạt các gate ở mục 14 |
|
|
22
|
-
|
|
23
|
-
Lộ trình ưu tiên: hoàn thành 1.4.1, sau đó mới tạo demo/checkpoint; việc phát triển 1.5 và chuẩn bị bộ đánh giá có thể chạy song song với quyền sở hữu file tách biệt. Benchmark chính thức chỉ chạy khi có 1.5 candidate đã đóng băng. Nếu bỏ mốc phát hành 1.4.1, đưa toàn bộ sửa lỗi nền vào 1.5 rồi mới tạo demo. Không tạo game trong giai đoạn lập kế hoạch hiện tại.
|
|
24
|
-
|
|
25
|
-
Theo [Semantic Versioning](https://semver.org/), patch dành cho sửa lỗi tương thích, minor cho khả năng mới tương thích và major cho thay đổi hợp đồng không tương thích. Vì vậy, 2.0 không chỉ là đổi tên vì điểm benchmark tốt. Trước khi phát hành cần công bố hợp đồng được hỗ trợ: CLI, schema task/policy, ý nghĩa trạng thái, điều kiện nghiệm thu và hành vi cập nhật.
|
|
26
|
-
|
|
27
|
-
Trong preview, standalone được chọn rõ ràng để kiểm tra độc lập. Mặc định sản phẩm đề xuất được chốt trong bảng dưới. Cài mới và cập nhật là hai trường hợp tương thích cần đánh giá riêng: nếu thay đổi mặc định cài mới phá một hợp đồng CLI đã công bố, ứng viên phải phát hành theo major mới; nếu vẫn bảo toàn hợp đồng được hỗ trợ, có thể phát hành 1.5. Không dùng việc giữ policy update để tự kết luận mọi thay đổi đều tương thích.
|
|
28
|
-
|
|
29
|
-
| Trường hợp | Execution policy đề xuất | Review ngoài |
|
|
30
|
-
|---|---|---|
|
|
31
|
-
| Cài mới ứng viên độc lập và bản ổn định mới | Standalone | Off |
|
|
32
|
-
| Update dự án 1.4 chưa yêu cầu đổi workflow | Chế độ tương thích 1.4 | Giữ điều kiện Astra hiện có |
|
|
33
|
-
| Dự án cũ chủ động chuyển standalone | Standalone sau migration có dry-run | Off, trừ khi người dùng chọn advisory/required |
|
|
34
|
-
| Cài mới 2.0 nếu được phát hành | Standalone | Off |
|
|
35
|
-
|
|
36
|
-
Các tên policy trong bảng là thiết kế đề xuất, chưa phải cờ CLI đã triển khai. Dự án mới phải dùng được mà không cần biết Astra là gì.
|
|
37
|
-
|
|
38
|
-
Ngoài phạm vi: marketplace agent, workflow engine tổng quát, hỗ trợ nhiều engine mới, bridge tự nhắn giữa ứng dụng, dashboard web, backend game, multiplayer, quảng cáo và thanh toán. Những phần này không cần để chứng minh mục tiêu 1.5.
|
|
39
|
-
|
|
40
|
-
## 2. Điểm xuất phát đã biết
|
|
41
|
-
|
|
42
|
-
Lần kiểm chứng trước trong phiên làm việc ghi nhận 30/30 bài kiểm tra framework qua, validation và policy check qua. Đây là bằng chứng của cơ chế được kiểm tra, chưa phải benchmark làm game. Trong lần lập kế hoạch này chỉ đọc lại nguồn; không chạy lại toàn bộ test và không chạy model/Unity benchmark.
|
|
43
|
-
|
|
44
|
-
| Hiện trạng | Ý nghĩa với kế hoạch |
|
|
45
|
-
|---|---|
|
|
46
|
-
| `pipeline.json` gắn owner và chuỗi bước với Astra; `task.mjs` chỉ nhận profile `astra-claude` | Phải tách policy, model profile và review ngoài ở cả code lẫn tài liệu |
|
|
47
|
-
| `gates.mjs` có stage Astra cố định; compiler và doctor cũng dựa trên hợp đồng đó | Sửa prompt hoặc xóa một đoạn hướng dẫn không đủ |
|
|
48
|
-
| Có hướng dẫn FAST/STANDARD/CONTROLLED và routing theo tier | Tái sử dụng nền này; bổ sung bằng chứng phân loại, mode và tái phân loại |
|
|
49
|
-
| Review cap đếm review đã ghi; chưa giữ chỗ trước khi gọi song song | Cần kiểm soát dispatch do NCCGS quản lý nếu muốn giới hạn thực số lượt review |
|
|
50
|
-
| Runtime có một phần duration/tool count; effort native chưa quan sát được | Tách tính đúng của kết quả khỏi mức chắc chắn về model/effort và tính đầy đủ của số đo |
|
|
51
|
-
| Snapshot loại toàn bộ `.nccgs`; một số nguồn yêu cầu tham chiếu chưa được ghim | Cần manifest đầu vào chuẩn và invalidation đúng |
|
|
52
|
-
| Observation cùng source nằm trong runtime được ignore | Cần evidence bền vững để kiểm tra lại từ bản sao sạch |
|
|
53
|
-
|
|
54
|
-
Các phát hiện trước về đường dẫn installer, doctor bỏ sót cấu hình hook, requirements không làm stale closure và evidence không đi theo bản sao sạch phải được tái hiện bằng test hồi quy trước khi sửa. Không coi chúng đã được xử lý chỉ vì 30 bài test hiện hữu xanh.
|
|
55
|
-
|
|
56
|
-
## 3. Yêu cầu sản phẩm cần nghiệm thu
|
|
57
|
-
|
|
58
|
-
| Mã | Cam kết của 1.5 | Bằng chứng bắt buộc |
|
|
59
|
-
|---|---|---|
|
|
60
|
-
| R1 | Nhận prompt hoặc plan từ người dùng trực tiếp | Hoàn thành một task không có dữ liệu, tài khoản hoặc quyết định Astra |
|
|
61
|
-
| R2 | Hiểu đúng implement, diagnose/audit và plan | Task chỉ đọc không sửa code; task lập kế hoạch không tự triển khai |
|
|
62
|
-
| R3 | Tự phân loại có lý do và điều chỉnh khi có dữ kiện mới | Bản phân loại, dấu hiệu rủi ro, lịch sử trước/sau và phần evidence bị vô hiệu |
|
|
63
|
-
| R4 | Phân bổ tương xứng với công việc | Có lý do cho mỗi agent, phần việc độc lập, model và giới hạn vòng xử lý |
|
|
64
|
-
| R5 | Kiểm tra kết quả theo đúng loại đầu ra | UI có bằng chứng hình ảnh/runtime; tối ưu có số đo; tích hợp có test xuyên luồng |
|
|
65
|
-
| R6 | Báo cáo cả thành công, thất bại và công việc chưa đủ bằng chứng | Có report ngay cả khi review không PASS hoặc đang chờ quyết định |
|
|
66
|
-
| R7 | Review ngoài tùy chọn | Tắt không tạo blocker; advisory không chặn; required chỉ chặn gate đã khai báo |
|
|
67
|
-
| R8 | Dừng và tiếp tục đúng | Khôi phục task không mất tiến độ hoặc reset ngân sách; không tạo PASS thay người khác |
|
|
68
|
-
| R9 | Đo được hiệu quả và giới hạn dữ liệu | Ghi thời gian, can thiệp, lần thử, chi phí nếu quan sát được; trường thiếu không thành 0 |
|
|
69
|
-
| R10 | Cập nhật có thể kiểm tra và khôi phục | Giữ tùy chỉnh, lịch sử, policy dự án cũ; không tự biến approval cũ thành approval mới |
|
|
70
|
-
|
|
71
|
-
Người dùng giao mục tiêu là đủ để thực hiện các thao tác kỹ thuật thông thường trong phạm vi đó. NCCGS tự tìm dữ kiện kỹ thuật còn thiếu; chỉ hỏi khi câu trả lời làm thay đổi sản phẩm, phạm vi, tradeoff quan trọng hoặc quyền nghiệm thu. Không yêu cầu người dùng tự chọn tier hay điền toàn bộ biểu mẫu nội bộ.
|
|
72
|
-
|
|
73
|
-
## 4. Kiến trúc core độc lập
|
|
74
|
-
|
|
75
|
-
Tách ba thành phần cấu hình: model profile quyết định model/effort; execution policy quyết định các bước và bằng chứng; external review quyết định lớp kiểm tra bên ngoài. Một bộ phân giải policy dùng chung phải phục vụ CLI, hooks, compiler và doctor để tránh mỗi nơi hiểu một kiểu.
|
|
76
|
-
|
|
77
|
-
Core sở hữu chuẩn hóa yêu cầu, plan thực thi, phân loại, điều phối, kiểm chứng và báo cáo. Người dùng giữ quyền quyết định sản phẩm và nghiệm thu theo policy đã khai báo. Không có actor tên Astra bắt buộc trong core.
|
|
78
|
-
|
|
79
|
-
Luồng coding đề xuất: nhận yêu cầu → chuẩn hóa contract → phân loại và plan vừa đủ → triển khai → kiểm chứng → review nội bộ → báo cáo → nghiệm thu nếu task yêu cầu. Review ngoài được chèn sau khi có kết quả và evidence; chỉ chế độ required mới bổ sung điều kiện chặn nghiệm thu.
|
|
80
|
-
|
|
81
|
-
Luồng audit/plan dùng artifact phân tích thay cho implementation. Verification kiểm tra tính đúng của nguồn, tính khả thi, độ phủ yêu cầu và chất lượng lập luận; không tạo log test runtime giả để đi qua gate dành cho code.
|
|
82
|
-
|
|
83
|
-
Phân biệt trạng thái công việc với kết quả: IMPLEMENTED, VERIFIED, READY_FOR_ACCEPTANCE, DONE và BLOCKED/FAILED. Report có outcome success, partial, blocked hoặc failed; việc ghi report không yêu cầu outcome success. Report partial/blocked được lưu kể cả khi chưa review hoặc review CHANGES_REQUIRED, nhưng không mở gate acceptance/DONE, không xóa findings và không reset budget. DONE chỉ khi mọi gate áp dụng của contract đều thỏa. Với phần chủ quan chưa có người chơi thử, ghi rõ phạm vi đã verified và phần còn chờ, không tự gọi là validated.
|
|
84
|
-
|
|
85
|
-
Giữ review nội bộ cho thay đổi code trong lần nâng cấp đầu; FAST dùng review ngắn và kiểm tra đúng phạm vi. Vai trò reviewer phải độc lập với lần triển khai, nhưng core không bắt buộc một tên model độc quyền. Model review chọn qua profile; compatibility mode giữ pin Fable của dự án cũ. Cùng model ở phiên reviewer khác có thể độc lập về vai trò; không tuyên bố hai model chắc chắn có lỗi độc lập.
|
|
86
|
-
|
|
87
|
-
External review có ba chế độ: off, advisory, required. Off là mặc định của standalone. Adapter ban đầu chỉ export/import hồ sơ có task ID, contract hash, snapshot, actor, verdict, findings, thời điểm và nguồn. Astra là adapter tham chiếu; cùng schema dùng được cho người hoặc AI khác. Không giả định có API hay cơ chế nhắn tự động.
|
|
88
|
-
|
|
89
|
-
Phản hồi ngoài làm đổi code phải quay lại kiểm chứng snapshot mới. Đề nghị đổi gameplay/phạm vi được trả về người có quyền quyết định. Advisory vẫn hiển thị findings chưa giải quyết; không âm thầm xóa để report đẹp hơn. Khi phát hiện lỗi thực, core xử lý theo độ nghiêm trọng, dù nguồn phát hiện chỉ là advisory.
|
|
90
|
-
|
|
91
|
-
## 5. Phân loại và điều phối thích ứng
|
|
92
|
-
|
|
93
|
-
Năm nhóm người dùng đưa ra là nhóm workload, không phải năm model hoặc năm tier mới. Mỗi task cần những trường tối thiểu sau; cách lưu cụ thể được chốt khi thiết kế schema.
|
|
94
|
-
|
|
95
|
-
| Trường | Giá trị hoặc nội dung | Mục đích |
|
|
96
|
-
|---|---|---|
|
|
97
|
-
| mode | implement, diagnose/audit, plan | Xác định đầu ra và quyền sửa |
|
|
98
|
-
| scope | local, feature, cross-system; danh sách hệ thống ảnh hưởng | Chia việc và xác định kiểm tra tích hợp |
|
|
99
|
-
| risk | FAST, STANDARD, CONTROLLED; lý do và nguồn | Chọn độ sâu, mức review, rollback và bằng chứng |
|
|
100
|
-
| target | fix, learning-prototype, alpha-ready, production-change | Chọn tiêu chuẩn hoàn thiện đúng mục đích |
|
|
101
|
-
| readiness | ready, needs-inspection, needs-product-decision | Tự tìm dữ kiện hoặc hỏi đúng chỗ |
|
|
102
|
-
| acceptance | tiêu chí, nguồn yêu cầu, cách kiểm chứng, ai quyết định phần thủ công | Định nghĩa điểm dừng |
|
|
103
|
-
| budget | vòng review, lượt dispatch, thời gian/chi phí nếu hỗ trợ | Tránh xử lý vô hạn và báo giới hạn trung thực |
|
|
104
|
-
|
|
105
|
-
Không dùng một con số confidence do model tự khai làm bằng chứng phân loại đúng. Lưu các sự kiện quan sát được, giả định, điểm chưa rõ và điều kiện buộc đánh giá lại. Quy tắc cứng cho save/serialization, network authority, migration, commerce hoặc hợp đồng liên hệ thống là điều kiện kiểm tra; hiểu ngôn ngữ tự nhiên vẫn cần được chấm bằng benchmark.
|
|
106
|
-
|
|
107
|
-
| Tình huống | Cách xử lý ban đầu |
|
|
108
|
-
|---|---|
|
|
109
|
-
| UI cục bộ, yêu cầu rõ, hoàn tác dễ | FAST; đọc vùng liên quan, một implementer, visual/runtime check và report ngắn |
|
|
110
|
-
| Prototype cơ chế đã mô tả | Thường STANDARD; ưu tiên vòng chơi chứng minh giả thuyết, chỉ làm phần đã giao |
|
|
111
|
-
| Alpha readiness | Phân loại theo các hệ thống thực sự có; bổ sung build, luồng người dùng và lỗi chặn thử |
|
|
112
|
-
| Architecture/refactor/optimization | Tách analysis khỏi sửa; yêu cầu mục tiêu và baseline phù hợp |
|
|
113
|
-
| Feature lớn | Chia thành task con theo phụ thuộc/rủi ro; một owner tích hợp và tiêu chí cấp cha |
|
|
114
|
-
|
|
115
|
-
Routing khởi điểm giữ lightweight Sonnet/medium, standard Opus/medium, deep Opus/high khi môi trường hỗ trợ. Tên phiên bản cụ thể được ghim lúc chạy; không ghi một alias thay cho model quan sát được. Không tăng effort chỉ vì task dài hoặc tên role cao cấp. Không có scout bắt buộc; không mở thêm reviewer nếu không có phạm vi kiểm tra khác biệt.
|
|
116
|
-
|
|
117
|
-
Tái phân loại giữ cùng lịch sử nhiệm vụ, các lần thử và chi phí đã phát sinh. Không reset review cap bằng đổi tier hoặc tách task. Task con có ngân sách riêng để quản lý, đồng thời chi phí/lần thử phải cộng lên task cha; bằng chứng từng phần không thay thế kiểm tra tích hợp. Giảm tier không hoàn lại ngân sách; tăng tier không tự cấp thêm tiền hoặc lượt review. Nếu cần gia hạn, ghi quyết định và lý do theo policy.
|
|
118
|
-
|
|
119
|
-
Plan phân rã phải cấp một tổng quota dispatch hữu hạn cho task cha, chia cho các task con và phần tích hợp. Tổng quota này khác giới hạn review trực tiếp của riêng task cha. Reservation kiểm tra nguyên tử quota con lẫn các cấp cha liên quan; tổng đã dùng cộng đang giữ chỗ không được vượt quota. Hết quota cha thì child mới không được dispatch dù cap riêng còn. Tạo thêm child không tự tăng tổng quota; chỉ được phân bổ lại phần chưa dùng hoặc gia hạn có quyết định ghi nhận. Ngân sách thời gian/tiền chỉ gọi là hard cap khi runtime thật sự hỗ trợ thực thi giới hạn đó.
|
|
120
|
-
|
|
121
|
-
Giới hạn concurrency đề xuất: một reviewer đang chạy trên một task, một người ghi mỗi đường dẫn và không quá hai worker triển khai đồng thời trong pilot. Đây là cấu hình khởi điểm để đo, chưa phải mức tối ưu. Chỉ chạy song song các phần không tranh chấp; coordinator chịu trách nhiệm tích hợp.
|
|
122
|
-
|
|
123
|
-
## 6. Các gói triển khai và phụ thuộc
|
|
124
|
-
|
|
125
|
-
Mỗi gói có một người/agent chịu trách nhiệm chính, một reviewer độc lập và bộ đường dẫn được phép sửa. Vai trò dưới đây là trách nhiệm công việc, không yêu cầu tạo thêm tất cả role thành agent thường trực.
|
|
126
|
-
|
|
127
|
-
| Gói | Nội dung và đầu ra | Phụ thuộc | Điều kiện hoàn tất |
|
|
128
|
-
|---|---|---|---|
|
|
129
|
-
| W0 | Khóa hợp đồng, sao lưu nguồn 1.4.0, tái hiện lỗi nền, ghi ma trận môi trường | Không | Có baseline đọc lại được, regression fixture và danh sách tương thích |
|
|
130
|
-
| W1 | Sửa nền 1.4.1 theo mục 7; tài liệu migration | W0 | Test lỗi đã tái hiện qua, cài/update/doctor và kiểm tra evidence từ bản sao sạch qua |
|
|
131
|
-
| W2 | Schema mới, policy resolver, vòng đời theo mode, compatibility reader | W1 | Core task chạy không có Astra; task cũ vẫn đọc/kiểm tra theo đúng phiên bản |
|
|
132
|
-
| W3 | Intake, contract, classifier, routing và tái phân loại | W2 | Bao phủ năm nhóm; không tự sửa với audit/plan; không hạ rủi ro vì ít file |
|
|
133
|
-
| W4 | Điều phối, review reservation, checkpoint/resume, tổng ngân sách cha/con | W2, W3 | Không trùng writer/reviewer; dừng đúng; khôi phục không mất ledger |
|
|
134
|
-
| W5 | Evidence/report và telemetry toàn task | W2; tích hợp W3, W4 | Mọi trạng thái có report; dữ liệu thiếu rõ ràng; snapshot/input/evidence kiểm tra được |
|
|
135
|
-
| W6 | Adapter review ngoài và chuyển workflow hiện hữu sang procedure dùng chung | W2, W5 | Off/advisory/required đúng nghĩa; không còn owner Astra trong core |
|
|
136
|
-
| W7 | Game demo, checkpoint, oracle độc lập và bộ đánh giá | W1; chỉ bắt đầu sau khi W1 hoàn tất | Có checkpoint sạch, task public/holdout tách biệt và baseline game được kiểm tra |
|
|
137
|
-
| W8 | Tích hợp 1.5 candidate, migration, pilot, benchmark và stress test | W3–W7 | Có kết quả tái lập, lỗi phân loại rõ và quyết định phát hành theo mục 14 |
|
|
138
|
-
|
|
139
|
-
Đường phụ thuộc chính: W0 → W1 → W2 → W3/W5 → W4/W6 → W8. W7 có thể song song từ sau W1. Người tạo oracle không đồng thời sửa tiêu chí chấm để ưu ái candidate. Khi số slot agent hạn chế, ưu tiên core, tests và demo/oracle; không tạo đội cố định đông người.
|
|
140
|
-
|
|
141
|
-
Chưa cam kết ngày hoàn thành hay số tiền khi chưa kiểm tra runtime, quyền model và thời gian Unity trên máy đích. Sau W0 có thể ước lượng công triển khai; sau pilot mới dự toán chi phí benchmark bằng dữ liệu từng nhóm. Mỗi gói là một checkpoint review và rollback được, không gộp tất cả thành một lần đổi phiên bản lớn.
|
|
142
|
-
|
|
143
|
-
## 7. Phần sửa nền 1.4.1
|
|
144
|
-
|
|
145
|
-
| Ưu tiên | Việc cần làm | Bài kiểm tra chứng minh đã sửa |
|
|
146
|
-
|---|---|---|
|
|
147
|
-
| Bắt buộc | Kiểm tra containment đường dẫn installer/update cho cả separator Windows; xác minh target thật trước ghi/xóa, gồm link/junction khi áp dụng | Manifest chứa traversal, absolute path hoặc đường đi qua link bị từ chối; sentinel ngoài project không đổi; update hợp lệ vẫn hoạt động |
|
|
148
|
-
| Bắt buộc | Doctor kiểm tra hooks/settings hiệu lực trong phạm vi có thể quan sát, không chỉ file framework và install state | Settings bị thay bằng `{}` hoặc hook bắt buộc mất phải báo lỗi; tùy chỉnh hợp lệ vẫn được giữ; giới hạn về runtime override được báo rõ |
|
|
149
|
-
| Bắt buộc | Ghim canonical inputs ngoài source snapshot: requirements, ADR và nguồn quyết định acceptance | Thay yêu cầu/ADR làm evidence liên quan stale; thêm report/log không tự làm stale source |
|
|
150
|
-
| Bắt buộc | Chuyển bằng chứng runtime cần cho closure vào nơi lưu bền vững; binding tạm vẫn local | Bản sao sạch kèm evidence bundle kiểm tra được closure; thiếu raw source báo thiếu, không PASS |
|
|
151
|
-
| Cần trước demo | Tách build output khỏi source theo manifest rõ; timeout verify cấu hình theo check | Build hợp lệ không tự thất bại do tạo output; source bị test sửa vẫn bị phát hiện; timeout ghi thất bại và log |
|
|
152
|
-
| Cần đo trước mở rộng | Đo overhead snapshot trên bộ file nhỏ/lớn trước khi tối ưu thuật toán | Ghi thời gian đọc/hash và bảo đảm mọi thay đổi nguồn vẫn bị phát hiện; chưa thay bằng cache nếu chưa chứng minh đúng |
|
|
153
|
-
|
|
154
|
-
Giữ snapshot nguồn bảo thủ trước; không chuyển ngay sang chỉ hash file đã sửa vì có thể bỏ sót phụ thuộc. Không bỏ qua cả `.nccgs` khi xác định yêu cầu, nhưng cũng không đưa task log/report sinh ra liên tục vào input hash. Runtime thiếu effort phải giữ unknown; 1.4.1 không sửa bằng cách sao chép configured effort vào observed effort.
|
|
155
|
-
|
|
156
|
-
Các hook bảo vệ thao tác chỉ là lớp hỗ trợ, không được quảng bá như sandbox chống người có toàn quyền sửa workspace. Bổ sung regression cho cách gọi lệnh có biến thể nếu hook hứa chặn chúng; ưu tiên containment ở nơi thực hiện I/O.
|
|
157
|
-
|
|
158
|
-
W1 phải có tương thích tối thiểu riêng trước khi tới schema mới ở W2. Task 1.4 còn mở được đọc cùng lịch sử và số review đã dùng; nếu chưa ghim đủ input thì yêu cầu làm mới bằng chứng bị ảnh hưởng trước khi đóng, không ký duyệt bù. Closure cũ được giữ là historical; thiếu nguồn kiểm chứng phải báo missing evidence. Observation còn nguyên nguồn có thể được sao chép sang evidence bền vững với hash/provenance; không tạo observation mới từ cấu hình. Di chuyển theo cách giữ bản gốc cho rollback, kiểm tra cả đường tham chiếu cũ và mới; không xóa runtime gốc cho tới khi bản sao và phục hồi đã qua kiểm tra.
|
|
159
|
-
|
|
160
|
-
## 8. Phạm vi mã nguồn dự kiến
|
|
161
|
-
|
|
162
|
-
Các đường dẫn là điểm sửa dự kiến; không phải cam kết đã có module mới. Đặt schema và resolver rõ trách nhiệm thay vì tạo framework trừu tượng chưa cần dùng.
|
|
163
|
-
|
|
164
|
-
| Khu vực hiện có | Thay đổi chính |
|
|
165
|
-
|---|---|
|
|
166
|
-
| `.claude/nccgs/pipeline.json`, `tools/policy.mjs`, `tools/compile-policy.mjs` | Tách profile/policy/external review, kiểm tra schema và sinh cấu hình thống nhất |
|
|
167
|
-
| `.claude/nccgs/tools/gates.mjs`, `tools/task.mjs` | Vòng đời theo mode, registry input, report mọi outcome, reclassification, reservation và ledger |
|
|
168
|
-
| `.claude/nccgs/tools/runtime.mjs`, hooks runtime/audit/closure | Quan sát thật, kết nối task cha/con, chặn dispatch vượt reservation, ghi failure |
|
|
169
|
-
| `scripts/install.mjs`, `scripts/doctor.mjs` | Containment, settings thực tế, compatibility và migration có dry-run |
|
|
170
|
-
| Constitution, protocols, skills và templates | Core nhận plan người dùng; procedure chuyên môn dùng chung; adapter chỉ thêm phần review ngoài |
|
|
171
|
-
| `tests/framework.test.mjs`, `tests/gates.test.mjs` và test mới theo hành vi | Regression lỗi nền, lifecycle, migration, resume, race và failure |
|
|
172
|
-
| Thư mục evaluation và demo riêng sẽ tạo sau W1 | Harness, public cases, manifest checkpoint và dữ liệu chạy; holdout nằm ngoài vùng agent được đọc |
|
|
173
|
-
|
|
174
|
-
Không chỉnh tay file generated rồi bỏ qua compiler. Không sửa nội dung official Unity Skills để nhét policy NCCGS. Không đưa build game, transcript riêng hoặc đáp án holdout vào gói npm phát hành. Kiểm tra danh sách đóng gói thực tế vì `docs/` và `tests/` hiện nằm trong package.
|
|
175
|
-
|
|
176
|
-
## 9. Game demo dùng để đánh giá
|
|
177
|
-
|
|
178
|
-
Người dùng đã chọn **Vector Survivors**: game survival action 2D, chơi đơn offline trên Windows, lấy cảm hứng thể loại từ Vampire Survivors và dùng nhân vật, vũ khí, kẻ địch bằng hình khối nguyên bản. Vector Survivors GDD bằng tiếng Anh (`design/gdd/vector-survivors.md` trong repository, ngoài gói npm) là nguồn quy tắc game, phạm vi nội dung và tiêu chí nghiệm thu. Không cần nhập game hoặc source của Vampire Survivors. Chỉ tạo dự án demo sau khi nền 1.4.1 hoàn tất, hoặc sau nền 1.5 nếu gộp mốc patch; nền 1.4.1 đã được triển khai; dự án demo chưa được tạo.
|
|
179
|
-
|
|
180
|
-
Một lượt chơi dài tối đa 15 phút combat time, với di chuyển, tấn công tự động, nhặt XP, chọn nâng cấp và các mốc boss. Mục tiêu đầy đủ gồm 3 nhân vật, 8 vũ khí cơ bản, 8 passive, 4 evolution, 8 enemy archetype thường, 2 elite, 3 boss, 2 arena, metaprogression, local save và settings. Không có dash hoặc tấn công thủ công trong mục tiêu ban đầu. Nội dung này là đích hoàn thiện, không phải nội dung đã có sẵn ở mọi checkpoint.
|
|
181
|
-
|
|
182
|
-
Phân biệt Foundation, Alpha slice, Full target và Diagnostic build theo GDD. Alpha slice dùng 2 nhân vật, 1 arena, 4 vũ khí, 4 passive, 2 evolution, 4 enemy thường, 1 elite và đủ 3 boss role. Chứng minh slice đủ để thử với người thật không được ghi thành đã hoàn tất toàn bộ game. Challenge offline là bài mở rộng benchmark riêng, không mặc nhiên thuộc Full target và không có weekly service hoặc backend.
|
|
183
|
-
|
|
184
|
-
| Checkpoint | Trạng thái ban đầu | Nhóm bài dùng |
|
|
185
|
-
|---|---|---|
|
|
186
|
-
| CP0 Foundation | Vector, Grid Plain, Needle, Seeker và vòng di chuyển–combat–XP–level choice tối thiểu | Tạo nền; chưa có vũ khí thêm, evolution, progression hoặc arena thứ hai |
|
|
187
|
-
| CP1 UI variants | Combat đại diện ổn định; một lỗi layout/focus cô lập cho mỗi case | Bốn task nhóm 1 |
|
|
188
|
-
| CP2 Prototypes | Scaffolding combat/content vừa đủ; hành vi vũ khí, enemy hoặc hazard được giao còn thiếu | Bốn task nhóm 2 |
|
|
189
|
-
| CP3 Alpha preparation | Nội dung đại diện ở arena đầu; thiếu đúng các phần flow, usability, settings hoặc reward recovery đã ghi | Bốn task nhóm 3 |
|
|
190
|
-
| CP4 Systems | Nội dung đại diện, profiling scene và test seam; lỗi coupling, allocation, state hoặc save compatibility có chủ đích | Bốn task nhóm 4 |
|
|
191
|
-
| CP5 Integration variants | Hệ thống arena đầu đã đủ trưởng thành; biến thể chưa có evolution system, Conduit Maze hoặc challenge extension tương ứng | G5.1–G5.3; có integration oracle riêng |
|
|
192
|
-
| CP6 Full target | Toàn bộ nội dung GDD sau tích hợp; không có khoảng trống sản phẩm cố ý | G5.4 audit toàn game và nghiệm thu tích hợp cuối |
|
|
193
|
-
|
|
194
|
-
Checkpoint là các nhánh bất biến, không phải chuỗi mà candidate thừa hưởng kết quả trước. CP3 có thể đã chứa hai evolution cho bài alpha; CP5 của bài evolution dùng nhánh khác chưa triển khai hệ thống đó. Không xây sẵn feature rồi gọi việc kiểm tra lại là benchmark triển khai feature. Không xóa nội dung của dự án thật để tạo lỗi. CP6 cần một bản tham chiếu được evaluator xác minh độc lập; không lấy output A hoặc B làm đầu vào có lợi cho bên còn lại.
|
|
195
|
-
|
|
196
|
-
Mỗi checkpoint có source, packages lock, phiên bản Editor, manifest content/source hash, RNG version và seed policy. Các luồng ngẫu nhiên spawn, upgrade, healing và chest được tách riêng theo GDD. Quy tắc thuần phải lặp lại với đầu vào giống nhau; collision/frame scheduling dùng dung sai đã ghim, không hứa replay bit-identical giữa máy hoặc tái lập chính xác đầu ra model. Nếu NCCGS hỗ trợ tạo demo ban đầu, người đánh giá phải kiểm tra độc lập trước khi đóng băng; công tạo demo không tính vào kết quả task benchmark.
|
|
197
|
-
|
|
198
|
-
Chọn phiên bản Unity được team hỗ trợ và có trên máy, ghim bản vá cụ thể, packages và render pipeline khi W7 bắt đầu. Ghi CPU/GPU/RAM, Windows, build target, độ phân giải, cấu hình chất lượng và trạng thái cache. Kiểm tra UI tại 1280×720, 1920×1080 và 1024×768, gồm chuỗi mô tả dài gấp đôi bản tiếng Anh. Full target có gamepad; không tuyên bố hỗ trợ mobile hoặc localization đầy đủ từ các phép thử này.
|
|
199
|
-
|
|
200
|
-
Visual oracle dùng vị trí/vùng hiển thị, trạng thái tương tác và ảnh chụp cùng điều kiện. Dung sai được hiệu chỉnh trước, không ép ảnh giống từng pixel giữa máy khác nhau. Oracle game còn kiểm tra hit registry, thứ tự terminal event, XP conservation, evolution eligibility và reward transaction theo run ID. Game không hỗ trợ mid-run save/resume: khôi phục completed-run reward khác với tiếp tục một lượt chơi đang dở và khác với resume task NCCGS.
|
|
201
|
-
|
|
202
|
-
Các tải đề xuất theo GDD dưới đây là tham số scenario/cap để đo, chưa phải năng lực đã chứng minh. Active enemy là entity sống, không tính object đang nằm trong pool. Logical projectile có thể gây damage, tách khỏi particle; orbit, beam và field có bộ đếm cùng design limit riêng.
|
|
203
|
-
|
|
204
|
-
| Scenario | Active enemies | Logical projectiles | Pickup representations | Mục đích |
|
|
205
|
-
|---|---:|---:|---:|---|
|
|
206
|
-
| Normal measurement | 300 | 512 | 256 | Đo combat đông trên máy tham chiếu |
|
|
207
|
-
| Standard stress | 600 | 1024 | 512 | Kiểm tra đường chạy tải cao được hỗ trợ |
|
|
208
|
-
| Extreme diagnostic | 1200 | 2048 | 1024 | Tìm giới hạn và kiểm tra hành vi quá tải có kiểm soát |
|
|
209
|
-
|
|
210
|
-
Giữ damage/XP và nội dung scenario khi tối ưu; không xóa enemy đang sống, reward hay pending transaction để cải thiện frame time. Merge chỉ áp dụng cho representation XP, bảo toàn tổng giá trị; chest/healing không được trộn vào đó. Capacity overflow, số lần merge và mức tiến triển combat time phải có log; không coi simulation chạy chậm hơn là hiệu năng tốt hơn.
|
|
211
|
-
|
|
212
|
-
Mục tiêu normal-play đề xuất là 60 FPS; ngưỡng ban đầu trong GDD là normal p95 ≤ 20 ms và p99 ≤ 33,3 ms, standard stress p95 ≤ 33,3 ms. Warm-up 10 giây, thu ít nhất 60 giây mỗi lượt trên standalone development build cùng loại, scenario/seed cố định; đo nhiều lượt, managed allocations, memory và pool growth. Soak 30 phút qua nhiều lượt phải có reset đúng và bộ nhớ bị chặn trong budget đã khóa. Hiệu chỉnh/khóa ngưỡng trên máy tham chiếu trước khi chấm candidate; extreme diagnostic không có cam kết 60 FPS.
|
|
213
|
-
|
|
214
|
-
## 10. Danh mục benchmark game
|
|
215
|
-
|
|
216
|
-
Đề xuất 20 task: bốn task cho mỗi nhóm. Mỗi nhóm có hai task development công khai và hai task holdout. Bảng dưới mô tả họ bài và oracle; chi tiết lỗi seed, đầu vào biến thể và đáp án holdout phải do người đánh giá tạo riêng. Các tiêu chí sản phẩm cần biết vẫn công khai; holdout chỉ giấu trường hợp kiểm tra và vị trí lỗi, không giấu yêu cầu bắt buộc.
|
|
217
|
-
|
|
218
|
-
Phân chia đề xuất để khóa trong manifest trước pilot: Gx.1 và Gx.2 là development; Gx.3 và Gx.4 là holdout, với x là nhóm 1–5. Đổi phân chia vì lý do thiết kế phải xảy ra trước thí nghiệm; không chọn lại theo việc candidate làm tốt bài nào.
|
|
219
|
-
|
|
220
|
-
| ID | Bài thực hiện | Điều kiện đạt chính |
|
|
221
|
-
|---|---|---|
|
|
222
|
-
| G1.1 | Sửa XP/level label bị cắt | Đọc được ở mọi kích thước hỗ trợ; XP math giữ nguyên |
|
|
223
|
-
| G1.2 | Sửa upgrade card chồng nhau | Card còn chọn được, hiển thị rank/prerequisite đúng |
|
|
224
|
-
| G1.3 | Sửa pause/settings focus và input capture | Không di chuyển hoặc chọn nhầm xuyên modal |
|
|
225
|
-
| G1.4 | Sửa mô tả equipment dài | Tooltip đọc được và không che control chọn nâng cấp |
|
|
226
|
-
| G2.1 | Prototype Orbit Blades theo rule | Geometry, pulse hit registry và cooldown đúng |
|
|
227
|
-
| G2.2 | Prototype Return Disc | Hit limit từng chặng, wall contact và expiration đúng |
|
|
228
|
-
| G2.3 | Bổ sung Charger behavior | Tell, locked heading, wall stop và pause đúng |
|
|
229
|
-
| G2.4 | Prototype arena hazard có thời hạn | Warning, damage window, safe path và pause đúng |
|
|
230
|
-
| G3.1 | Hoàn thiện luồng run và restart | Menu, level choice, boss result và retry nhiều lần đúng |
|
|
231
|
-
| G3.2 | Hoàn thiện settings persistence và controls | Apply/restore/revert display sai và focus đúng |
|
|
232
|
-
| G3.3 | Khôi phục completed-run reward sau interrupted write | Chính xác một lần cấp thưởng; backup/migration đúng; không giả mid-run resume |
|
|
233
|
-
| G3.4 | Chuẩn bị Alpha slice đại diện | Build, nội dung, usability evidence và known issues khớp thực tế |
|
|
234
|
-
| G4.1 | Lập kế hoạch architecture weapon/evolution | Dependency, contract giữ nguyên, failure path và test khả thi; không sửa code |
|
|
235
|
-
| G4.2 | Refactor ownership combat/UI trong phạm vi | Damage và upgrade behavior quan sát được giữ nguyên |
|
|
236
|
-
| G4.3 | Tối ưu enemy/projectile/pickup workloads | Chỉ số đã khóa cải thiện với cùng tải; damage và XP bảo toàn |
|
|
237
|
-
| G4.4 | Bổ sung system tests cho progression, transition và save compatibility | Lỗi seed thất bại, reference đã sửa qua; assertion bám requirement |
|
|
238
|
-
| G5.1 | Tích hợp đủ bốn evolution | Inventory, chest, combat, UI và regression qua cùng nhau |
|
|
239
|
-
| G5.2 | Tích hợp Conduit Maze và objectives | Spawn, navigation, hazard, HUD, result gating và unlock nhất quán |
|
|
240
|
-
| G5.3 | Xây offline seeded challenge extension | Profile/content snapshot cố định, seed và lịch sử kết quả local; không server hoặc weekly service |
|
|
241
|
-
| G5.4 | Audit toàn bộ game đã hoàn thiện | Findings tái hiện được, bottleneck có số đo, ưu tiên rõ; không tự sửa |
|
|
242
|
-
|
|
243
|
-
Danh mục và ID bám mục 8.3 của GDD. G5.3 là extension riêng: brief khóa starting profile/content, tắt mua progression trong challenge, lưu run ID, seed, outcome, combat time và score local. Không thêm schedule, online ranking hoặc anti-cheat. Task cha vẫn cần integration evidence; PASS từng phần không chứng minh Full target đã hoàn tất.
|
|
244
|
-
|
|
245
|
-
Các task alpha kiểm chứng slice đủ điều kiện thử với người thật. Một đợt người chơi thật riêng có thể thực hiện sau đó khi đã có người tham gia; không tự liên hệ hay dùng phản hồi giả. Nếu chạy, ghi điều kiện chơi, quan sát và giới hạn mẫu. Ý kiến của model không là bằng chứng độ vui.
|
|
246
|
-
|
|
247
|
-
## 11. Ma trận stress test
|
|
248
|
-
|
|
249
|
-
Stress test gồm cơ chế framework và hành vi model thật. Fixture xác nhận cơ chế hoạt động; phiên model xác nhận agent dùng được cơ chế. Không nhân toàn bộ 20 task với mọi stress case; chọn task đại diện theo rủi ro để tránh chi phí không cần thiết.
|
|
250
|
-
|
|
251
|
-
| ID | Tình huống gây áp lực | Hành vi phải quan sát | Lớp |
|
|
252
|
-
|---|---|---|---|
|
|
253
|
-
| S1 | Thiếu weapon configuration có thể tra | Tự đọc đúng phạm vi; không hỏi user chọn tier | Model |
|
|
254
|
-
| S2 | Hai evolution requirement mâu thuẫn | Nêu đúng quyết định sản phẩm cần chốt trước khi triển khai | Model |
|
|
255
|
-
| S3 | Bug HUD nhỏ thực ra nằm ở shared scaling | Tái phân loại có bằng chứng; giữ lịch sử/budget | Cả hai |
|
|
256
|
-
| S4 | Yêu cầu save/compatibility được mô tả như sửa nhỏ | Không chọn FAST chỉ vì ít dòng code | Model |
|
|
257
|
-
| S5 | Model/reviewer không khả dụng hoặc runtime khác cấu hình | Ghi mismatch; fallback chỉ khi policy đã cho phép; không giả model | Cả hai |
|
|
258
|
-
| S6 | Effort/token/cost không được provider cung cấp | Ghi unknown; không tính 0, không lấy configuration làm observation | Cả hai |
|
|
259
|
-
| S7 | Evolution recipe/ADR đổi sau review hoặc receipt sai snapshot | Vô hiệu đúng evidence; không DONE bằng review cũ | Fixture và một phiên thật |
|
|
260
|
-
| S8 | Test xanh nhưng damage hoặc UI sai | Oracle độc lập phát hiện; không dùng số test để kết luận đúng | Model và game |
|
|
261
|
-
| S9 | Hai worker tranh đường ghi inventory/save | Phát hiện và tuần tự hóa; không đè mất thay đổi | Cả hai |
|
|
262
|
-
| S10 | Hai reviewer tranh lượt cuối | Reservation nguyên tử chỉ cho một lượt dispatch; retry không nhân đôi | Fixture và integration |
|
|
263
|
-
| S11 | Hết budget hoặc tạo task con để thử né cap | Dừng có report; ledger cha/con vẫn giữ mọi lần thử | Cả hai |
|
|
264
|
-
| S12 | Build, phiên agent hoặc save write bị ngắt | Resume framework an toàn; chỉ khôi phục persistence hợp lệ, không cấp reward hai lần hoặc giả mid-run resume | Cả hai |
|
|
265
|
-
| S13 | Feature qua riêng nhưng lỗi khi evolution hoặc kết hợp arena objective | Task cha bị chặn; có integration evidence sau khi sửa | Model và game |
|
|
266
|
-
| S14 | Adapter off, advisory, required hoặc trả receipt cũ | Không phụ thuộc ngoài khi off; chỉ required chặn đúng gate; receipt cũ bị từ chối | Cả hai |
|
|
267
|
-
| S15 | Install state sai đường dẫn hoặc settings mất hook | Không ghi/xóa ngoài project; doctor chỉ rõ trạng thái thiếu | Fixture |
|
|
268
|
-
| S16 | Crowd pressure kéo dài, merge XP và nhiều lượt liên tiếp | Resource bị chặn, XP/damage bảo toàn, reset đúng; báo overload trung thực, không âm thầm giảm tải để đạt | Synthetic, game và phiên thật |
|
|
269
|
-
|
|
270
|
-
Reservation phải quản lý cả lượt dispatch và review record, có ID để chống ghi trùng. Sau crash, trạng thái không rõ cần reconcile; không tự coi slot hết hạn là bằng chứng reviewer đã dừng. Cơ chế này chỉ bao phủ dispatch do NCCGS quản lý, không phải giới hạn tiền ở cấp tài khoản provider.
|
|
271
|
-
|
|
272
|
-
Failure injection chỉ nằm trong bản sao demo/fixture cô lập. Không cài lỗi hoặc thử thao tác phá hoại trên dự án thật của người dùng. Mỗi case có trạng thái đầu vào, cách reset, oracle và log sự kiện cần thu.
|
|
273
|
-
|
|
274
|
-
## 12. Giao thức benchmark và ngân sách chạy
|
|
275
|
-
|
|
276
|
-
So sánh chính gồm A: một agent cơ sở với cùng khả năng truy cập Unity/tools và tiêu chí nghiệm thu, không có điều phối NCCGS; B: NCCGS 1.5 standalone với routing thích ứng. Agent A được phép tự kiểm tra và sửa trong cùng giới hạn; không cố tình làm baseline yếu. Main model/effort ban đầu, công cụ, quyền, tài liệu đầu vào và ngân sách tối đa được ghi rõ.
|
|
277
|
-
|
|
278
|
-
Kết quả A/B đo lợi ích của cả gói điều phối và routing. Nếu cần kết luận riêng về model routing, thêm thử nghiệm phụ giữ toàn bộ NCCGS nhưng dùng model cố định trên một tập development phù hợp. Không quy mọi chênh lệch cho riêng Sonnet khi cấu hình khác nhau ở nhiều điểm.
|
|
279
|
-
|
|
280
|
-
1. Chạy fixture và kiểm tra môi trường trước khi gọi model trả phí. Khóa model resolved, phiên bản NCCGS, Unity, packages, prompt, task seed, timeout và giới hạn can thiệp.
|
|
281
|
-
2. Pilot năm task development, mỗi nhóm một task, mỗi cấu hình một lượt: 10 lượt. Mục tiêu là kiểm tra harness, dữ liệu và ước lượng chi phí; không dùng pilot để tuyên bố thắng.
|
|
282
|
-
3. Hoàn tất development suite với tổng 10 task × 2 cấu hình = 20 lượt, bao gồm 10 lượt pilot nếu cấu hình không đổi. Nếu sửa candidate, ghi phiên bản và chạy lại phần bị ảnh hưởng; pilot cấu hình cũ không được tính như kết quả mới.
|
|
283
|
-
4. Khóa candidate, tiêu chí và hidden cases. Chạy holdout 10 task × 3 lần độc lập × 2 cấu hình = 60 lượt. Tổng dự kiến ban đầu 80 lượt cho hai cấu hình, chưa tính rerun có lý do, stress model hoặc nhánh phụ.
|
|
284
|
-
5. Randomize/counterbalance thứ tự A/B theo block để giảm ảnh hưởng thời điểm provider và cache. Khôi phục checkpoint, session và context giữa lượt. Công khai cache cold/warm; không lấy lần compile đầu của A so với cache ấm của B mà không ghi nhận.
|
|
285
|
-
6. Người đánh giá kiểm tra output cùng oracle. Log phải giữ cả fail, timeout, partial, can thiệp và lần retry. Sự cố hạ tầng được phân loại riêng nhưng vẫn có trong tổng vận hành; nếu rerun, không xóa lần gốc.
|
|
286
|
-
7. Phân tích theo nhóm và từng task; ba lần lặp của cùng task không được coi là ba loại vấn đề độc lập. Với mẫu này, dùng thống kê mô tả và khoảng bất định phù hợp, không suy rộng thành bảo đảm cho mọi game.
|
|
287
|
-
|
|
288
|
-
Holdout phải ở ngoài workspace/ngữ cảnh agent thực thi, có cơ chế runner chỉ trả kết quả cần thiết. Vì đây là người đánh giá cũng tham gia thiết kế, chưa thể tuyên bố bản thân tác giả plan là giám khảo mù. Cần người/phiên evaluator riêng kiểm soát đáp án và biến thể; nếu không đảm bảo được, công bố bộ test là public evaluation, không gọi holdout độc lập. Thay candidate vì thấy đáp án holdout đồng nghĩa chuyển case đó sang development và cần holdout mới.
|
|
289
|
-
|
|
290
|
-
Agent được chạy test công khai trong lượt thực hiện. Hidden oracle chỉ chấm sau khi run kết thúc, không trả vị trí lỗi, đáp án hoặc kết quả hidden test để sửa tiếp trong cùng run. Nếu muốn đo khả năng sửa theo phản hồi evaluator, mở nhánh đánh giá riêng với ngân sách và nhãn assisted, không trộn với kết quả holdout chính.
|
|
291
|
-
|
|
292
|
-
Nhánh lịch sử 1.4.1 chỉ bổ sung khi có runtime và actor thật để hoàn thành workflow cũ. Nếu không có Astra/Fable theo cấu hình, ghi chưa đo hoặc blocked; không giả receipt để so tốc độ. Nhánh review ngoài đánh giá trên cùng artifact B đã đóng băng: lỗi phát hiện thêm, false positive, thời gian/chi phí thêm và hiệu quả sửa findings. Không cộng chất lượng nhánh này vào kết quả standalone.
|
|
293
|
-
|
|
294
|
-
Mỗi batch có giới hạn task/lượt và ngân sách tối đa do người vận hành đặt. Dự toán sau pilot lấy chi phí theo nhóm nhân số lượt còn lại, cộng phần stress và dự phòng được nêu rõ. Không chạy toàn bộ 80 lượt khi chưa biết chi phí một lượt hoặc nguồn usage không đủ để kiểm soát ngân sách. Đây là điều kiện vận hành cho giai đoạn sau; hiện chưa bắt đầu benchmark.
|
|
295
|
-
|
|
296
|
-
## 13. Dữ liệu đo và cấu trúc report
|
|
297
|
-
|
|
298
|
-
| Chỉ số | Cách ghi nhận | Điều cần tránh |
|
|
299
|
-
|---|---|---|
|
|
300
|
-
| Correctness | Tiêu chí nào đạt/trượt, oracle, lỗi theo mức ảnh hưởng | Một điểm trung bình che lỗi nghiêm trọng |
|
|
301
|
-
| Classification | Mode đúng, tier thuộc tập hợp được chấp nhận, lý do và tái phân loại | So chính xác một nhãn duy nhất cho case vốn có nhiều cách hợp lý |
|
|
302
|
-
| Time | Thời gian tới report kỹ thuật, thời gian tới acceptance, phần chạy/chờ/tool | Loại bỏ thời gian chờ hoặc cộng thời gian agent song song thành wall time |
|
|
303
|
-
| Human effort | Số lần và phút hướng dẫn/sửa/chốt; phân biệt làm rõ sản phẩm với cứu lỗi kỹ thuật | Coi việc người dùng sửa hộ là thành công tự động |
|
|
304
|
-
| AI usage | Model thực chạy, input/output/cache token khi có, mọi attempt và reviewer | Đếm trùng aggregate của parent với child, hoặc bỏ thất bại |
|
|
305
|
-
| Cost | Billed cost khi có; nếu tính theo bảng giá thì ghi estimated và ngày giá | Gọi API-equivalent estimate là hóa đơn thực, nhất là tài khoản subscription |
|
|
306
|
-
| Review quality | Lỗi đúng được phát hiện, lỗi lọt, false positive, vòng sửa | Đếm số comment như chất lượng |
|
|
307
|
-
| Scope and recovery | Sửa ngoài phạm vi, dữ liệu mất, khả năng resume/rollback | Chỉ xem cuối cùng PASS mà bỏ các side effect |
|
|
308
|
-
| Game performance | Cùng máy/build/scenario; frame time p95, allocation và memory | FPS trung bình khác điều kiện hoặc một lần đo duy nhất |
|
|
309
|
-
|
|
310
|
-
Không dùng thời gian tới report BLOCKED/FAIL làm thời gian hoàn thành thành công. So sánh trung vị tốc độ trên các cặp task/run đạt ở cả hai cấu hình, công bố kích thước và thành phần tập so sánh, đồng thời báo riêng failure/timeout và tổng thời gian cohort. Không công nhận lợi ích tốc độ nếu đạt được bằng giảm tỷ lệ hoàn thành; tập so sánh quá ít hoặc bị chọn lọc mạnh phải ghi chưa đủ bằng chứng. Timeout vẫn giữ thời gian đã tiêu thụ và outcome thất bại theo quy tắc khóa trước holdout.
|
|
311
|
-
|
|
312
|
-
Định nghĩa thống nhất: task family là họ bài toán; benchmark run là một lượt bắt đầu từ checkpoint sạch của một task và một cấu hình; attempt là lần triển khai/review/sửa tiếp nằm trong run đó. Ba lần lặp tạo ba run, còn các lần sửa trong một run không tạo thêm mẫu thành công.
|
|
313
|
-
|
|
314
|
-
Chi phí trên một run đạt = tổng chi phí mọi attempt của tất cả run trong cùng cohort / số run được oracle xác nhận đạt; nếu không có run đạt thì ghi không xác định, không ghi 0. Báo thêm chi phí trung vị từng run thành công và chi phí thất bại để nhìn được phân bố. Tách first-attempt success khỏi success sau can thiệp. Khi đánh giá độ bất định, giữ cụm theo task family thay vì coi mọi run là bài toán độc lập.
|
|
315
|
-
|
|
316
|
-
Theo [hướng dẫn tối ưu chi phí và chất lượng của Anthropic](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence), cần đo trên workload của mình và so chi phí trên công việc hoàn thành. Tài liệu này áp dụng nguyên tắc đó, không lấy benchmark của nhà cung cấp làm kết quả NCCGS.
|
|
317
|
-
|
|
318
|
-
Telemetry thiếu một phần phải ghi coverage và lý do. Native runtime hiện không có observed effort đầy đủ: standalone có thể báo kết quả chức năng với route assurance chưa xác minh nếu policy cho phép; strict route assurance chặn riêng chứng nhận tuyến model. So sánh khẳng định về model/effort chỉ dùng các lượt có bằng chứng đủ. Không sửa dữ liệu để chạy qua gate.
|
|
319
|
-
|
|
320
|
-
Report task cần có: yêu cầu và contract revision; phân loại cùng lý do; công việc thực hiện; kiểm tra đã chạy/chưa chạy; kết quả và evidence; thời gian/usage với mức chắc chắn; lỗi còn lại; trạng thái acceptance; bước tiếp theo nếu bị chặn. Report audit/plan thay phần diff code bằng artifact phân tích và phạm vi được xem.
|
|
321
|
-
|
|
322
|
-
Report benchmark cần có bảng A/B theo năm nhóm, manifest môi trường, danh sách mọi lượt, failure taxonomy, raw evidence index, giới hạn thống kê và đề nghị go/no-go. Raw transcript lưu theo chính sách dữ liệu của team; bằng chứng bền vững chỉ chứa dữ liệu cần thiết, không sao chép credentials.
|
|
323
|
-
|
|
324
|
-
## 14. Gate phát hành và tiêu chí xem xét 2.0
|
|
325
|
-
|
|
326
|
-
Các ngưỡng số dưới đây là mục tiêu đề xuất để review và khóa trước holdout. Có thể điều chỉnh sau pilot để phù hợp task thật, nhưng phải ghi lý do trước khi mở holdout. Không hạ ngưỡng chỉ vì đã thấy candidate trượt.
|
|
327
|
-
|
|
328
|
-
| Gate | Ngưỡng đề xuất | Nếu chưa đạt |
|
|
329
|
-
|---|---|---|
|
|
330
|
-
| G0 nền | Không còn lỗi đã biết có thể ghi/xóa ngoài project, giả PASS do stale input hoặc mất evidence bắt buộc; regression fixture đều qua | Chặn demo trên project thật và chặn stable |
|
|
331
|
-
| G1 độc lập | Standalone hoàn thành các luồng coding/audit/plan mà không cần Astra; off/advisory/required qua đầy đủ case | Chặn 1.5 standalone |
|
|
332
|
-
| G2 chất lượng | Zero lỗi nghiêm trọng bị báo thành PASS trong bộ chấm; 100% stress invariant về integrity/gate/migration qua | Chặn stable; sửa rồi dùng bộ đánh giá thích hợp |
|
|
333
|
-
| G3 hoàn thành | Mục tiêu ít nhất 27/30 lượt holdout standalone đạt; mỗi nhóm ít nhất 5/6; không tính hoàn thành có cứu hộ ngoài policy | Chưa đạt mục tiêu độ tin cậy; công bố fail theo nhóm |
|
|
334
|
-
| G4 phân loại | Không hạ dưới mức cho phép ở case rủi ro dữ liệu/compatibility; ít nhất 90% lượt nằm trong tập phân loại hợp lý đã chốt | Sửa classifier/policy và đánh giá lại |
|
|
335
|
-
| G5 hiệu quả | Workload nhóm 1–2 không chậm hơn baseline quá 20% ở trung vị thời gian kỹ thuật; chi phí/run đạt có cùng ngưỡng nếu coverage đủ. Nhóm 3–5 có ít nhất một lợi ích đã khóa như giảm 15% công người hoặc chi phí, hoặc thêm ít nhất một task family đạt mà baseline không đạt ổn định | Chấm từng chiều; cost thiếu là chưa xác định, không coi đạt/trượt. Nhóm chưa hiệu quả phải được công bố; cân nhắc giữ preview |
|
|
336
|
-
| G6 đo lường | Đủ identity/time/attempt/outcome cho mọi lượt; mọi số thiếu được nêu; chỉ tuyên bố tiết kiệm tiền khi cost coverage đủ cho cohort so sánh | Chỉ công bố các chiều đo được; hoãn tuyên bố về chi phí |
|
|
337
|
-
| G7 migration | Clean install, update có tùy chỉnh, task đang chạy, closure cũ, rollback và bản sao sạch đều qua | Chặn phát hành ổn định |
|
|
338
|
-
|
|
339
|
-
G5 là ngưỡng sản phẩm thực dụng ban đầu, không phải định luật hay kết quả có ý nghĩa thống kê tự động. Giữ chất lượng là điều kiện trước khi xét tiết kiệm. Với chỉ hai task holdout mỗi nhóm, cần xem từng họ lỗi và các lần lặp; nếu kết luận đổi khi bỏ một task, ghi chưa chắc chắn và bổ sung case trước quyết định lớn.
|
|
340
|
-
|
|
341
|
-
1.5 stable cần G0–G4 và G7, cộng report trung thực về G5–G6; mọi tuyên bố hiệu quả chỉ giới hạn ở nhóm đã đạt. Đề xuất 2.0 chỉ khi các gate trên đạt, hiệu quả được xác nhận ở phạm vi đã công bố, không còn giới hạn vận hành cốt lõi chưa giải quyết, và kế hoạch thay đổi hợp đồng công khai/migration đã được chấp nhận.
|
|
342
|
-
|
|
343
|
-
Trước khi gọi 2.0 sẵn sàng dùng rộng, kiểm tra cài/update trên ít nhất một Unity project khác và chạy ba task đại diện không lấy từ demo để tìm phụ thuộc đặc thù Vector Survivors. Đây là kiểm tra khả năng áp dụng, không đủ để tuyên bố hỗ trợ mọi thể loại, mọi platform hoặc multiplayer. Tên phiên bản phát hành cuối cùng là quyết định sau kết quả, không tự động đổi VERSION khi demo PASS.
|
|
344
|
-
|
|
345
|
-
## 15. Migration và phát hành
|
|
346
|
-
|
|
347
|
-
Giữ bản snapshot nguồn 1.4.0 và gói 1.4.1 kiểm tra được bằng checksum; workspace hiện không có Git repository nên chưa được phép dựa vào một commit/tag tưởng tượng. Có thể dùng archive manifest hoặc thiết lập repository trong giai đoạn triển khai theo lựa chọn của team.
|
|
348
|
-
|
|
349
|
-
Update phải giữ tùy chỉnh và external gate dự án đã chọn. Chuyển sang standalone là thao tác migration có dry-run: trình bày stage nào thay đổi, quyết định nào còn chờ, task nào phải kiểm chứng lại. Task đang chạy không được tự đổi actor hoặc bỏ pending Astra để báo DONE.
|
|
350
|
-
|
|
351
|
-
Task/schema cũ có reader tương thích theo phiên bản. Nếu không thể tiếp tục an toàn bằng schema mới, giữ task cũ làm lịch sử và tạo continuation liên kết rõ; mang theo tổng review/attempt đã dùng, không mang approval đã stale như approval mới. Rollback khôi phục config/framework và trạng thái tương thích; evidence mới vẫn giữ làm lịch sử, không xóa để giả chưa từng chạy.
|
|
352
|
-
|
|
353
|
-
Trước phát hành: validate, policy check, behavioral tests, install/update/doctor smoke, pack dry-run và kiểm tra nội dung gói. Chỉ publish sau quyết định phát hành; bản plan này không yêu cầu publish hoặc đổi phiên bản ngay.
|
|
354
|
-
|
|
355
|
-
## 16. Quyết định và điều kiện còn cần chốt
|
|
356
|
-
|
|
357
|
-
| Nội dung | Mặc định đề xuất để tiếp tục soạn kế hoạch | Thời điểm cần chốt |
|
|
358
|
-
|---|---|---|
|
|
359
|
-
| Demo | Đã chọn Vector Survivors, game hình khối 2D Windows offline; phạm vi theo GDD tiếng Anh | Đã chốt thể loại; khóa content/checkpoint trong W7, trước pilot |
|
|
360
|
-
| Unity và máy đích | Bản Editor/packages được team hỗ trợ, một máy chuẩn được mô tả | Trước đóng băng checkpoint |
|
|
361
|
-
| Runtime model/reviewer | Các model có thật và quan sát được trong môi trường triển khai; reviewer độc lập, không cần Astra | Trước phiên model pilot |
|
|
362
|
-
| Ngân sách | Chạy batch nhỏ, dự toán sau pilot; không tự mua credits | Trước mỗi batch benchmark có chi phí |
|
|
363
|
-
| Nghiệm thu | Core luôn report; phần cần user do contract quy định; không auto ký thay user | Khi chốt execution policy W2 |
|
|
364
|
-
| Giá trị ưu tiên | Chất lượng trước, sau đó thời gian, công người và chi phí; số đo từng nhóm | Trước khóa ngưỡng G5 và holdout |
|
|
365
|
-
| Người đánh giá | Phiên/người độc lập kiểm soát oracle và holdout | Trước W7 đóng băng bộ chấm |
|
|
366
|
-
| 2.0 | Quyết định dựa trên chất lượng và thay đổi hợp đồng công khai | Sau W8 |
|
|
367
|
-
|
|
368
|
-
Thiếu một điều kiện runtime không làm mất giá trị các gói độc lập: vẫn triển khai/test schema, gates và migration bằng fixture. Tuy nhiên, các kết quả đó không được dùng thay bằng chứng từ model thật, Unity thật hoặc người chơi thật.
|
|
369
|
-
|
|
370
|
-
## 17. Nguồn đối chiếu
|
|
371
|
-
|
|
372
|
-
- Quy tắc game và bộ tình huống đánh giá: Vector Survivors GDD tại `design/gdd/vector-survivors.md` trong repository, ngoài gói npm.
|
|
373
|
-
- Cấu hình hiện tại: [pipeline.json](../.claude/nccgs/pipeline.json), [task CLI](../.claude/nccgs/tools/task.mjs), [gates](../.claude/nccgs/tools/gates.mjs).
|
|
374
|
-
- Policy và generated configuration: [policy](../.claude/nccgs/tools/policy.mjs), [compiler](../.claude/nccgs/tools/compile-policy.mjs).
|
|
375
|
-
- Phân loại và workflow: [classification](../.claude/skills/work/references/classification.md), [work Astra](../.claude/skills/work/references/astra.md), [orchestration](../.claude/nccgs/protocols/orchestration.md).
|
|
376
|
-
- Runtime và vận hành: [runtime](../.claude/nccgs/tools/runtime.mjs), [installer](../scripts/install.mjs), [doctor](../scripts/doctor.mjs), [hướng dẫn 1.4](NCCGS-1.4.md).
|
|
377
|
-
|
|
378
|
-
Các nguồn mã hỗ trợ mô tả hiện trạng; thiết kế 1.5, demo, số lượt chạy và ngưỡng phát hành trong tài liệu là đề xuất của bản kế hoạch này.
|
package/docs/NCCGS-1.5-PILOT.md
DELETED
|
@@ -1,130 +0,0 @@
|
|
|
1
|
-
> Historical development/reference document. Version, status, commands and plans
|
|
2
|
-
> below describe their original scope, not the current package defaults. Read
|
|
3
|
-
> [current release guidance](RELEASE-STATUS.md) before use. Research/benchmark proposals
|
|
4
|
-
> do not automatically add requirements to a delivery contract.
|
|
5
|
-
|
|
6
|
-
# Claude Code pilot and benchmark protocol
|
|
7
|
-
|
|
8
|
-
Status: **prepared, not executed**. Framework version: **1.5.0-preview.1**.
|
|
9
|
-
The authorized current work is framework development. Game work resumes later
|
|
10
|
-
through Claude Code. Do not run a provider or change the game merely to fill this report.
|
|
11
|
-
|
|
12
|
-
## Provenance and clean starting point
|
|
13
|
-
|
|
14
|
-
Vector Survivors CP0 was built by Codex. Preserve it, label it contaminated, and
|
|
15
|
-
exclude it from scored orchestration/efficiency results. A copy of its solution
|
|
16
|
-
is not a fresh baseline. Prefer unseen tasks from later checkpoints or a new
|
|
17
|
-
equivalent foundation with withheld solution code. Record solution exposure and
|
|
18
|
-
exclude exposed tasks from independent quality/productivity claims.
|
|
19
|
-
|
|
20
|
-
Freeze framework/package hash, game starting snapshot, contract, Unity version,
|
|
21
|
-
machine, Claude Code version, permissions, model routes and available measurements
|
|
22
|
-
before each run. Use real Claude Code agent identities and durable raw observations.
|
|
23
|
-
Requested Sonnet/Opus aliases alone are insufficient. Label all synthetic fixture
|
|
24
|
-
data separately; never import it into a real task as runtime evidence.
|
|
25
|
-
|
|
26
|
-
## Start with a small real pilot
|
|
27
|
-
|
|
28
|
-
1. Install the local preview into a fresh disposable Unity project. Review dry-run
|
|
29
|
-
and doctor results; preserve the existing CP0 game untouched.
|
|
30
|
-
2. Start Claude Code, confirm managed hooks load, and read NCCGS memory.
|
|
31
|
-
3. Run one fresh FAST fix in foreground with one worker and one reviewer. Confirm
|
|
32
|
-
PreToolUse -> SubagentStart -> PostToolUse IDs actually correlate. Inspect raw
|
|
33
|
-
metadata, model history, missing effort/cost and spent attempts. Do not fabricate
|
|
34
|
-
fields when the client does not provide them.
|
|
35
|
-
4. Run one audit and one plan task. Attempt no source mutation; verify their outputs
|
|
36
|
-
and source baseline. Check a failed/blocked report as well as successful closure.
|
|
37
|
-
5. Test an interrupted foreground/background worker, external reconciliation and
|
|
38
|
-
resume. Confirm no duplicate agent or refunded budget. Check one explicit policy
|
|
39
|
-
migration/rollback on a copy with pending legacy tasks.
|
|
40
|
-
6. Only after these mechanics pass, run the size benchmark below. A blocked runtime
|
|
41
|
-
adapter is a pilot finding, not a reason to substitute Codex orchestration.
|
|
42
|
-
|
|
43
|
-
## Five task sizes in the survivors game
|
|
44
|
-
|
|
45
|
-
These are example *fresh* tasks. Freeze exact acceptance and withheld checks before
|
|
46
|
-
dispatch; do not reuse a solved task from CP0. Shapes and simple colors are enough.
|
|
47
|
-
|
|
48
|
-
| Size | Example | Expected route, subject to inspection | Required outcome |
|
|
49
|
-
|---|---|---|---|
|
|
50
|
-
| 1: tiny | Correct a HUD offset across fixed resolutions | implement / FAST if ready and local | Reference comparison, unchanged controls, one bounded fix |
|
|
51
|
-
| 2: small prototype | Add one experimental weapon idea with a simple upgrade | implement / STANDARD | Playable loop and explicit learning questions; no production gate inflation |
|
|
52
|
-
| 3: medium alpha | Complete a fresh ten-minute slice with progression, pause, loss/restart and feedback | implement / STANDARD; persistence raises risk | External playtest, bug triage, stable build and stated alpha limitations |
|
|
53
|
-
| 4: medium-large system | Redesign spawning/pooling/performance or plan save-compatible progression | implement or plan / CONTROLLED when cross-system | Measured before/after, architecture rationale, relevant regressions and compatibility |
|
|
54
|
-
| 5: large | Finish a large enemy/weapon/progression feature or audit the complete later game | implement or audit / CONTROLLED | Child contracts, integration/load tests, broad evidence and prioritized findings |
|
|
55
|
-
|
|
56
|
-
For size 3, use at least five real playtesters in an agreed time window; record
|
|
57
|
-
human waiting separately. For sizes 4–5, lock gameplay seed, entity counts and
|
|
58
|
-
machine/settings before profiling; measure p50/p95/p99 frame time, GC allocations,
|
|
59
|
-
memory growth, restart stability, and relevant save/upgrade compatibility. Do not
|
|
60
|
-
infer frame performance from framework snapshot timing.
|
|
61
|
-
|
|
62
|
-
## Compare fairly
|
|
63
|
-
|
|
64
|
-
Use two arms on matched, fresh work: plain Claude Code with a concise team workflow,
|
|
65
|
-
and Claude Code with NCCGS preview. Keep model access, task acceptance and tools
|
|
66
|
-
comparable; record actual route differences. Randomize order and use isolated
|
|
67
|
-
projects/sessions so the second arm does not see the first solution. Blind quality
|
|
68
|
-
review to the arm where practical. Astra is off for the primary benchmark; evaluate
|
|
69
|
-
advisory/required review as a separate experiment, recording added benefit and delay.
|
|
70
|
-
|
|
71
|
-
Start with two matched pairs per size (20 runs total) as an exploratory pilot. This
|
|
72
|
-
is not enough to claim broad statistical superiority. Extend to the larger sample
|
|
73
|
-
in the implementation plan only after runtime mechanics and task comparability pass.
|
|
74
|
-
Failures, retries, abandoned attempts and intervention remain in the denominator.
|
|
75
|
-
Do not replace failed tasks with easier ones or score only completed work.
|
|
76
|
-
|
|
77
|
-
## Record useful efficiency and overthinking metrics
|
|
78
|
-
|
|
79
|
-
| Dimension | Measure | Interpretation |
|
|
80
|
-
|---|---|---|
|
|
81
|
-
| Correctness | Acceptance pass rate; severity-weighted escaped defects | A cheap but incorrect result is not efficient |
|
|
82
|
-
| Delivery | End-to-end elapsed, active executor time, human wait separately | Never compare worker time with another arm's whole task |
|
|
83
|
-
| Resource use | Observed tokens/cost per accepted outcome, coverage and billing source | Unknown is null; report partial coverage |
|
|
84
|
-
| Coordination | Dispatch count, useful specialist contributions, repeated reads, repeated unchanged reviews | Identify overhead that changed no decision or output |
|
|
85
|
-
| Rework | Failed checks, accepted/rejected findings, fix/review rounds | Count every attempt and actual recovery work |
|
|
86
|
-
| Autonomy | Human interventions and reasons; incorrect vs necessary escalations | Don't reward unsafe action or unexplained blocking |
|
|
87
|
-
| Maintainability | Independent assessment of cohesion, clarity, tests and extension cost | Blind review with concrete evidence |
|
|
88
|
-
| Resilience | Crash/resume, duplicate callback, missing evidence, budget conservation | No false success and no hidden attempt reset |
|
|
89
|
-
|
|
90
|
-
Pre-register what counts as unnecessary analysis: e.g. a repeated unchanged-source
|
|
91
|
-
review with no new evidence, repeated broad document loading with no decision
|
|
92
|
-
dependency, or speculative refactor outside acceptance. A long task alone does
|
|
93
|
-
not establish overthinking. Review whether extra reasoning prevented a real defect.
|
|
94
|
-
|
|
95
|
-
Compute quality-adjusted productivity only when scope is comparable: accepted
|
|
96
|
-
contract outcomes / total elapsed or observed spend. Show numerator, denominator,
|
|
97
|
-
coverage and uncertainty. Do not fabricate monetary savings from model names.
|
|
98
|
-
Preserve raw runs and per-size results; a single pooled average can hide tiny-task
|
|
99
|
-
overhead behind large-task gains.
|
|
100
|
-
|
|
101
|
-
## Promotion gates
|
|
102
|
-
|
|
103
|
-
- **Preview -> stable 1.5:** real hook/identity/model evidence works on the supported
|
|
104
|
-
client; no known false-DONE, ownership, quota, migration or evidence-loss defect;
|
|
105
|
-
all five sizes have real results and documented failure recovery; game acceptance
|
|
106
|
-
passes; measurements distinguish unknown values; owner accepts limitations.
|
|
107
|
-
- **Consider 2.0:** demonstrate useful autonomy and repeatable quality/efficiency
|
|
108
|
-
gains across the agreed workload, including small tasks; assess migration/API
|
|
109
|
-
compatibility and maintenance cost; explicitly approve major-version scope.
|
|
110
|
-
|
|
111
|
-
No version promotion is automatic merely because framework fixtures pass.
|
|
112
|
-
|
|
113
|
-
## Run report template
|
|
114
|
-
|
|
115
|
-
```text
|
|
116
|
-
Run ID / arm / task size / mode / risk:
|
|
117
|
-
Fresh baseline hash / solution-exposure declaration:
|
|
118
|
-
Framework package hash / client version / Unity / machine:
|
|
119
|
-
Contract + required checks + manual acceptance:
|
|
120
|
-
Requested routes / actual models / missing fields:
|
|
121
|
-
Dispatch IDs / all attempts / reviews / interventions:
|
|
122
|
-
Outcome / accepted criteria / open findings / escaped defects:
|
|
123
|
-
Elapsed / worker time / human wait:
|
|
124
|
-
Tokens and cost / measurement coverage / raw source:
|
|
125
|
-
Game profiling data when applicable:
|
|
126
|
-
Unnecessary analysis observations and counterexamples:
|
|
127
|
-
Recovery actions / budget before and after:
|
|
128
|
-
Independent reviewer / Product Owner decision:
|
|
129
|
-
Limitations and next concrete action:
|
|
130
|
-
```
|