Skip to content

Commit f534870

Browse files
committed
fix(skills): add explicit migration step to the Phase 3 build order
On the restructure path, the build sequence went straight from indexes to fresh seed notes without ever executing the approved old-to-new mapping — an assistant could finish onboarding with the original messy root notes untouched. Added migration as step 5 (move, retype, add required observations, archive-never-delete) and extended validation to cover migrated notes as well as seeds. Signed-off-by: Cody Faust <cody@luminarysol.com>
1 parent 52ec0e1 commit f534870

1 file changed

Lines changed: 3 additions & 2 deletions

File tree

skills/memory-onboarding/SKILL.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -95,8 +95,9 @@ Build in this order — later items reference earlier ones:
9595
2. **Templates**`Templates/`, one per note type, matching the schema exactly.
9696
3. **Instruction notes** → per-domain rules notes, then the **startup router** last (it links everything). Full anatomy and a worked example in `references/conventions.md`.
9797
4. **Index notes** → one per domain that needs one (tables of contents; not every domain does).
98-
5. **Seed notes** → 2–3 REAL notes per domain using the examples collected in Phase 1. Never seed with placeholder data — real notes teach the format and are immediately useful; fake ones are noise the user must delete.
99-
6. **Validate** → run `schema_validate` on the seed notes; fix anything it flags. Read back the router and one instruction note to confirm links resolve.
98+
5. **Migrate existing notes** *(restructure path)* → execute the approved old→new mapping from Phase 2 before seeding anything: move each existing note to its new home, set its note type, add the observations its schema requires, and update indexes as notes land. Archive what doesn't fit — never delete. Phase 3 is not done while anything still sits unorganized at the root.
99+
6. **Seed notes** → 2–3 REAL notes per domain using the examples collected in Phase 1. Never seed with placeholder data — real notes teach the format and are immediately useful; fake ones are noise the user must delete.
100+
7. **Validate** → run `schema_validate` on the seed notes AND any migrated notes; fix anything it flags. Read back the router and one instruction note to confirm links resolve.
100101

101102
Follow the write discipline in `references/conventions.md` throughout — most importantly: search before creating anything, use exact folder casing, and watch write results for duplicate-suffixed permalinks (`-1`, `-2`).
102103

0 commit comments

Comments
 (0)