docs(compliance): add compliance grading model reference page#4040
Draft
docs(compliance): add compliance grading model reference page#4040
Conversation
Adds docs/building/verification/grading-model.mdx — a new reference page explaining the AdCP compliance grading model end-to-end for both adopters and SDK contributors. https://claude.ai/code/session_01CPn4oJdWTTVZ2L8WCD4pDg
4 tasks
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
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.
Closes #4036
Adds
docs/building/verification/grading-model.mdx— a single reference page explaining the AdCP compliance grading model end-to-end. The page is placed in the "Verification & trust" nav group, after "Validate Your Agent".Motivation: An SDK contributor (implementing seller-side framework in adcp-client-python) spent over an hour misreading the system — looking at JS test helpers (
src/lib/testing/scenarios/media-buy.ts) instead of the authoritative YAML storyboards. This caused an incorrect architectural claim that the proposal lifecycle wasn't being exercised when it was. A single doc page closes that discoverability gap.What's covered:
specialismsfield inget_adcp_capabilities, kebab-case enum IDs, parent-protocol requirementrequires_scenarios, deduplication and capability-gate application; explicit callout that the YAML storyboard runner is authoritative, not the JS test helpersrequires_capabilityYAML block,capability_unsupportedskip semantics with--jsonoutput example sourced fromproposal_finalize.yaml; "(or omit)" default behavior sourced directly fromsales-guaranteed/index.yaml:49overall_statusvalues (passing/failing/partialfromcompliance-db.ts:13),tracks_passed,steps_passed/steps_total,storyboard_id; debug CLI examplesstatus.monotonicas a separate failure axis from step-level validations, with pointer toinvariant_failuresin--jsonoutputNon-breaking justification: New MDX page added to existing nav group; no existing content removed or modified. Zero wire impact.
Pre-PR review:
validate-your-agent.mdxrequires_scenariosYAML match source files; related links non-orphanedSession: https://claude.ai/code/session_01CPn4oJdWTTVZ2L8WCD4pDg
Generated by Claude Code