Skip to content

docs: surgical README improvements + publish technical one-pager#13

Open
AaronRoeF wants to merge 2 commits into
mainfrom
readme/onepager-grafts-and-fixes
Open

docs: surgical README improvements + publish technical one-pager#13
AaronRoeF wants to merge 2 commits into
mainfrom
readme/onepager-grafts-and-fixes

Conversation

@AaronRoeF

Copy link
Copy Markdown
Contributor

Surgical edits to profile/README.md (structure + puppy intro untouched) plus a new profile/technical-one-pager.md, linked from the README.

README changes (5, all surgical)

  1. Attribution fix (correctness). The Zero-Trust Framework Alignment intro attributed the "a signed JWT proves who called an API, not what agent / prompt / model / policy" enumeration to the Anthropic eBook ("the core argument in that document"). That enumeration is ours, not the eBook's — verified against two independent summaries; the eBook's actual identity claim is "cryptographically-rooted identity / a label is trivial to forge." Reworded to credit the eBook accurately and own the sharper framing.
  2. AGT adoption stats added inline (4,250+ stars, 10/10 OWASP Agentic Top 10).
  3. VADP → "scope-chain delegation (monotonic narrowing)" (2 places) — adopting Imran's own term.
  4. CBOM row added to the TRACE primitives table (post-quantum readiness).
  5. Link to the new one-pager.

New file: profile/technical-one-pager.md — the 2-minute version (public adaptation of the partner one-pager; internal banner + direct exec emails removed, contact routed to GitHub Discussions).

@imran — for your review

  • I propagated your one-pager edit into the README: "VADP" → "scope-chain delegation (monotonic narrowing)" in both spots. Please confirm that's the term you want everywhere, and whether "VADP" should be fully retired (it still appears in AGT's own proposal docs). Open Q from Slack: what did VADP stand for?
  • AGT stats used: 4,250+ stars / 10/10 OWASP. Adjust if you'd prefer different figures.

Deliberately held back (dependency-gated, not in this PR)

  • The eBook's "six layers" count (intro paragraph) is unverified — secondary sources say 8 implementation phases / 5 threat categories. Left as-is pending the PDF verify pass.
  • Product-name consistency: the one-pager uses "OPAQUE Confidential AI"; the README's technical section uses "OPAQUEProvider" / "Opaque Managed Runtime." Not reconciled here — flagging for a naming decision.

🤖 Generated with Claude Code

AaronRoeF and others added 2 commits June 20, 2026 16:35
- Fix attribution: the "a signed JWT proves who-not-what/prompt/model/policy"
  enumeration was credited to the Anthropic eBook ("the core argument in that
  document"); it is our framing, not the eBook's. Reworded to credit the
  eBook's actual identity claim (cryptographically-rooted identity / a label
  is trivial to forge) and own the sharper framing as ours.
- Add AGT adoption stats inline (4,250+ stars, 10/10 OWASP Agentic Top 10).
- VADP -> "scope-chain delegation (monotonic narrowing)" (2 places), adopting
  Imran's own terminology.
- Add CBOM row to the TRACE primitives table (post-quantum readiness).
- Add profile/technical-one-pager.md (public 2-minute version) + link from README.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The eBook adapts NIST SP 800-207; the 'six layers' is our organizing
framework, not a literal eBook structure (secondary sources describe it as
8 phases / 5 threat categories). Reword to present the six verification
areas as our mapping, keeping the eBook credit accurate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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