You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
chore(rename): memory-os -> loadout-os (Phase 5 rebrand, director call)
Rebrand resolved 2026-06-16: matches the *-os sister pattern (game-foundry-os, research-os) and keeps continuity with @mcptoolshop/ai-loadout + ~/.ai-loadout/. Renamed across root package.json (name+description), README, .claude/CLAUDE.md, ROADMAP (+ marked the naming open-question resolved, Phase 3 CLI done, npm reserve deferred to the Phase 6 real publish since the @mcptoolshop scope already protects the name). The unified CLI package is already @mcptoolshop/loadout-os (bin loadout-os). GitHub repo rename + local dir rename + canonical-memory rename follow as the remaining rebrand steps. apps/hook/smoke-test.ps1 keeps its historical 'memory-os' sample prompt.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: .claude/CLAUDE.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
-
# memory-os — project instructions
1
+
# loadout-os — project instructions
2
2
3
3
## What this is
4
4
5
-
**memory-os is the Knowledge OS for the studio**, consolidated into one repo so it can evolve as a single surface. It folds together three previously-separate npm packages plus the live runtime hook:
5
+
**loadout-os is the Knowledge OS for the studio**, consolidated into one repo so it can evolve as a single surface. It folds together three previously-separate npm packages plus the live runtime hook:
-`E:/AI/ai-loadout/` (kernel), `E:/AI/claude-memories/`, `E:/AI/claude-rules/` — the globally-installed CLIs come from these dirs
49
49
-`~/.claude/loadout-hook/` — the running hook
50
50
51
-
**Do not edit the three upstream repos from inside memory-os sessions.** Edits here stay here until the explicit Phase 6 cutover. The one exception is the hook's both-copies rule above.
51
+
**Do not edit the three upstream repos from inside loadout-os sessions.** Edits here stay here until the explicit Phase 6 cutover. The one exception is the hook's both-copies rule above.
Copy file name to clipboardExpand all lines: README.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# memory-os
1
+
# loadout-os
2
2
3
3
> **Prototype, 2026-06-10.** Consolidated Knowledge OS for the studio — folds `ai-loadout` (kernel) + `claude-memories` (MEMORY.md adapter) + `claude-rules` (CLAUDE.md adapter) + the runtime UserPromptSubmit pointer-injection hook into a single repo. Wired as npm workspaces (Phase 1 done — `npm install` + `npm run build`/`test`/`verify` work at root). Not yet published; no remote yet (a deliberate Phase-5 waiver — see `.claude/CLAUDE.md`).
4
4
@@ -11,7 +11,7 @@
11
11
## Layout
12
12
13
13
```
14
-
memory-os/
14
+
loadout-os/
15
15
├── packages/
16
16
│ ├── kernel/ # was @mcptoolshop/ai-loadout (npm 1.4.3 — only one published)
17
17
│ ├── memories/ # was @mcptoolshop/claude-memories (unpublished)
Copy file name to clipboardExpand all lines: ROADMAP.md
+23-23Lines changed: 23 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# memory-os — ROADMAP
1
+
# loadout-os — ROADMAP
2
2
3
3
> Estimated horizon: **1–2 months** of session work to reach shippable.
4
4
> Picker: whoever opens the next session in this tree. Read `.claude/CLAUDE.md` first — it has the live-system map and the source-of-truth rule.
@@ -36,24 +36,24 @@ The hook went live 2026-06-10 and immediately produced field evidence. Fix the k
36
36
37
37
Gate: hook is silent on a deliberately off-topic prompt; junk entries absent from a regenerated index; `claude-memories validate` 0 errors; `ai-loadout validate` 0 warnings.
Goal: one `memory-os` binary that wraps the three CLI surfaces AND absorbs the operational rituals.
41
+
Goal: one `loadout-os` binary that wraps the three CLI surfaces AND absorbs the operational rituals. **Built this session** — `packages/cli/` (`@mcptoolshop/loadout-os`, bin `loadout-os`): namespaced memories/rules wraps + flat kernel verbs + `doctor`/`report`/`refresh` rituals + `hook test`; 78 tests. `refresh` is built with a NAMED_COMPENSATOR but not yet run live; old-bin deprecating shims deferred to Phase 6.
42
42
43
-
-[ ] New `packages/cli/` with `bin: { "memory-os": "..." }`
43
+
-[ ] New `packages/cli/` with `bin: { "loadout-os": "..." }`
-`loadout-os hook test` — drives `apps/hook` with a sample prompt
49
49
-[ ]**Ritual subcommands** (this is the consolidation payoff — one command instead of a 3-step ritual):
50
-
-`memory-os refresh` — store index → validate (halt on errors) → copy/rewrite to `~/.ai-loadout/index.json`. Replaces `~/.ai-loadout/refresh.ps1`; update the Index Freshness Ritual text in the global CLAUDE.md when this lands.
51
-
-`memory-os doctor` — one health screen: store validates, index `generated` newer than newest store .md mtime, global copy matches store copy, hook wired in `~/.claude/settings.json`, usage.jsonl growing.
52
-
-`memory-os report` — usage/dead-entry/budget summary over usage.jsonl (the observability loop, run monthly).
50
+
-`loadout-os refresh` — store index → validate (halt on errors) → copy/rewrite to `~/.ai-loadout/index.json`. Replaces `~/.ai-loadout/refresh.ps1`; update the Index Freshness Ritual text in the global CLAUDE.md when this lands.
51
+
-`loadout-os doctor` — one health screen: store validates, index `generated` newer than newest store .md mtime, global copy matches store copy, hook wired in `~/.claude/settings.json`, usage.jsonl growing.
52
+
-`loadout-os report` — usage/dead-entry/budget summary over usage.jsonl (the observability loop, run monthly).
53
53
-[ ] Old binaries (`claude-memories`, `claude-rules`, `ai-loadout`) get thin shims that delegate + deprecation-warn for one minor release
54
54
-[ ]`--help` complete and accurate (Hard Gate C of shipcheck)
55
55
56
-
Gate: shipcheck `init` + `audit` cleanly on the new CLI; hard gates A–D green; `memory-os refresh` produces a byte-identical result to the manual ritual.
56
+
Gate: shipcheck `init` + `audit` cleanly on the new CLI; hard gates A–D green; `loadout-os refresh` produces a byte-identical result to the manual ritual.
57
57
58
58
## Phase 4 — Docs + landing (1 session)
59
59
@@ -68,33 +68,33 @@ Goal: one Starlight handbook + one landing page covers the whole layer.
68
68
69
69
Goal: reserve the name, set up Trusted Publishing, create the GitHub repo.
70
70
71
-
-[]**Naming decision deadline is the start of this phase** (`memory-os` vs rebrand; sister pattern: Game Foundry OS / Research OS / Testing OS). The npm-placeholder reserve locks the name.
-[ ] Create `mcp-tool-shop-org/memory-os` on GitHub (private at first; public at Phase 6 publish) — this closes the repo-first waiver
71
+
-[x]**Naming — RESOLVED 2026-06-16: `loadout-os`** (rebrand from `memory-os`; director call). Matches the `*-os`sister pattern (game-foundry-os, research-os) and keeps continuity with `@mcptoolshop/ai-loadout` + `~/.ai-loadout/`.
72
+
-[ ] Reserve `@mcptoolshop/loadout-os`— **deferred to the Phase 6 real publish**: the `@mcptoolshop` scope already protects the name (no squat risk on a scoped package), and the don't-default-to-empty-placeholder rule favors publishing the real treatment-complete package over a 0.0.0 placeholder. Wire OIDC/Trusted Publishing in the root `publish.yml`.
73
+
-[ ] Create `mcp-tool-shop-org/loadout-os` on GitHub (private at first; public at Phase 6 publish) — this closes the repo-first waiver
74
74
-[ ] Add remote, push everything to date
75
75
-[ ] CI workflow per `github-actions.md` rules: paths-gated, ubuntu-latest only, concurrency block, max 2 workflow files
76
76
- Remove `packages/*/.github/` (8 inert workflow files + 2 dependabot.yml) BEFORE adding the remote; author a single root CI per github-actions.md (max 2 workflows, paths-gated, one pages deploy).
77
77
78
78
## Phase 6 — First real publish + upstream retirement (1 session)
79
79
80
-
Goal: ship `@mcptoolshop/memory-os@1.0.0`, retire the three upstream repos. **Irreversible actions live here — author the six-standards compliance block + compensators table (publish, release, deprecate, settings cutover) in the session dispatch before executing.**
80
+
Goal: ship `@mcptoolshop/loadout-os@1.0.0`, retire the three upstream repos. **Irreversible actions live here — author the six-standards compliance block + compensators table (publish, release, deprecate, settings cutover) in the session dispatch before executing.**
81
81
82
82
Pre-step — **consumer inventory** (do this BEFORE any cutover; pointer-chain breakage is this workspace's known failure mode):
-[ ] List global installs to replace: `ai-loadout` (npm), `claude-memories` + `claude-rules` (installed from local upstream dirs)
85
-
-[ ] List config/doc references to update: global CLAUDE.md Index Freshness Ritual text, `~/.ai-loadout/refresh.ps1`, `~/.claude/settings.json` hook command, canonical memory entries (`memory-os-prototype.md`, `ai-loadout.md`, knowledge-os entries)
85
+
-[ ] List config/doc references to update: global CLAUDE.md Index Freshness Ritual text, `~/.ai-loadout/refresh.ps1`, `~/.claude/settings.json` hook command, canonical memory entries (`loadout-os-prototype.md`, `ai-loadout.md`, knowledge-os entries)
86
86
87
87
Ship:
88
88
-[ ] Shipcheck full audit (31/31; v1.0.0 minimum rule satisfied by 1.0.0)
89
89
-[ ] Translations BEFORE `npm publish` and `gh release create` (release-ordering rule, global CLAUDE.md)
90
90
-[ ]`npm publish` via Trusted Publishing; `gh release create v1.0.0`
91
91
92
92
Cut over + retire:
93
-
-[ ]`~/.claude/settings.json` hook command → the memory-os-installed hook entrypoint; verify with a live prompt; keep `~/.claude/loadout-hook/` until verified, then delete
93
+
-[ ]`~/.claude/settings.json` hook command → the loadout-os-installed hook entrypoint; verify with a live prompt; keep `~/.claude/loadout-hook/` until verified, then delete
94
94
-[ ] Replace global CLI installs; update ritual text + refresh script references
95
-
-[ ]`npm deprecate @mcptoolshop/ai-loadout` with a pointer to memory-os (the only published upstream)
95
+
-[ ]`npm deprecate @mcptoolshop/ai-loadout` with a pointer to loadout-os (the only published upstream)
96
96
-[ ] Archive upstream repos on GitHub (`gh repo archive` for ai-loadout / claude-memories / claude-rules) and move the local dirs `E:/AI/{ai-loadout,claude-memories,claude-rules}/` → `E:/DEEP_MEMORY/retired/` with a README pointing here
97
-
-[ ] Update canonical memory: `memory-os-prototype.md` → shipped entry; MEMORY.md one-liner; run the Index Freshness Ritual
97
+
-[ ] Update canonical memory: `loadout-os-prototype.md` → shipped entry; MEMORY.md one-liner; run the Index Freshness Ritual
98
98
99
99
Gate: shipcheck 31/31, CI green, hook works through the published package on a live prompt, consumer-inventory list fully checked off, no broken pointer chains.
100
100
@@ -106,12 +106,12 @@ Gate: shipcheck 31/31, CI green, hook works through the published package on a l
106
106
107
107
## Open questions (for the director)
108
108
109
-
- Naming: keep `memory-os`or rebrand? **Decide by Phase 5 start** (the npm reserve locks it).
110
-
- Kernel CLI surface preserved verbatim under `memory-os …` (lower migration cost) or restructured (fix ergonomics warts)? Default: verbatim, restructure later behind the same bin.
109
+
-~~Naming: keep or rebrand?~~**RESOLVED 2026-06-16 → `loadout-os`** (see Phase 5).
110
+
- Kernel CLI surface preserved verbatim under `loadout-os …` (lower migration cost) or restructured (fix ergonomics warts)? Default: verbatim, restructure later behind the same bin.
111
111
- License: three sources are MIT; root stays MIT? (Default yes.)
112
112
113
113
Resolved 2026-06-10: package manager = **npm workspaces** (matches every other studio monorepo; `workspace:*` in the original draft was pnpm syntax and would fail under npm).
114
114
115
115
## When this is done
116
116
117
-
When all six phases pass, flip this file to a CHANGELOG-style retrospective and start the next iteration. The canonical memory entry (`memory-os-prototype.md`) gets rewritten as a shipped-product entry at the same time.
117
+
When all six phases pass, flip this file to a CHANGELOG-style retrospective and start the next iteration. The canonical memory entry (`loadout-os-prototype.md`) gets rewritten as a shipped-product entry at the same time.
Copy file name to clipboardExpand all lines: package.json
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
1
{
2
-
"name": "memory-os",
2
+
"name": "loadout-os",
3
3
"version": "0.0.0",
4
4
"private": true,
5
-
"description": "Consolidated Knowledge OS for the studio — kernel (ai-loadout) + memories (claude-memories) + rules (claude-rules) + the runtime loadout hook, under one npm-workspaces root.",
5
+
"description": "loadout-os — consolidated Knowledge OS for the studio — kernel (ai-loadout) + memories (claude-memories) + rules (claude-rules) + the runtime loadout hook, under one npm-workspaces root.",
0 commit comments