Skip to content

docs(verification): rewrite framing for (Sandbox) verdict (closes docs half of #4380)#4387

Merged
bokelley merged 1 commit intomainfrom
bokelley/docs-sandbox-framing
May 11, 2026
Merged

docs(verification): rewrite framing for (Sandbox) verdict (closes docs half of #4380)#4387
bokelley merged 1 commit intomainfrom
bokelley/docs-sandbox-framing

Conversation

@bokelley
Copy link
Copy Markdown
Contributor

Summary

Three pages updated to reflect the #4379 (Sandbox) verdict. Closes the docs half of #4380.

Changes

`aao-verified.mdx`

`conformance.mdx`

  • "Two words, not three" — (Sandbox) replaces (Live)
  • "Storyboard conformance vs. AAO Verified" — both qualifiers run the same storyboards; (Sandbox) is the stronger claim

`comply-test-controller.mdx`

What's deferred (tracked in #4380)

  • Full removal of the deprecated canonical-campaign sections from `aao-verified.mdx` — they remain behind the Warning banner for historical context. ~100 lines of detailed content (eight observability checks, Path A/B, maintenance windows, webhook ownership) will be pruned in a follow-up.
  • Migration guide for existing (Spec)-earner agents moving to (Sandbox) — separate rollout doc once the cutover plan is set.

Push A status

This is the final piece of Push A (compliance reporting fidelity):

🤖 Generated with Claude Code

…s half of #4380)

Three pages updated to reflect the (Sandbox) verdict from #4379:

aao-verified.mdx:
- Title / description / intro / TL;DR — (Sandbox) replaces (Live) as the
  higher tier
- "What each axis certifies" tables — (Sandbox) tested against
  registered production URL with account.sandbox: true; same storyboard
  suite as (Spec), zero real-world side effects
- "How agents earn each axis" — (Sandbox) earn instructions describe
  the seller-side sandbox-account gate
- "Reading a badge" — display rows updated
- "Lifecycle" — (Sandbox) lifecycle replaces (Live), cross-mode
  leakage flagged as immediate-revoke trigger
- "Coverage gaps" — universal storyboards run as standard suite, no
  observability carve-out
- JWT verification_modes — ["spec"] / ["spec", "sandbox"]
- Supporting specs — #3755/#4382 (schema gate), #4028/#4384
  (mode-gate storyboard), #4226/#4228 (UNKNOWN grading)
- Warning banner above the deprecated canonical-campaign sections
  (eight checks, webhook ownership, two discovery paths,
  maintenance windows) — full removal in follow-up sweep

conformance.mdx:
- Intro / "Two words, not three" — (Sandbox) replaces (Live)
- "Storyboard conformance vs. AAO Verified" — both qualifiers run
  the same storyboards; (Sandbox) is the stronger claim because it
  attests prod-stack sandbox tolerance

comply-test-controller.mdx:
- Prominent Note callout at the top: controller is dev/staging-only,
  AAO grading does NOT require or use it. Connects to (Sandbox)
  framing via #4379. Production-stack sandbox-flag honoring is
  what (Sandbox) attests, not controller exposure.

Push A item 4 of 4 in the compliance reporting fidelity initiative
is now complete. Follow-up: remove deprecated canonical-campaign
sections from aao-verified.mdx (tracked in #4380).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@bokelley bokelley merged commit 5714fb0 into main May 11, 2026
18 checks passed
@bokelley bokelley deleted the bokelley/docs-sandbox-framing branch May 11, 2026 11:39
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