docs(repo): deprecate stale INDEX.md, redirect to living entry points #333

Merged

pdurlej merged 1 commit from claude/d/deprecate-stale-INDEX-md into main

2026-05-23 09:18:48 +02:00

claude commented

2026-05-17 17:51:04 +02:00

Collaborator

Summary

Closes #68. INDEX.md was generated 2026-04-30 ("L4 complete, ready for hand-off to Codex GPT-5.5") and has been frozen since. Says 81 modules (actual: 80). References plan execution that finished 18+ days ago. Exact drift mode DeepSeek deep review named.

What

Stub-replaces 175 lines of stale narrative with a 60-line pointer index → living entry points:

Need	Live entry point
Operator's current intent	`state/STATUS_NOW.md` (canonical per ADR-0006)
Post-compaction Pan Herbatka	`state/pan-herbatka-day1-checklist.md`
Any cousin entering cold	`state/ANY-COUSIN-WAKEUP.md` (DeepSeek #4)
Module inventory	`modules/INDEX.yaml` (anticipated D-1 regen)
Architecture	`PLATFORM_CHARTER.md` (§2 updated PR #332)
platform.exe identity	`PLATFORM_CONSTITUTION.md`
Cousin runbook	`AGENTS.md`
Review rules	`REVIEW.md`
ADRs	`decisions/`
Cutover live state	Forgejo issue #142

Preserves historical context (bootstrap plan, L-1→L4 layers) so future readers understand the file's origin.

Stub, not delete — why

External references in older cousin letters / dispatches / operator shortcuts may still link to INDEX.md. Deleting would create dangling refs. Stub redirects without breakage.

Future cleanup may delete entirely after auditing remaining mentions in state/, prompts/, runbooks/.

Tier

Trivial per ADR-0007 (docs-only, no code / schema / runtime / sacred-path mutation).

Refs DeepSeek deep review 2026-05-14 cross-cutting pattern (state/deep-reviews/2026-05-14-platform-deep-review.md)
Closes #68

## Summary **Closes #68.** `INDEX.md` was generated 2026-04-30 ("L4 complete, ready for hand-off to Codex GPT-5.5") and has been frozen since. Says 81 modules (actual: 80). References plan execution that finished 18+ days ago. Exact drift mode DeepSeek deep review named. ## What Stub-replaces 175 lines of stale narrative with a 60-line pointer index → living entry points: | Need | Live entry point | |---|---| | Operator's current intent | `state/STATUS_NOW.md` (canonical per ADR-0006) | | Post-compaction Pan Herbatka | `state/pan-herbatka-day1-checklist.md` | | Any cousin entering cold | `state/ANY-COUSIN-WAKEUP.md` (DeepSeek #4) | | Module inventory | `modules/INDEX.yaml` (anticipated D-1 regen) | | Architecture | `PLATFORM_CHARTER.md` (§2 updated PR #332) | | platform.exe identity | `PLATFORM_CONSTITUTION.md` | | Cousin runbook | `AGENTS.md` | | Review rules | `REVIEW.md` | | ADRs | `decisions/` | | Cutover live state | Forgejo issue #142 | Preserves historical context (bootstrap plan, L-1→L4 layers) so future readers understand the file's origin. ## Stub, not delete — why External references in older cousin letters / dispatches / operator shortcuts may still link to `INDEX.md`. Deleting would create dangling refs. Stub redirects without breakage. Future cleanup may delete entirely after auditing remaining mentions in `state/`, `prompts/`, `runbooks/`. ## Tier **Trivial** per ADR-0007 (docs-only, no code / schema / runtime / sacred-path mutation). Refs DeepSeek deep review 2026-05-14 cross-cutting pattern (`state/deep-reviews/2026-05-14-platform-deep-review.md`) Closes #68

claude added 1 commit

2026-05-17 17:51:04 +02:00

docs(repo): deprecate stale INDEX.md, redirect to living entry points

base-is-main / guard (pull_request) Successful in 1s

Details

canary-required / collect-diff (pull_request) Successful in 3s

Details

patchwarden-pr-sanity / collect-diff (pull_request) Successful in 3s

Details

canary-required / canary (pull_request) Has been skipped

Details

patchwarden-pr-sanity / sanity (pull_request) Successful in 19s

Details

cd78ce97f5

Closes #68. Per DeepSeek deep review 2026-05-14: INDEX.md was generated
2026-04-30 ("L4 complete, ready for hand-off to Codex GPT-5.5") and
frozen since. Module count says 81, actual is 80. Status references
plan execution that finished 18+ days ago.

Per ADR-0018: documentation that lies about reality is an agent-visible
signal compressed-context successors read as truth. This is the same
structural drift DeepSeek named in PLATFORM_CHARTER §2 (finding #5,
addressed in PR #332).

Approach: stub-replace, not delete. External references (older cousin
letters, codex dispatches, operator's mental shortcuts) may still link
to INDEX.md — deleting would create dangling refs. The stub:

- Names every living entry point with one-line "use when" guidance:
  - state/STATUS_NOW.md (canonical per ADR-0006)
  - state/pan-herbatka-day1-checklist.md (post-compaction protocol)
  - state/ANY-COUSIN-WAKEUP.md (60-sec model-agnostic, per DeepSeek #4)
  - modules/INDEX.yaml (anticipated D-1 platformctl index generate)
  - PLATFORM_CHARTER.md (architectural constitution, §2 updated PR #332)
  - PLATFORM_CONSTITUTION.md, AGENTS.md, REVIEW.md, decisions/
  - Forgejo issue #142 for cutover live state
- Preserves historical context (the bootstrap plan, L-1→L4 layers, what
  this file used to do) so future readers understand why it exists
- Closes #68

Future ops cleanup may delete entirely after auditing remaining mentions.

Tier: Trivial per ADR-0007 (docs-only, no code/schema/runtime/sacred path).

Refs DeepSeek deep review 2026-05-14 cross-cutting pattern
(state/deep-reviews/2026-05-14-platform-deep-review.md)
Closes #68