docs+tooling: doc-freshness gate + documentation-pass policy + token-hygiene #24

Merged
user2595 merged 1 commits from docs/doc-freshness-and-token-hygiene into main 2026-05-28 04:15:37 +00:00
Owner

Refreshes CLAUDE.md for v0.10.0, adds a string-only doc-freshness gate, codifies the documentation-pass process in release-policy.md, and adds shared Claude config (.claude/settings.json + token-hygiene guide). Also fixes two stale phase references (v0.10.0 milestone mapping, test-cgal CI mention).

Refreshes CLAUDE.md for v0.10.0, adds a string-only doc-freshness gate, codifies the documentation-pass process in release-policy.md, and adds shared Claude config (.claude/settings.json + token-hygiene guide). Also fixes two stale phase references (v0.10.0 milestone mapping, test-cgal CI mention).
user2595 added 1 commit 2026-05-28 04:15:26 +00:00
docs+tooling: doc-freshness gate, documentation-pass policy, token-hygiene
All checks were successful
C++ Tests / test-fast (pull_request) Successful in 2m2s
API Docs / doc-build (pull_request) Successful in 1m8s
Markdown link check / check (pull_request) Successful in 52s
C++ Tests / test-cgal (pull_request) Has been skipped
C++ Tests / quality-gates (pull_request) Successful in 1m59s
569a03dc08
Refresh CLAUDE.md for v0.10.0 (3 CI jobs incl. disabled test-cgal,
compile-time option matrix, reviewer/pages docs, agentic + token-hygiene
workflow patterns) and condense the historical Phase-8/audit logs to
pointers.

Add the documentation-pass process so the single-source-of-truth rules
stay enforced:
  * scripts/quality/check-doc-freshness.sh — string-only drift gate
    (version/date across CITATION/CHANGELOG/CLAUDE, doc-map count), <1 s,
    registered in run-all.sh + quality README.
  * doc/release-policy.md — "Documentation passes" subsection (triggers +
    docs:sync rule); fix stale Phase-milestone mapping (v0.10.0 was
    reviewer-ready, 9c→v0.11.0) and the test-cgal CI mention.

Add shared Claude config (un-ignore the two files only):
  * .claude/settings.json — permission allowlist for safe repo commands.
  * .claude/token-hygiene.md — Tier-3 cache-discipline user guide that
    CLAUDE.md instructs Claude to remind the user about.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
user2595 merged commit 0048d71f11 into main 2026-05-28 04:15:37 +00:00
user2595 deleted branch docs/doc-freshness-and-token-hygiene 2026-05-28 04:15:38 +00:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: conformallab/ConformalLabpp#24
No description provided.