Skip to content

Commit fadfa46

Browse files
mcp-tool-shopclaude
andcommitted
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>
1 parent 1524a57 commit fadfa46

5 files changed

Lines changed: 32 additions & 32 deletions

File tree

.claude/CLAUDE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
# memory-os — project instructions
1+
# loadout-os — project instructions
22

33
## What this is
44

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:
66

77
| Was | Now lives at | Role |
88
|---|---|---|
@@ -48,7 +48,7 @@ Until Phase 6 retirement, **upstream source-of-truth stays at**:
4848
- `E:/AI/ai-loadout/` (kernel), `E:/AI/claude-memories/`, `E:/AI/claude-rules/` — the globally-installed CLIs come from these dirs
4949
- `~/.claude/loadout-hook/` — the running hook
5050

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.
5252

5353
## Repo-first waiver (deliberate — do not "fix")
5454

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# memory-os
1+
# loadout-os
22

33
> **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`).
44
@@ -11,7 +11,7 @@
1111
## Layout
1212

1313
```
14-
memory-os/
14+
loadout-os/
1515
├── packages/
1616
│ ├── kernel/ # was @mcptoolshop/ai-loadout (npm 1.4.3 — only one published)
1717
│ ├── memories/ # was @mcptoolshop/claude-memories (unpublished)

ROADMAP.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# memory-os — ROADMAP
1+
# loadout-os — ROADMAP
22

33
> Estimated horizon: **1–2 months** of session work to reach shippable.
44
> 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
3636

3737
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.
3838

39-
## Phase 3 — Unified CLI surface (1–2 sessions)
39+
## Phase 3 — Unified CLI surface (DONE 2026-06-16)
4040

41-
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.
4242

43-
- [ ] New `packages/cli/` with `bin: { "memory-os": "..." }`
43+
- [ ] New `packages/cli/` with `bin: { "loadout-os": "..." }`
4444
- [ ] Wrapping subcommands:
45-
- `memory-os memories <index|validate|stats|health>` — wraps `packages/memories/`
46-
- `memory-os rules <analyze|split|validate|stats>` — wraps `packages/rules/`
47-
- `memory-os resolve|explain|usage|dead|overlaps|budget|validate` — wraps `packages/kernel/`
48-
- `memory-os hook test` — drives `apps/hook` with a sample prompt
45+
- `loadout-os memories <index|validate|stats|health>` — wraps `packages/memories/`
46+
- `loadout-os rules <analyze|split|validate|stats>` — wraps `packages/rules/`
47+
- `loadout-os resolve|explain|usage|dead|overlaps|budget|validate` — wraps `packages/kernel/`
48+
- `loadout-os hook test` — drives `apps/hook` with a sample prompt
4949
- [ ] **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).
5353
- [ ] Old binaries (`claude-memories`, `claude-rules`, `ai-loadout`) get thin shims that delegate + deprecation-warn for one minor release
5454
- [ ] `--help` complete and accurate (Hard Gate C of shipcheck)
5555

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.
5757

5858
## Phase 4 — Docs + landing (1 session)
5959

@@ -68,33 +68,33 @@ Goal: one Starlight handbook + one landing page covers the whole layer.
6868

6969
Goal: reserve the name, set up Trusted Publishing, create the GitHub repo.
7070

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.
72-
- [ ] Reserve `@mcptoolshop/memory-os` via the `npm-placeholder` skill (v0.0.0 placeholder + OIDC/Trusted Publishing)
73-
- [ ] 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
7474
- [ ] Add remote, push everything to date
7575
- [ ] CI workflow per `github-actions.md` rules: paths-gated, ubuntu-latest only, concurrency block, max 2 workflow files
7676
- 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).
7777

7878
## Phase 6 — First real publish + upstream retirement (1 session)
7979

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.**
8181

8282
Pre-step — **consumer inventory** (do this BEFORE any cutover; pointer-chain breakage is this workspace's known failure mode):
8383
- [ ] Grep `E:\AI` for `@mcptoolshop/ai-loadout` imports (known: `apps/hook`; suspected: none — verify)
8484
- [ ] 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)
8686

8787
Ship:
8888
- [ ] Shipcheck full audit (31/31; v1.0.0 minimum rule satisfied by 1.0.0)
8989
- [ ] Translations BEFORE `npm publish` and `gh release create` (release-ordering rule, global CLAUDE.md)
9090
- [ ] `npm publish` via Trusted Publishing; `gh release create v1.0.0`
9191

9292
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
9494
- [ ] 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)
9696
- [ ] 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
9898

9999
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.
100100

@@ -106,12 +106,12 @@ Gate: shipcheck 31/31, CI green, hook works through the published package on a l
106106

107107
## Open questions (for the director)
108108

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.
111111
- License: three sources are MIT; root stays MIT? (Default yes.)
112112

113113
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).
114114

115115
## When this is done
116116

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.

package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
2-
"name": "memory-os",
2+
"name": "loadout-os",
33
"version": "0.0.0",
44
"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.",
66
"license": "MIT",
77
"author": "mcp-tool-shop",
88
"type": "module",

0 commit comments

Comments
 (0)