Skip to content

Commit d2279f9

Browse files
josealekhineclaude
andcommitted
docs: add context preservation invariants to CONSTITUTION
Add new invariants clarifying that: - Archival is allowed, deletion is not - Archive preserves Phase structure for traceability Updated both the template and project's own CONSTITUTION.md. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent fdaf2b1 commit d2279f9

3 files changed

Lines changed: 12 additions & 2 deletions

File tree

.context/CONSTITUTION.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ These rules are INVIOLABLE. If a task requires violating these, the task is wron
2424

2525
## TASKS.md Structure Invariants
2626

27-
TASKS.md must remain a replayable checklist. Uncheck all items and re-run
27+
TASKS.md must remain a replayable checklist. Uncheck all items and re-run
2828
the loop = verify/redo all tasks in order.
2929

3030
- [ ] **Never move tasks** — tasks stay in their Phase section permanently
@@ -34,3 +34,8 @@ the loop = verify/redo all tasks in order.
3434
- [ ] **Use inline labels for status** — add `#in-progress` to task text, don't move it
3535
- [ ] **No "In Progress" / "Next Up" sections** — these encourage moving tasks
3636
- [ ] **Ask before restructuring** — if structure changes seem needed, ask the user first
37+
38+
## Context Preservation Invariants
39+
40+
- [ ] **Archival is allowed, deletion is not** — use `ctx tasks archive` to move completed tasks to `.context/archive/`, never delete context history
41+
- [ ] **Archive preserves structure** — archived tasks keep their Phase headers for traceability

.context/TASKS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@
5959
- [x] Implement `ctx tasks snapshot` — create point-in-time snapshot of TASKS.md
6060
- [x] Archive location: `.context/archive/tasks-YYYY-MM-DD.md`
6161
- [x] Keep Phase structure in archives for traceability
62-
- [ ] Update CONSTITUTION.md: archival is allowed, deletion is not
62+
- [x] Update CONSTITUTION.md: archival is allowed, deletion is not
6363

6464
### Phase 9: Claude Slash Commands (Skills) `#priority:medium` `#area:cli`
6565
- [ ] Research how existing skills are registered (check ralph-loop pattern)

internal/templates/CONSTITUTION.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,3 +27,8 @@ TASKS.md must remain a replayable checklist. Uncheck all items and re-run = veri
2727
- [ ] **Use inline labels for status** — add `#in-progress` to task text, don't move it
2828
- [ ] **No "In Progress" / "Next Up" sections** — these encourage moving tasks
2929
- [ ] **Ask before restructuring** — if structure changes seem needed, ask the user first
30+
31+
## Context Preservation Invariants
32+
33+
- [ ] **Archival is allowed, deletion is not** — use `ctx tasks archive` to move completed tasks to `.context/archive/`, never delete context history
34+
- [ ] **Archive preserves structure** — archived tasks keep their Phase headers for traceability

0 commit comments

Comments
 (0)