Skip to content

docs: rewrite global CLAUDE.md and add environment changelog (TKT-021)#33

Merged
tsilenzio merged 2 commits into
mainfrom
docs/global-claude-md-engrata
Jul 22, 2026
Merged

docs: rewrite global CLAUDE.md and add environment changelog (TKT-021)#33
tsilenzio merged 2 commits into
mainfrom
docs/global-claude-md-engrata

Conversation

@tsilenzio

Copy link
Copy Markdown
Owner

Summary

  • Rewrite the global config/claude/CLAUDE.md to document the private working-layer
    directory under its current name, with backward compatibility for the previous name kept
    through the transition (discovery rule, storage model, and per-project conventions).
  • Add a rewind doctrine (conversation-only by default, git checkpoint before any file
    restore) and an edit-then-tell protocol for mid-session rules-file edits.
  • Add config/claude/CHANGES.md, a location-scoped environment changelog, and a pointer to
    it from CLAUDE.md.
  • Fold the working-layer directory into the managed config/git/gitignore and add its
    ~/.claude/CHANGES.md link to config/manifest.

Test plan

  • Public/private leak lint returns only the deliberate global-rules carve-out file
  • Deployed ~/.claude/CLAUDE.md, ~/.claude/CHANGES.md, and ~/.gitignore resolve
    byte-identical to the branch content
  • CI checks on the PR

…md (TKT-021)

- engrata-aware rewrite: discovery rule, gitignored root rules files, rewind
  doctrine, edit-then-tell protocol, versioned SPEC/, migrated-project work
  tracking, and an environment-changelog pointer
- fold the .engrata ignore guard into the managed gitignore and link the new
  CHANGES.md in the manifest
@tsilenzio
tsilenzio merged commit d1884b0 into main Jul 22, 2026
6 checks passed
@tsilenzio
tsilenzio deleted the docs/global-claude-md-engrata branch July 22, 2026 01:15
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