Skip to content

docs: toolkit DX + framing (per-repo install, validation-not-cert, exceptions prior art)#11

Merged
richbodo merged 1 commit into
mainfrom
docs/toolkit-dx-improvements
May 31, 2026
Merged

docs: toolkit DX + framing (per-repo install, validation-not-cert, exceptions prior art)#11
richbodo merged 1 commit into
mainfrom
docs/toolkit-dx-improvements

Conversation

@richbodo
Copy link
Copy Markdown
Owner

Replacement for #9, which GitHub auto-closed when its stacked base branch (spec/exceptions-concept, the #8 head) was deleted on merge — a closed PR can't be reopened onto a deleted base. Identical content (rebased onto current main), conflicts with #6/#7 resolved (prior-art §9 split into PriorArt.md + PriorArtReferences.md; SKILL/users-guide merged). Lint green. Supersedes #9.

🤖 Generated with Claude Code

…xceptions prior art

- users-guide.md: expand per-repo skill install (symlink for dev vs
  vendored-copy-with-pinned-commit for a contributing design) + the
  'skills load at session start, restart to invoke' caveat.
- PNA_Spec.md § Building a PNA: promote 'validation, not certification' to
  a first-class framing statement (cross-links CONTRIBUTING + SKILL; ties
  in exceptions reported by AC/EX ID, not graded).
- prior_art.md: new § 9 — behavioral exceptions, consent propagation
  (TCF/UMA/Kantara/macaroons), graded assurance (EAL/ASVS/SLSA/EARL), and
  legible labeling (nutrition labels/model cards/datasheets); finding that
  the mechanics have precedent but the exception-as-class-concept is novel.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@richbodo richbodo merged commit 3c48d7d into main May 31, 2026
4 checks passed
@richbodo richbodo deleted the docs/toolkit-dx-improvements branch May 31, 2026 09:54
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