Skip to content

docs(aao-verified): pre-3.1 framing consistency sweep#3607

Merged
bokelley merged 1 commit intomainfrom
claude/issue-3564-aao-verified-doc-sweep
May 1, 2026
Merged

docs(aao-verified): pre-3.1 framing consistency sweep#3607
bokelley merged 1 commit intomainfrom
claude/issue-3564-aao-verified-doc-sweep

Conversation

@bokelley
Copy link
Copy Markdown
Contributor

Refs #3564

Reconciles AAO Verified (Spec)/(Live) framing across docs and queued changeset entries before the 3.1 GA cut.

Changes

  • docs/building/aao-verified.mdx — Renames the ## Two marks: AdCP Conformant vs AAO Verified section to ## Naming history so cold readers encounter the current single-mark framing, not a confusing two-marks heading. Also fixes a malformed 3-column table row in the same section (the | Both held | cell made the row render incorrectly in Mintlify).

  • docs/building/conformance.mdx — Replaces the containment notation (Verified (Spec) ⊆ Conformant via storyboards. Verified (Live) ⊆ Conformant …) with the independence-first phrasing established in docs(aao-verified): make Live independent of Spec #3536. The new line leads with the independence claim and its concrete examples (no test-mode endpoint → earn (Live) directly; test agent → earns (Spec) as complete claim), avoiding repetition of the "demonstrates conformance" sentence already on the line above.

  • .changeset/salty-wasps-cheat.md — Removes "Same containment relationship as #3001 (Spec is a prerequisite for measuring Live)", which directly contradicts the orthogonal-axes correction in docs(aao-verified): make Live independent of Spec #3536. Replaced with "The two axes are orthogonal — neither is a prerequisite for the other (#3536)".

  • .changeset/account-authorization-and-rbac-errors.md — Qualifies attestation_verifier as binding to the AAO Verified (Live) qualifier (not the unqualified "AAO Verified mark"), since the scope specifically enables (Live) axis observability.

  • .changeset/aao-verified-framing-sweep.md — Empty changeset (docs-only, no protocol bump).

Non-breaking justification

All changes are non-normative doc and changeset text updates. No wire format, schema, task definition, enum value, or API shape is touched. Changeset entries are historical notes that don't affect protocol conformance. Existing clients are unaffected.

What's NOT in this PR (per issue scope)

Pre-PR review

  • code-reviewer: approved — no blockers. Fixed redundancy in conformance.mdx line 23 per nit; simplified "observability flow" phrasing to match existing doc language.
  • docs-expert: approved — anchor audit clean (no inbound links to old #two-marks heading); line 116 "presumes" correctly left unchanged (tenant-isolation context, not Spec/Live hierarchy); agent-parseability improved.

Triage-managed PR. This bot does not currently iterate on
review comments or PR conversation threads (only on the source
issue). To unblock:

  • Push fixup commits directly: gh pr checkout <num>
    fix → push.
  • Or re-trigger: comment /triage execute on the source
    issue.

See #3121
for context.

Session: https://claude.ai/code/session_013WywfzRTvdv2kWUZdp7aBz


Generated by Claude Code

- Rename "Two marks: AdCP Conformant vs AAO Verified" section in
  aao-verified.mdx to "Naming history" — cold readers see the current
  single-mark framing, not a confusing two-marks heading
- Fix malformed 3-column table row in the same section
- Replace ⊆ containment notation in conformance.mdx with the
  independence-first phrasing established in #3536
- Update salty-wasps-cheat.md: remove "Spec is a prerequisite for
  measuring Live" (directly contradicts #3536 orthogonal-axes fix)
- Update account-authorization-and-rbac-errors.md: qualify
  attestation_verifier as binding to the AAO Verified (Live) qualifier

Item 4 of the sweep (attestation_verifier doc check conditional on
#3561) remains open on the parent issue.

Refs #3564

https://claude.ai/code/session_013WywfzRTvdv2kWUZdp7aBz
@bokelley bokelley added the claude-triaged Issue has been triaged by the Claude Code triage routine. Remove to re-triage. label Apr 30, 2026
@bokelley bokelley marked this pull request as ready for review May 1, 2026 02:39
@bokelley bokelley merged commit 95ca715 into main May 1, 2026
18 checks passed
@bokelley bokelley deleted the claude/issue-3564-aao-verified-doc-sweep branch May 1, 2026 02:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

claude-triaged Issue has been triaged by the Claude Code triage routine. Remove to re-triage.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants