Skip to content

docs(spikes): cover P3 no-gate mutation scopes in the governance audit - #202

Merged
mashkovd merged 1 commit into
mainfrom
docs/governance-audit-p3-mutation-scopes
Oct 18, 2026
Merged

mashkovd merged 1 commit into
mainfrom
docs/governance-audit-p3-mutation-scopes

Conversation

@mashkovd

Copy link
Copy Markdown
Member

Summary

Follow-up to the #182 governance audit (docs/spikes/agent-governance-decision-assurance.md, merged in #200). It covers P3 paths that the audit did not inventory:

  • New section 3.6: the six agent-platform/policy.yaml mutating scopes with requiresApproval: null, including incident-resolve ("undecided"), and the incident mutations the policy checkpoint allows. Each row gives the entry point, the contract applied today, any ambiguity against the canonical path, and the disposition.
  • New section 9.5: findings G12-G14, recorded as owner decisions outside the roadmap: activate Agent Governance & Decision Assurance implementation #201 graph.
  • The existing P3 text (3.3 item 4, 5.3 rows, 6.11, G4) is reworded to contract level.

G12 and G13 are security-sensitive. The report states them at contract level only, and their details and remediation are tracked in private security triage. G14 is a plain correctness bug, filed as mctlhq/mctl-api#707.

Not changed

Refs #181, #182, mctlhq/mctl-api#707

🤖 Generated with Claude Code

https://claude.ai/code/session_01HuqYdXZiB63R9bmak1DWDN

The #182 audit analysed P3 only through the responder's auto-accepted
proposal. It did not cover the policy.yaml scopes with requiresApproval:
null, the undecided incident-resolve scope, or the incident mutations the
policy checkpoint allows. This adds that inventory and records three
findings (G12-G14) as owner decisions outside the #201 graph. D5 and #201
are unchanged.

G12 and G13 are security-sensitive and are stated at contract level only;
the existing P3 text is reworded to the same level. G14 is a plain
correctness bug.

Refs #181, #182

Claude-Session: https://claude.ai/code/session_01HuqYdXZiB63R9bmak1DWDN
@claude

claude Bot commented Oct 18, 2026 •

Copy link
Copy Markdown

Claude finished @mashkovd's task in 15s —— View job


Review of PR #202

  • Read the pinned diff (5c1ef2f...ddba980)
  • Submitted the verdict against ddba980

Verdict: approved. The change is docs-only (docs/spikes/agent-governance-decision-assurance.md) with no runtime or workflow change. I found no P1 or P2 issues.

The report states G12 and G13 only at contract level and defers their details to private triage. The reworded P3 text no longer discloses the manual-implementer gate behaviour.

@github-actions

Copy link
Copy Markdown

Antigravity (agy) review — informational

Model: gemini-3.8-flash-high · commit ddba980.

No significant issues found.

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Docs-only change to the governance spike report; security-sensitive details are kept at contract level. No P1/P2 findings.

@mashkovd
mashkovd merged commit 4fc2fce into main Oct 18, 2026
6 checks passed
@mashkovd
mashkovd deleted the docs/governance-audit-p3-mutation-scopes branch October 18, 2026 17:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant