Update policy documentation in advance of a full documentation pass

2026-07-03 21:46:27 -05:00
parent 4db7805a95
commit b738dbc1eb
2 changed files with 100 additions and 294 deletions
--- a/docs/policy/documentation.md
+++ b/docs/policy/documentation.md
@@ -188,7 +188,9 @@ It should include:
 - architectural invariants;
 - explicit non-goals, if useful.

-For small projects, this file may be brief. It may simply state that the project is intentionally narrow, monolithic, and dependency-light.
+Notably, this file should prescribe a core development *policy* that should remain unchanged as the application evolves. It is not a place for details (e.g., CLI flags) that could change over time.
+
+The contents of `architecture.md` should be trim and concise. LLMs may be directed to review it routinely via AGENTS.md, CLAUDE.md, or similar.

 ### docs/api.md