nccgs 2.1.0 → 2.1.1

package/.claude/nccgs/pipeline.json

@@ -1,260 +1,260 @@
-{
-  "schemaVersion": 1,
-  "defaultProfile": "claude-standalone",
-  "profiles": {
-    "astra-claude": {
-      "models": {
-        "lightweight": {
-          "model": "sonnet",
-          "effort": "medium"
-        },
-        "standard": {
-          "model": "claude-opus-5-5",
-          "effort": "medium"
-        },
-        "deep": {
-          "model": "claude-opus-5-5",
-          "effort": "high"
-        },
-        "leadership": {
-          "model": "claude-opus-5-5",
-          "effort": "high"
-        },
-        "review": {
-          "model": "fable",
-          "effort": "high"
-        }
-      },
-      "session": {
-        "class": "standard"
-      },
-      "activeAgents": [
-        "nccgs-fast-implementer",
-        "nccgs-task-scout",
-        "nccgs-game-designer",
-        "nccgs-gameplay-programmer",
-        "nccgs-engine-programmer",
-        "nccgs-ui-programmer",
-        "nccgs-unity-implementer",
-        "nccgs-unity-systems-specialist",
-        "nccgs-unity-ui-specialist",
-        "nccgs-unity-build-specialist",
-        "nccgs-qa-engineer",
-        "nccgs-verification-engineer",
-        "nccgs-adversarial-reviewer"
-      ]
-    },
-    "quality": {
-      "models": {
-        "lightweight": {
-          "model": "haiku",
-          "effort": null
-        },
-        "standard": {
-          "model": "sonnet",
-          "effort": null
-        },
-        "deep": {
-          "model": "opus",
-          "effort": null
-        },
-        "leadership": {
-          "model": "opus",
-          "effort": null
-        },
-        "review": {
-          "model": "opus",
-          "effort": null
-        }
-      },
-      "session": null,
-      "activeAgents": "all"
-    },
-    "balanced": {
-      "models": {
-        "lightweight": {
-          "model": "haiku",
-          "effort": null
-        },
-        "standard": {
-          "model": "sonnet",
-          "effort": null
-        },
-        "deep": {
-          "model": "opus",
-          "effort": null
-        },
-        "leadership": {
-          "model": "sonnet",
-          "effort": null
-        },
-        "review": {
-          "model": "opus",
-          "effort": null
-        }
-      },
-      "session": null,
-      "activeAgents": "all"
-    },
-    "inherit": {
-      "models": {
-        "lightweight": {
-          "model": null,
-          "effort": null
-        },
-        "standard": {
-          "model": null,
-          "effort": null
-        },
-        "deep": {
-          "model": null,
-          "effort": null
-        },
-        "leadership": {
-          "model": null,
-          "effort": null
-        },
-        "review": {
-          "model": null,
-          "effort": null
-        }
-      },
-      "session": null,
-      "activeAgents": "all"
-    },
-    "claude-standalone": {
-      "models": {
-        "lightweight": {
-          "effort": "medium",
-          "model": "sonnet"
-        },
-        "standard": {
-          "effort": "medium",
-          "model": "opus"
-        },
-        "deep": {
-          "effort": "high",
-          "model": "opus"
-        },
-        "leadership": {
-          "effort": "high",
-          "model": "opus"
-        },
-        "review": {
-          "effort": "high",
-          "model": "opus"
-        }
-      },
-      "session": {
-        "class": "standard"
-      },
-      "activeAgents": [
-        "nccgs-fast-implementer",
-        "nccgs-task-scout",
-        "nccgs-game-designer",
-        "nccgs-gameplay-programmer",
-        "nccgs-engine-programmer",
-        "nccgs-ui-programmer",
-        "nccgs-unity-implementer",
-        "nccgs-unity-systems-specialist",
-        "nccgs-unity-ui-specialist",
-        "nccgs-unity-build-specialist",
-        "nccgs-qa-engineer",
-        "nccgs-verification-engineer",
-        "nccgs-adversarial-reviewer"
-      ]
-    }
-  },
-  "contract": {
-    "planningOwner": "Astra",
-    "documentsOwner": "Astra",
-    "reviewAgent": "nccgs-adversarial-reviewer",
-    "sequence": [
-      "astra-plan",
-      "risk-routed-implementation",
-      "fable-review",
-      "report-to-astra",
-      "astra-check",
-      "product-owner-acceptance"
-    ],
-    "requiredForAllCodeChanges": true,
-    "allowInheritFallback": false,
-    "taskTiers": {
-      "FAST": {
-        "implementationClass": "lightweight",
-        "maxReviewRounds": 2
-      },
-      "STANDARD": {
-        "implementationClass": "standard",
-        "maxReviewRounds": 3
-      },
-      "CONTROLLED": {
-        "implementationClass": "deep",
-        "maxReviewRounds": 3
-      }
-    },
-    "astraWorkflows": [
-      "design",
-      "context-pack",
-      "plan-feature",
-      "architecture-decision",
-      "closure",
-      "qa-plan",
-      "project-stage",
-      "sprint-plan",
-      "milestone-review",
-      "retrospective"
-    ],
-    "reviewWorkflows": [
-      "review",
-      "nccgs-code-review"
-    ]
-  },
-  "snapshotExcludes": [
-    ".git",
-    ".nccgs",
-    "Library",
-    "Temp",
-    "Logs",
-    "obj",
-    "node_modules",
-    ".vs"
-  ],
-  "coreAgents": [
-    "nccgs-fast-implementer",
-    "nccgs-task-scout",
-    "nccgs-game-designer",
-    "nccgs-gameplay-programmer",
-    "nccgs-engine-programmer",
-    "nccgs-ui-programmer",
-    "nccgs-unity-implementer",
-    "nccgs-unity-systems-specialist",
-    "nccgs-unity-ui-specialist",
-    "nccgs-unity-build-specialist",
-    "nccgs-qa-engineer",
-    "nccgs-verification-engineer",
-    "nccgs-adversarial-reviewer"
-  ],
-  "executionPolicies": {
-    "standalone": {
-      "reviewAgent": "nccgs-adversarial-reviewer",
-      "documentsOwner": "Claude Code",
-      "runtime": "claude-code",
-      "sequence": [
-        "intake",
-        "plan",
-        "implementation",
-        "verification",
-        "independent-review",
-        "report",
-        "optional-external-review",
-        "contract-acceptance"
-      ],
-      "planningOwner": "Claude Code"
-    },
-    "compatibility": {
-      "contract": "astra-claude",
-      "runtime": "claude-code"
-    }
-  }
-}
+{
+  "schemaVersion": 1,
+  "defaultProfile": "claude-standalone",
+  "profiles": {
+    "astra-claude": {
+      "models": {
+        "lightweight": {
+          "model": "sonnet",
+          "effort": "medium"
+        },
+        "standard": {
+          "model": "claude-opus-5-5",
+          "effort": "medium"
+        },
+        "deep": {
+          "model": "claude-opus-5-5",
+          "effort": "high"
+        },
+        "leadership": {
+          "model": "claude-opus-5-5",
+          "effort": "high"
+        },
+        "review": {
+          "model": "fable",
+          "effort": "high"
+        }
+      },
+      "session": {
+        "class": "standard"
+      },
+      "activeAgents": [
+        "nccgs-fast-implementer",
+        "nccgs-task-scout",
+        "nccgs-game-designer",
+        "nccgs-gameplay-programmer",
+        "nccgs-engine-programmer",
+        "nccgs-ui-programmer",
+        "nccgs-unity-implementer",
+        "nccgs-unity-systems-specialist",
+        "nccgs-unity-ui-specialist",
+        "nccgs-unity-build-specialist",
+        "nccgs-qa-engineer",
+        "nccgs-verification-engineer",
+        "nccgs-adversarial-reviewer"
+      ]
+    },
+    "quality": {
+      "models": {
+        "lightweight": {
+          "model": "haiku",
+          "effort": null
+        },
+        "standard": {
+          "model": "sonnet",
+          "effort": null
+        },
+        "deep": {
+          "model": "opus",
+          "effort": null
+        },
+        "leadership": {
+          "model": "opus",
+          "effort": null
+        },
+        "review": {
+          "model": "opus",
+          "effort": null
+        }
+      },
+      "session": null,
+      "activeAgents": "all"
+    },
+    "balanced": {
+      "models": {
+        "lightweight": {
+          "model": "haiku",
+          "effort": null
+        },
+        "standard": {
+          "model": "sonnet",
+          "effort": null
+        },
+        "deep": {
+          "model": "opus",
+          "effort": null
+        },
+        "leadership": {
+          "model": "sonnet",
+          "effort": null
+        },
+        "review": {
+          "model": "opus",
+          "effort": null
+        }
+      },
+      "session": null,
+      "activeAgents": "all"
+    },
+    "inherit": {
+      "models": {
+        "lightweight": {
+          "model": null,
+          "effort": null
+        },
+        "standard": {
+          "model": null,
+          "effort": null
+        },
+        "deep": {
+          "model": null,
+          "effort": null
+        },
+        "leadership": {
+          "model": null,
+          "effort": null
+        },
+        "review": {
+          "model": null,
+          "effort": null
+        }
+      },
+      "session": null,
+      "activeAgents": "all"
+    },
+    "claude-standalone": {
+      "models": {
+        "lightweight": {
+          "effort": "high",
+          "model": "sonnet"
+        },
+        "standard": {
+          "effort": "high",
+          "model": "opus"
+        },
+        "deep": {
+          "effort": "xhigh",
+          "model": "opus"
+        },
+        "leadership": {
+          "effort": "xhigh",
+          "model": "opus"
+        },
+        "review": {
+          "effort": "high",
+          "model": "fable"
+        }
+      },
+      "session": {
+        "class": "standard"
+      },
+      "activeAgents": [
+        "nccgs-fast-implementer",
+        "nccgs-task-scout",
+        "nccgs-game-designer",
+        "nccgs-gameplay-programmer",
+        "nccgs-engine-programmer",
+        "nccgs-ui-programmer",
+        "nccgs-unity-implementer",
+        "nccgs-unity-systems-specialist",
+        "nccgs-unity-ui-specialist",
+        "nccgs-unity-build-specialist",
+        "nccgs-qa-engineer",
+        "nccgs-verification-engineer",
+        "nccgs-adversarial-reviewer"
+      ]
+    }
+  },
+  "contract": {
+    "planningOwner": "Astra",
+    "documentsOwner": "Astra",
+    "reviewAgent": "nccgs-adversarial-reviewer",
+    "sequence": [
+      "astra-plan",
+      "risk-routed-implementation",
+      "fable-review",
+      "report-to-astra",
+      "astra-check",
+      "product-owner-acceptance"
+    ],
+    "requiredForAllCodeChanges": true,
+    "allowInheritFallback": false,
+    "taskTiers": {
+      "FAST": {
+        "implementationClass": "lightweight",
+        "maxReviewRounds": 2
+      },
+      "STANDARD": {
+        "implementationClass": "standard",
+        "maxReviewRounds": 3
+      },
+      "CONTROLLED": {
+        "implementationClass": "deep",
+        "maxReviewRounds": 3
+      }
+    },
+    "astraWorkflows": [
+      "design",
+      "context-pack",
+      "plan-feature",
+      "architecture-decision",
+      "closure",
+      "qa-plan",
+      "project-stage",
+      "sprint-plan",
+      "milestone-review",
+      "retrospective"
+    ],
+    "reviewWorkflows": [
+      "review",
+      "nccgs-code-review"
+    ]
+  },
+  "snapshotExcludes": [
+    ".git",
+    ".nccgs",
+    "Library",
+    "Temp",
+    "Logs",
+    "obj",
+    "node_modules",
+    ".vs"
+  ],
+  "coreAgents": [
+    "nccgs-fast-implementer",
+    "nccgs-task-scout",
+    "nccgs-game-designer",
+    "nccgs-gameplay-programmer",
+    "nccgs-engine-programmer",
+    "nccgs-ui-programmer",
+    "nccgs-unity-implementer",
+    "nccgs-unity-systems-specialist",
+    "nccgs-unity-ui-specialist",
+    "nccgs-unity-build-specialist",
+    "nccgs-qa-engineer",
+    "nccgs-verification-engineer",
+    "nccgs-adversarial-reviewer"
+  ],
+  "executionPolicies": {
+    "standalone": {
+      "reviewAgent": "nccgs-adversarial-reviewer",
+      "documentsOwner": "Claude Code",
+      "runtime": "claude-code",
+      "sequence": [
+        "intake",
+        "plan",
+        "implementation",
+        "verification",
+        "independent-review",
+        "report",
+        "optional-external-review",
+        "contract-acceptance"
+      ],
+      "planningOwner": "Claude Code"
+    },
+    "compatibility": {
+      "contract": "astra-claude",
+      "runtime": "claude-code"
+    }
+  }
+}

package/.claude/nccgs/protocols/context-packets.md

@@ -3,6 +3,11 @@
 A context packet is a task-specific map, not a copy of project documentation. Store
 it under `.nccgs/context/<feature-id>.yaml` for STANDARD or CONTROLLED work.
 
+For a project that has adopted the external shared workflow, follow
+[shared workflow context](shared-workflow-context.md) for its optional common Graphify
+consumer. Link its generation/readiness in the existing packet; keep one shared graph
+and freshness record. Missing setup skips without installing or bootstrapping it.
+
 Include objective, risk tier, domains, accountable owner, requirement IDs, exact
 canonical sections, decision summaries with source anchors, affected/protected paths,
 approved semantics, out-of-scope boundaries, dependencies, verification, PO gates,

package/.claude/nccgs/protocols/model-routing.md

@@ -1,46 +1,46 @@
-# Model routing protocol
-
-NCCGS runs in Claude Code. Resolve execution obligations independently of models.
-`pipeline.json` is the routing source; generated catalog/frontmatter and
-[routing.generated.md](../routing.generated.md) must match it. Thirteen roles
-load by default; 34 optional specialists remain in `agent-library/` until needed.
-
-## Standalone default
-
-| Risk | Implementation | Requested effort | Review rounds |
-|---|---|---|---|
-| FAST | Sonnet, lightweight class | medium | 2 |
-| STANDARD | Opus, standard class | medium | 3 |
-| CONTROLLED | Opus, deep class | high | 3 |
-
-Independent review uses Opus/high. These are family aliases, not claims about a
-particular resolved provider version. Runtime observations must identify actual
-Claude models. Unknown effort remains null unless project policy requires observed
-effort, in which case missing evidence blocks the stage. Never infer observed
-effort, model, duration or cost from configuration.
-
-Use `nccgs-fast-implementer` for bounded FAST work; use a domain programmer for
-STANDARD and `nccgs-unity-implementer` for CONTROLLED. A scout resolves one missing
-fact; it is optional. Do not promote work merely because a role sounds senior.
-The same model family may implement and review, but review must run in a separate
-observed agent invocation and consume a reserved review attempt.
-
-`configure-models.mjs` renders profile model/effort settings. Local settings,
-environment, provider restrictions and existing sessions may override them.
-Restart/recheck the real session after configuration changes. Classify and reserve
-before dispatch, then use the task's route. Do not silently fall back when a model
-is unavailable. Report the actual blocker and measurements.
-
-## Compatibility
-
-Missing `.nccgs/execution.json` means compatibility. Historical `astra-claude`
-retains Sonnet/medium for FAST, `claude-opus-5-5` medium/high for larger work,
-Fable/high review, external Astra check and explicit Product Owner acceptance.
-These historical identifiers are preserved configuration, not new availability
-claims. See [its protocol](astra-claude.md).
-
-`quality`, `balanced` and `inherit` remain available for historical workflows.
-Changing only a model profile cannot waive task gates. Standalone schema-2 tasks
-require explicit implementation/review families; an unpinned inherit route cannot
-prove them. Ordinary updates retain configuration. Use explicit execution migration
-to adopt standalone; historical task records and spent budgets remain intact.
+# Model routing protocol
+
+NCCGS runs in Claude Code. Resolve execution obligations independently of models.
+`pipeline.json` is the routing source; generated catalog/frontmatter and
+[routing.generated.md](../routing.generated.md) must match it. Thirteen roles
+load by default; 34 optional specialists remain in `agent-library/` until needed.
+
+## Standalone default
+
+| Risk | Implementation | Requested effort | Review rounds |
+|---|---|---|---|
+| FAST | Sonnet, lightweight class | high | 2 |
+| STANDARD | Opus, standard class | high | 3 |
+| CONTROLLED | Opus, deep class | xhigh | 3 |
+
+Independent review uses Fable/high. Leadership requests Opus/xhigh. These are family aliases, not claims about a
+particular resolved provider version. Runtime observations must identify actual
+Claude models. Unknown effort remains null unless project policy requires observed
+effort, in which case missing evidence blocks the stage. Never infer observed
+effort, model, duration or cost from configuration.
+
+Use `nccgs-fast-implementer` for bounded FAST work; use a domain programmer for
+STANDARD and `nccgs-unity-implementer` for CONTROLLED. A scout resolves one missing
+fact; it is optional. Do not promote work merely because a role sounds senior.
+The same model family may implement and review, but review must run in a separate
+observed agent invocation and consume a reserved review attempt.
+
+`configure-models.mjs` renders profile model/effort settings. Local settings,
+environment, provider restrictions and existing sessions may override them.
+Restart/recheck the real session after configuration changes. Classify and reserve
+before dispatch, then use the task's route. Do not silently fall back when a model
+is unavailable. Report the actual blocker and measurements.
+
+## Compatibility
+
+Missing `.nccgs/execution.json` means compatibility. Historical `astra-claude`
+retains Sonnet/medium for FAST, `claude-opus-5-5` medium/high for larger work,
+Fable/high review, external Astra check and explicit Product Owner acceptance.
+These historical identifiers are preserved configuration, not new availability
+claims. See [its protocol](astra-claude.md).
+
+`quality`, `balanced` and `inherit` remain available for historical workflows.
+Changing only a model profile cannot waive task gates. Standalone schema-2 tasks
+require explicit implementation/review families; an unpinned inherit route cannot
+prove them. Ordinary updates retain configuration. Use explicit execution migration
+to adopt standalone; historical task records and spent budgets remain intact.

package/.claude/nccgs/protocols/review-handoff.md

@@ -2,7 +2,13 @@
 
 For a reservation with `handoffTransport: "native-result"`, return the entire
 Markdown handoff as one final text block and do not write a file. The native hook
-copies it verbatim into the single declared fresh handoff path. The exact same
+copies it verbatim into the single declared fresh handoff path. The consumer
+re-evaluates the actual response with the native completion policy and preserves
+any upstream completion failure. Only validated provider-designated informational
+leading/tail blocks are removed; exactly one nonempty model text block of at most
+262144 UTF-8 bytes must remain. Unknown, invalid, incomplete or ambiguous responses
+reject without publishing. Model-authored lookalike tags, review JSON, conditions
+and completion markers are never rewritten. The exact same
 review contract, independent identity and gates below still apply. Other
 reservations retain the existing file-writing workflow.
 
@@ -77,5 +83,19 @@ external inspection. Arbitrary quoted text in a worker's response is not harness
 metadata and does not itself change completion status. Captured observations retain
 the reported invocation status and a diagnosis/hash, not arbitrary response text.
 
+The provider-designated informational block
+`<tools-used-before-summary>Edit</tools-used-before-summary>` is recognized as a
+tool inventory. Recognition applies only inside the declared leading/tail harness
+blocks, never to the model handoff. The whole text block must be at most 4096
+characters and contain only that exact case-sensitive wrapper, one or more
+comma-separated tool identifiers, and optional surrounding whitespace. Identifiers
+start with an ASCII letter and continue with ASCII letters, digits, `_`, `.`, `:`
+or `-`; whitespace may surround commas. Empty lists, nested tags, extra prose,
+non-text blocks and any other advisory remain unrecognized and fail closed.
+Turn-limit notices retain priority even when mixed with a recognized inventory.
+An informational note preserves its hash and the provider's reported status;
+it never upgrades a failed or unknown invocation. This compatibility rule does
+not rewrite a previous failed dispatch or waive its consumed quota or review.
+
 Older pinned policies remain unchanged. Upgrade policy only for fresh authorized
 tasks; never retrofit frozen evaluation records or reset attempts to obtain PASS.