@@ -58,6 +58,30 @@ existing practices before any code is written. This is especially
5858valuable in legacy systems: it prevents clean-room redesigns and makes
5959incremental change safer.
6060
61+ ## Document Roles and Lifetimes
62+
63+ Spec Loop uses more than one document type on purpose. They do not have
64+ the same job or the same lifetime.
65+
66+ - Task files are short-lived working artifacts for the next concrete
67+ slice of work. They exist to drive research, review, implementation,
68+ and testing of that slice.
69+ - ADRs capture durable decisions and the reasons behind them.
70+ - A glossary captures stable shared language across tasks, design,
71+ tests, code symbols, and commits.
72+ - Living project documents capture current truth that should remain
73+ useful after the task is accepted, such as technical shape,
74+ operations, or other stable project knowledge.
75+
76+ Historical task files do not need to be kept mutually consistent across
77+ time. The active task, however, should stay aligned with the glossary,
78+ living project documents, and implemented code for its scope.
79+
80+ If a project maintains a technical design document, its purpose is to
81+ describe the current technical shape, stable boundaries, and important
82+ flows. It should not become a second glossary or a catalog of transient
83+ implementation detail.
84+
6185## Getting started
6286
6387Apply the process to your repository.
0 commit comments