@@ -29,6 +29,7 @@ Harvest valuable knowledge from completed specs, stale documentation, and in-pro
2929Additionally, scan source code for comments that reference completed specs, plans, or tasks and rewrite them as self-contained code documentation.
3030
3131The output is:
32+
32331 . Updated living documents (CHANGELOG, Guide.md) with harvested knowledge
33342 . Cleaned code comments (spec references → self-contained descriptions)
34353 . Stale files moved to ` .archive/ ` with preserved folder structure
@@ -125,6 +126,7 @@ For each file in `.documentation/` (recursive, never `.archive/`):
125126| ** Living Reference** | Top-level ` .documentation/*.md ` , Guide.md, CHANGELOG.md | Keep — may update |
126127
127128** Never archive:**
129+
128130- ` /.documentation/memory/constitution.md `
129131- ` /.documentation/scripts/ ` and ` /.documentation/templates/ `
130132- ` /.documentation/Guide.md ` — update it instead
@@ -206,6 +208,7 @@ If the user says **modify**, apply their changes to the plan and re-present befo
206208#### 4a. Update CHANGELOG.md
207209
208210For each completed spec NOT already in CHANGELOG:
211+
2092121 . Read the spec's ` spec.md ` , ` plan.md ` , and ` tasks.md `
2102132 . Extract: spec number, key changes, what was delivered
2112143 . Prepend a new entry above existing content:
@@ -225,6 +228,7 @@ Never modify existing CHANGELOG entries.
225228#### 4b. Update .documentation/Guide.md
226229
227230If completed specs introduced:
231+
228232- New patterns or conventions → update the relevant section
229233- New directories or files in ` .documentation/ ` → update the directory map
230234- Deprecated old patterns → note the deprecation
@@ -234,6 +238,7 @@ The guide describes the **current state only** — no historical content.
234238#### 4c. Update .github/copilot-instructions.md (if it exists)
235239
236240If completed specs introduced:
241+
237242- New import paths, module names, or architectural patterns
238243- New document schemas or field names
239244- Deprecations of old patterns
@@ -249,6 +254,7 @@ For each spec/task reference identified in the pre-scan:
2492543 . Apply the edit
250255
251256** Rules** :
257+
252258- Never remove a comment without understanding its purpose first
253259- If the comment accurately describes behavior but just has a spec prefix, strip only the prefix
254260- If the comment is a pure task marker with no behavioral value, remove it entirely
@@ -268,6 +274,7 @@ For each spec/task reference identified in the pre-scan:
2682746 . After moving, verify no active file references the archived paths
269275
270276** Do not move:**
277+
271278- ` /.documentation/memory/constitution.md `
272279- ` /.documentation/scripts/ `
273280- ` /.documentation/templates/ `
0 commit comments