Skip to content

docs: changelog philosophy + technical-audience sweep - #18

Merged
agiacalone merged 2 commits into
mainfrom
docs-changelog-philosophy
Jun 23, 2026
Merged

docs: changelog philosophy + technical-audience sweep#18
agiacalone merged 2 commits into
mainfrom
docs-changelog-philosophy

Conversation

@agiacalone

Copy link
Copy Markdown
Owner

Adds the public-safe changelog-philosophy blurb (Keep a Changelog 1.1.0 + the regression-citation rule) to AGENTS.md, per [[changelog-doctrine]]. Mirrors the identical addition in scriptorium + oracle — part of the LMS-suite doctrine propagation (scriptorium #7 roadmap P5).

🤖 Generated with Claude Code

Public-safe summary of the Keep-a-Changelog house standard + the
regression-citation rule (per changelog-doctrine). Mirrors scriptorium + oracle.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S98DYe1qKVSuEeh5S2U6nZ
- Remove stale vaultkit dependency (README + SKILL): it was vendored into
  lectern/_text.py; the PyPI name collides with an unrelated package, so the
  doc was both wrong and a dependency-confusion footgun.
- README architecture: note the ~58-module subsystem grouping and document the
  three-layer lab-grading pipeline (recon -> digest -> report), none of which
  writes the gradebook.
- docs index: add the lab-digest, lab-report, and lms-suite-integration design docs.
- Suite: cross-link SUITE.md + reg-suite-check (README + AGENTS); add the
  reg-lab-* and reg-suite-check entry-point rows.

Found via a docs audit against current code; no behavior change.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S98DYe1qKVSuEeh5S2U6nZ
@agiacalone agiacalone changed the title docs: add changelog-philosophy section to AGENTS.md docs: changelog philosophy + technical-audience sweep Jun 23, 2026
@agiacalone
agiacalone merged commit 92b24e6 into main Jun 23, 2026
4 checks passed
@agiacalone
agiacalone deleted the docs-changelog-philosophy branch June 23, 2026 20:08
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