docs: audience-segmented README rewrite#45
Merged
Conversation
Rewrites README.md into three deliberately separate, non-overlapping sections — (1) developer building a custom agent, (2) security engineer evaluating for deployment, (3) technical decision-maker — no general audience, no merged sections. Accurate technical claims and control descriptions are preserved; reorganized by reader. Per-flag decisions applied: - Header: "Production hardened" → "Production-grade architecture"; "NIST AI RMF 1.0 compliant" → "NIST AI RMF aligned" - E-2 kept as ❌ CRITICAL, not softened; risk tiers described as an enforced policy control, not an isolation boundary - Actuator guarantee rewritten honestly around E-2 (holds vs honest agents/accidental misuse, not vs a compromised in-process agent) - Added the MODEL_GUARD_SIGN_KEY fallback caveat (STRIDE T-2) - Removed the hardcoded test-count number - docs/CONTROLS.md verified complete and cited as-is (its stale paths are a separate follow-up, not touched here) STRIDE.md (flag decisions 2 and 8): - S-2 marked resolved (commit 54628dd): the unauthenticated server.ts /api/approvals/:id/{approve,deny} endpoints were removed, route now 410 Gone, no approval:decision emission — table row, detailed section resolution note, and implementation-status note updated - Scope updated to `main`; status date updated to 2026-05-19 https://claude.ai/code/session_01Ds4diwEnvZ863CUoNCQEkY
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.
Rewrites README.md into three deliberately separate, non-overlapping sections — (1) developer building a custom agent, (2) security engineer evaluating for deployment, (3) technical decision-maker — no general audience, no merged sections. Accurate technical claims and control descriptions are preserved; reorganized by reader.
Per-flag decisions applied:
STRIDE.md (flag decisions 2 and 8):
main; status date updated to 2026-05-19