Project-bound knowledge for dotfiles, kept in-repo (docs-as-code). The operate/build layer lives here so it is versioned with the code and readable by any agent in-context — no external knowledge store required.
adr/— Architecture Decision Records (the why behind decisions) and the repo audits / architecture maprunbooks/— operational procedures (setup, secrets, tooling)troubleshooting/— known issues and their fixeslessons.md— accumulated gotchas and post-mortems
The decide/position layer (roadmap, prestudy, strategy) and session memory live in the maintainer's cross-project knowledge store and are intentionally not committed here.