From 6b2154043a3dd472924135aacaeb5458ba0428df Mon Sep 17 00:00:00 2001
From: Jammy2211 <JNightingale2211@gmail.com>
Date: Mon, 13 Jul 2026 17:47:00 +0100
Subject: [PATCH] docs(ship): call lifecycle.py record on completion, not move
 (#71)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

ship_library/ship_workspace now write the paired dated record via
`lifecycle.py record <slug> --date --prompt --apply` (from the just-appended
complete.md entry) instead of moving the thin prompt — so new completions match
the historical rich records and stay paired 1:1 with complete.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 skills/ship_library/reference.md   | 15 ++++++++-------
 skills/ship_workspace/reference.md |  6 ++++--
 2 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/skills/ship_library/reference.md b/skills/ship_library/reference.md
index 72ca6fa..d20c933 100644
--- a/skills/ship_library/reference.md
+++ b/skills/ship_library/reference.md
@@ -137,13 +137,14 @@ push Mind. Do **not** move to `complete.md`.
 **Shipped (option iii passed):** offer to merge the library PR
 (`gh pr merge <n> --merge --auto`), post a "Shipped" comment (PRs, summary,
 optional session notes), then record completion in **both** lifecycle layers
-(issue #71) — the ledger entry **and** the prompt file move in lockstep:
-- **Ledger:** move the entry from `active.md` to `complete.md` (`issue`,
-  `completed: <date>`, `library-pr:`).
-- **File:** advance the prompt from `active/` to `complete/<YYYY>/<MM>/` —
-  `python3 PyAutoMind/scripts/lifecycle.py move <name> --date <completed> --apply`
-  (writes the rich record there; the `active/` file no longer lingers as it did
-  under the old `issued/`).
+(issue #71) — the ledger entry **and** the dated record, kept paired 1:1 by slug:
+- **Ledger:** append the entry to `complete.md` (`## <slug>`, `issue`,
+  `completed: <date>`, `library-pr:`) and drop it from `active.md`.
+- **Record:** write the paired dated record and fold + remove the `active/`
+  prompt —
+  `python3 PyAutoMind/scripts/lifecycle.py record <slug> --date <completed> --prompt <active-filename> --apply`
+  (writes `complete/<YYYY>/<MM>/<slug>.md` from the just-appended `complete.md`
+  entry; `lifecycle.py check` enforces the record ↔ `complete.md` pairing).
 
 Then push Mind with
 `prompt_sync_push "prompt: ship <task-name> (#<issue>) → complete"`.
diff --git a/skills/ship_workspace/reference.md b/skills/ship_workspace/reference.md
index 8ea387e..dabcd49 100644
--- a/skills/ship_workspace/reference.md
+++ b/skills/ship_workspace/reference.md
@@ -110,10 +110,12 @@ SHIP_EOF
 - workspace-pr: <workspace PR URL(s)>
 ```
 
-   **File** — advance the prompt from `active/` to `complete/<YYYY>/<MM>/`:
+   **Record** — write the paired dated record from the just-appended
+   `complete.md` entry, folding + removing the `active/` prompt (kept paired 1:1
+   by slug; `lifecycle.py check` enforces it):
 
 ```bash
-python3 PyAutoMind/scripts/lifecycle.py move <name> --date <YYYY-MM-DD> --apply
+python3 PyAutoMind/scripts/lifecycle.py record <slug> --date <YYYY-MM-DD> --prompt <active-filename> --apply
 ```
 
 Push Mind: `prompt_sync_push "prompt: ship <task-name> (#<issue>) → complete"`.