canon: rename audit-gate constraint + add substrate-options catalog#185
Closed
klappy wants to merge 1 commit into
Closed
canon: rename audit-gate constraint + add substrate-options catalog#185klappy wants to merge 1 commit into
klappy wants to merge 1 commit into
Conversation
… pattern; add substrate-options method doc Renames Tier-1 audit-gate constraint from vendor-specific (Anthropic Managed Agents) to abstract pattern (spawned-agent-session). Treated as delayed correction to original PR #177 review, not retraction. Adds sibling Tier-1 method doc cataloguing substrate options: Anthropic Managed Agents, Cloudflare Sandboxes, self-hosted. Includes mixing-tools-across-vendors framing and the Subscription Inclusion Lever (Claude Code via CLAUDE_CODE_OAUTH_TOKEN against Max plan). Cross-reference inventory: only ledger and writings reference old URI by string, both historical/operational and intentionally untouched. Sibling rename for governance-validation-via-agents.md is flagged for follow-up scope decision; not in this PR. Refs: klappy://canon/methods/persona-shaped-agent-runtime (forthcoming), ams://canon/constraints/canon-code-sync-via-spawned-agent-session (forthcoming PR B)
Canon Quality —
|
This was referenced May 10, 2026
Owner
Author
|
Superseded by #184, which has now merged. PR #184 carried the same constraint rename + substrate-options method doc, plus a Cursor Bugbot prior-art section added during review. The diff between current Rebasing onto current |
klappy
pushed a commit
that referenced
this pull request
May 10, 2026
…ntract draft) + journals Two runtime method docs preserved here for operator review and reconciliation: DOC 1 (recommended canonical): canon/methods/persona-shaped-agent-runtime.md Tier 1, proposed. Reflects operator's session-per-mode guidance from 2026-05-10 conversation. Five mode-bound roles (explorer, planner, builder, validator, resolver) plus general escape hatch and observer carve-out. Derives from sessions-mirror-modes principle and mode-transitions-require-encoded-handoff constraint (PR C). DOC 2 (prior iteration, draft): canon/methods/spawned-agent-session-runtime-contract.md Tier 2, draft. Five-orthogonal-dimensions framing (persona, mode, role, surface, engagement) from prior compacted session. Introduces 'engagement' dimension (assistant vs agent — turn-based dialogue vs autonomous run-to-completion) that is genuinely orthogonal and missing from doc 1. Worth folding forward, or keeping as sibling, per operator decision. JOURNALS: - 2026-05-10-spawned-agent-runtime-and-five-dimension-contract.tsv (prior session's DOLCHEO entries) - 2026-05-10-runtime-canon-divergence.tsv (this PR's entries — flags the two-doc situation, names engagement as the worth-preserving insight, recommends persona-shaped as canonical) DEPENDS ON: - PR #185 (substrate canon) — references klappy://canon/methods/spawned-agent-session-substrate-options - PR #186 (mode-discipline canon) — references klappy://canon/principles/sessions-mirror-modes and klappy://canon/constraints/mode-transitions-require-encoded-handoff OPERATOR ACTION REQUIRED: Pick one runtime doc as canonical, OR reconcile the two before merge. Recommend persona-shaped as canonical with engagement dimension folded in.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this PR does
Renames the Tier-1 audit-gate constraint from vendor-specific (Anthropic Managed Agents) to abstract pattern (spawned-agent-session), and adds a sibling Tier-1 method doc cataloguing current substrate options.
Framed as delayed correction to the original PR #177 review, not retraction. The substantive arguments are unchanged; only the abstraction layer of the naming changes.
Files
canon/constraints/audit-gates-are-managed-agents.md→canon/constraints/audit-gates-are-spawned-agent-sessions.md(rename + body rewrite, no supersession chain)canon/methods/spawned-agent-session-substrate-options.md(new — Tier-1 method doc)URI changes from
klappy://canon/constraints/audit-gates-are-managed-agentstoklappy://canon/constraints/audit-gates-are-spawned-agent-sessions.Cross-reference inventory
Expected matches after rename:
odd/ledger/2026-05-07-pr177-validation-review.md(historical, intentionally untouched)Sibling docs flagged for follow-up (not in this PR scope)
canon/methods/governance-validation-via-agents.md— title and body use the proper noun ~6 timescanon/constraints/release-validation-gate.md— referencesmanaged-agentsskill operationally (still valid as operational reference)Substrate-options method doc highlights
Catalog characterizes three substrates with billing dimensions and worked cost examples (Anthropic Managed Agents — token + session-hour; Cloudflare Sandboxes — vCPU-second + memory + disk + egress; self-hosted — operator-defined). Includes §Mixing Tools Across Vendors articulating the cost-optimal pattern (Anthropic model + Anthropic Claude Code harness + Cloudflare Sandbox substrate) and §Subscription Inclusion Lever (Claude Code via
CLAUDE_CODE_OAUTH_TOKENagainst Max plan headlines ~70% reduction vs Managed Agents at 100 audits/day).Forward references
This PR's docs reference URIs that land in subsequent PRs:
klappy://canon/methods/persona-shaped-agent-runtime— PR D (forthcoming)ams://canon/constraints/canon-code-sync-via-spawned-agent-session— PR B (forthcoming, depends on this PR merging)Confidence
Working belief. Substrate cost characterizations are grounded in vendor documentation as of 2026-05-10. Catalog framing is pre-production reasoning; expect tuning when the first deployment ships.
Note
Low Risk
Low risk: canon documentation-only change that renames/clarifies a governance constraint and adds a new method doc; no runtime code or enforcement logic is modified.
Overview
Reframes the Tier-1 audit-gate constraint from a vendor-specific requirement (Anthropic Managed Agents) to the vendor-agnostic concept of a spawned agent session, updating the URI/title/tags and tightening language around substrate-independence and the required session properties.
Adds a new Tier-1 method,
klappy://canon/methods/spawned-agent-session-substrate-options, cataloguing current substrate/harness options (Managed Agents, Cloudflare Sandboxes, self-hosted) and comparing billing dimensions/cost shapes, including guidance on mixed-vendor deployments and subscription-vs-API inference tradeoffs.Reviewed by Cursor Bugbot for commit ef8ae38. Bugbot is set up for automated code reviews on this repo. Configure here.