Skip to content
FSS Knowledge Base

Monorepo Cleanup → Ongoing-Project Migration

Section titled “Monorepo Cleanup → Ongoing-Project Migration”

Date: 2026-06-25 Project/Task: monorepo-cleanup-upgrade (Core/IT) — first real unit of work under SMTM v5.2 dept routing Status: ✅ Complete

Summary

Section titled “Summary”

Migrated the monorepo to the SMTM v5.2 ongoing-project model: repo = SSOT (full doc set), one KB portal, dept-scoped logs, zero dual-tree. Retired the _WorkingOn/Projects/monorepo/ + Core/Logs/Projects/monorepo/ trees that the old finite-Project lifecycle had forced onto an evergreen project. Dogfooded v5.2 — the model the same session canonized.

Done

Section titled “Done”
  • Repo doc set created (~/projects/monorepo/): STATUS.md (live state, verified from CHANGELOG/git — not the stale 2026-03-10 STATUS), ROADMAP.md (evergreen workstreams), UPGRADES.md (ideas parking lot).
  • Repo CLAUDE.md de-staled — rewrote the “Task & Session Documentation” block (was lines 219–296): removed all 8 Business/_WorkingOn/Projects/monorepo/ + NEXT-STEPS/active/complete references; replaced with the v5.2 model (repo STATUS/ROADMAP/UPGRADES, portal Core/IT/Monorepo/Monorepo.md, tasks Core/IT/Tasks/, logs Core/IT/Logs/).
  • Dual-tree retired — 24 logs + 2026-05-14_review-reports/ + 1 plan migrated (git mv, history preserved) to Core/IT/Logs/Projects/monorepo/; both old trees deleted.
  • Portal Monorepo.md — fixed the wrong D:\projects\monorepo path (it’s a WSL-home repo → \\wsl$\…); hygiene checklist ticked.
  • README:116 Focus refs — verified valid (both <Biz>/_WorkingOn/Focus.md exist), no change.
  • Judgment calls resolved (Talbot):
    • cron-job-monitor.md → moved to Core/IT/Utils/Custom/ (monitors all cron, not monorepo).
    • Focus-Pages SSOT → moved into the repo at monorepo/docs/focus-pages.md (it’s a monorepo feature; repo = SSOT). Both KB notes (Core/IT/Utils/Custom/Focus-Pages.md, Core/Processes/KB-OS/Focus-Pages.md) reduced to pointers.
    • monorepo-review.md (the 2026-05-14 deep-review task) → archived to Core/IT/Logs/Projects/monorepo/2026-05-14_Monorepo-Deep-Review-task.md.
  • Spin-off: a fresh deep code review was warranted (61 commits since 2026-05-14) → ran as separate task monorepo-deep-review; report at 2026-06-25_Deep-Review.md + 2026-06-25_review-reports/, fixes committed 8b3ba22/128a52e.

Changes (this cleanup task)

Section titled “Changes (this cleanup task)”
  • monorepo repo: STATUS.md, ROADMAP.md, UPGRADES.md, docs/focus-pages.md created; CLAUDE.md rewritten — committed 9d9430f (+ follow-up).
  • KB: portal fixed; two Focus-Pages notes → pointers; cron-job-monitor + monorepo-review relocated; old trees deleted; tracker updated.

Gotchas / lessons (candidates — not yet promoted)

Section titled “Gotchas / lessons (candidates — not yet promoted)”
  • Root cause of the dual-tree mess: an evergreen project was force-fit into the finite-Project lifecycle (_WorkingOn/Projects/). SMTM v5.2’s Ongoing Project construct fixes this structurally. → repo LESSONS.md: “monorepo is an ongoing project — never recreate _WorkingOn/Projects/monorepo.”
  • Duplicate filenames need path-qualified wikilinks — two Focus-Pages.md made [Focus-Pages](/core/it/utils/custom/focus-pages/) ambiguous; used label. Confirms the global CLAUDE.md wikilink rule.
  • Ongoing-project feature docs belong in the repo, not the KB — Focus-Pages SSOT moved into monorepo/docs/; KB keeps pointers. Reinforces “repo = SSOT” for ongoing projects.

Next Steps

Section titled “Next Steps”
  • Optional: Core/Logs/Dev/ now holds only a Dev.md stub (all logs migrated) — remove the dead folder if desired.
  • Promote the lessons above into repo LESSONS.md if approved.