Skip to content

feat: local and global personal stores; release v0.3.0 - #18

Merged
M0xoo merged 1 commit into
mainfrom
wisp/can-we-make-an-option-to-have-in-2decc0
Nov 17, 2026
Merged

M0xoo merged 1 commit into
mainfrom
wisp/can-we-make-an-option-to-have-in-2decc0

Conversation

@M0xoo

@M0xoo M0xoo commented Nov 17, 2026

Copy link
Copy Markdown
Contributor

What

ingrain can now be used without committing anything, and with personal decisions and rules that apply in every repository.

Store Where Applies to Ids
project (default) decisions/, .corrections/ the repo, shared D-
--local .git/ingrain/local/ this repo, for you only L-
--global ~/.config/ingrain/ ($INGRAIN_HOME) every repo on this machine G-
  • ingrain init --local: puts the hooks in .claude/settings.local.json (added to .git/info/exclude) and writes nothing to the working tree.
  • ingrain init --global: puts plugin-style --from-plugin hooks in ~/.claude/settings.json. It skips them if that file already enables the ingrain plugin.
  • Reading: hooks, check, decisions for/list/stale and the rules read all stores.
  • Writing: --local / --global pick the store. supersede, accept, reject and show find the store from the id.
  • Pre-commit and CI: the project store is still read from the base revision (D-0014). Personal stores are read as they are.

Safety

  • Agents can't edit, accept or retune personal-store files (Edit/Write are denied, Bash commands ask the person). Personal stores have no first-setup exception.
  • A repo that only sees global decisions keeps its own decisions/ folder (ADRs) editable.
  • Broken personal files are skipped, so one bad file can't fail checks in every repository.
  • Team repos (project store) behave as before.

Docs

New book page docs/book/src/guide/personal-stores.md. Also updated: README, all skills/*/SKILL.md, the layout page, the hooks, decisions, learned-rules, quick-start and agents pages, and the regenerated CLI reference.

Release

Version is now 0.3.0 in Cargo.toml/.lock, plugin.json, action, examples, docs and CHANGELOG.

Ledger

Two proposals for a person to accept: one replaces D-0019 (plugin hooks also act where personal decisions exist), the other D-0014 (personal stores are read as they are in pre-commit).

Tests

cargo test --workspace: 121 passed, including the new crates/cli/tests/personal.rs. cargo clippy --all-targets is clean, mdbook build passes, and ingrain check reports nothing broken.

🤖 Generated with Claude Code

Decisions and learned rules can now be kept out of the repository:
`--local` (.git/ingrain/local, L- ids) for one repository and
`--global` (~/.config/ingrain or $INGRAIN_HOME, G- ids) for every
repository. `ingrain init --local` writes hooks to the git-excluded
.claude/settings.local.json; `ingrain init --global` writes plugin-style
hooks to ~/.claude/settings.json. Hooks, check, decisions for/list/stale
read all stores; supersede/accept/reject/show route by id.

Agents can't edit, accept or retune personal-store files (no first-setup
exception), a repo that only sees global decisions keeps its own
decisions/ editable, and broken personal files are skipped instead of
failing checks everywhere.

Docs: new book page guide/personal-stores.md, README, skills, layout,
regenerated CLI reference. Version bumped to 0.3.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@M0xoo
M0xoo merged commit ebd819d into main Nov 17, 2026
10 checks passed
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