Skip to content

Commit 28b486d

Browse files
docs(migration): encode completion-drive directive into the ledger (#542)
## Completion-drive directive (compaction-proofing) One-line-of-intent docs change: encodes the owner-authorised **autonomous drive of the migratable corpus to completion** directly into the migration ledger, so a post-compaction agent picks it up from the repo (not from a lossy summary). Records: - **Cluster order**: C5 → C11 → C9 → C10 → C12, each via the full 4-gate recipe, then the **string** + **effect** compiler walls (in-scope, this repo). - **Git hygiene** (learned this session): base each cluster on the **dev-branch tip**, not `origin/main`'s squash SHA — the remote dev branch is force-push-protected, so basing on it keeps pushes fast-forward and avoids the commit-identity hook nag. - **The one external gate**: Phase-Ω cutover (apply to idaptik + delete `.res` shadows) needs idaptik **write-access**; until then "migrated" = "staged + 4-gate-verified". Docs-only. https://claude.ai/code/session_01WoKhFQePiRsAj7aqnxbG8s --- _Generated by [Claude Code](https://claude.ai/code/session_01WoKhFQePiRsAj7aqnxbG8s)_ --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent f35f7fc commit 28b486d

1 file changed

Lines changed: 30 additions & 0 deletions

File tree

proposals/MIGRATION-PLAN.adoc

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -202,3 +202,33 @@ Heuristic:
202202

203203
*Resume rule:* read the highest non-DONE row + `migration-map.json`;
204204
continue from its "Notes".
205+
206+
[IMPORTANT]
207+
====
208+
*Completion-drive directive (user-authorised 2026-06-05).* The owner authorised
209+
driving the migratable corpus to completion *autonomously* — do NOT stop to
210+
re-ask at each cluster boundary. Standing plan for the resuming agent:
211+
212+
. Drive the MIGRATABLE-NOW clusters in this order, each via the full 4-gate
213+
recipe, staged under `proposals/idaptik/migrated/`, one PR per cluster,
214+
squash-merged when the gates are green (CI on this repo is non-gating; the
215+
authoritative gates are the parity/assail/agda runs done locally):
216+
*C5 → C11 → C9 → C10 → C12.* Classify senses/string-gated/effect-gated files
217+
honestly (like C3) rather than forcing a migration.
218+
. Then attack the two compiler walls *in this repo* (in scope): the string
219+
backend, then effect codegen — each unblocks its STRING-/EFFECT-GATED kernels.
220+
. Update this Ledger + `migration-map.json` after every cluster (repo-as-memory;
221+
compaction-proof).
222+
223+
*Git hygiene (learned 2026-06-05):* base each cluster's work on the *dev-branch
224+
tip* (`origin/claude/cool-keller-gr5sl`), NOT on `origin/main`'s squash SHA —
225+
the remote dev branch is force-push-protected, so basing on it keeps pushes
226+
fast-forward and avoids the post-squash-merge divergence that nags the
227+
commit-identity hook. Rebase onto `origin/main` only if main has advanced beyond
228+
the staged content.
229+
230+
*The one gate I cannot clear myself:* Phase Ω cutover (apply staged units to
231+
idaptik + delete the `.res` shadows) needs idaptik *write-access*. Until the
232+
owner opens that, "migrated" = "staged + 4-gate-verified", and true CLEAR
233+
(ReScript→0) waits on access. Everything up to that line is drivable here.
234+
====

0 commit comments

Comments
 (0)