---
title: Migration Plan — Team-Aware Layout
created: 2026-05-01
type: system
phase: 1
status: awaiting-approval
---

# Migration Plan — Team-Aware Layout

## Pre-flight: working tree state

Before Phase 3 can run cleanly, the **uncommitted earlier vault rebuild must be committed first** so the restructure diff is reviewable in isolation. Current `git status` shows:

- 12 renames (`RateRight-HQ/* → HQ-Vault/*`) — staged
- 2 new daily notes (`2026-03-16.md`, `2026-03-17.md`) — untracked
- 1 new daily note (`2026-05-01.md`) — untracked
- 16 new vault files (CLAUDE stubs, _Log stubs, README stubs, templates, audit, MOC) — untracked

Recommend a single commit `vault: rebuild HQ-Vault from RateRight-HQ + scaffold templates and stubs` before Phase 3 begins. This is a Phase 2 decision point — not part of the restructure itself.

## Vault counts (current)

- 32 files total (matches audit's 31 + `InitialAudit.md`)
- 11 top-level folders + `_System/`
- 16 sub-folders

## 1. Delta table

### Folders to create

| Action | Path | Reason |
|---|---|---|
| Create | `10_RateRight/_Brain/` | New project structure spec |
| Create | `10_RateRight/_AgentLog/` | New project structure spec |
| Create | `10_RateRight/Business/` | Replaces ad-hoc top-level + absorbs Marketing/ |
| Create | `10_RateRight/Codebase/` | New project structure spec |
| Create | `10_RateRight/Archive/` | New per-project archive |
| Create | `11_OpsMan_LFCS/_Brain/` | Spec |
| Create | `11_OpsMan_LFCS/_AgentLog/` | Spec |
| Create | `11_OpsMan_LFCS/Business/` | Spec |
| Create | `11_OpsMan_LFCS/Operations/` | Spec |
| Create | `11_OpsMan_LFCS/Codebase/` | Spec |
| Create | `11_OpsMan_LFCS/Archive/` | Spec |
| Create | `12_SiteOps/_Brain/` | Spec |
| Create | `12_SiteOps/_AgentLog/` | Spec |
| Create | `12_SiteOps/Business/` | Spec |
| Create | `12_SiteOps/Operations/` | Spec |
| Create | `12_SiteOps/Codebase/` | Spec |
| Create | `12_SiteOps/Archive/` | Spec |
| Create | `20_Personal/_Brain/` | Spec |
| Create | `30_Goals/_Brain/` | Spec |
| Create | `_Archive/` | Vault-wide archive (new) |
| Create | `_System/AgentLog/` | Cross-project agent activity log (new) |

Each new folder gets a `.gitkeep` so git tracks it before any content moves in. (Required because Phase 3 commits the skeleton before the file moves — otherwise the empty dirs vanish.)

### Folders that already exist and are correct

`00_Inbox/`, `01_Daily/`, `02_Weekly/`, `40_People/`, `90_Reference/`, `_System/Templates/`, `10_RateRight/Operations/` (already present, used as-is)

### Folders that go away (absorbed into new structure)

| From | To | Note |
|---|---|---|
| `10_RateRight/Marketing/` | `10_RateRight/Business/Marketing/` | Marketing is a Business subdiscipline |
| `10_RateRight/Projects/` | `10_RateRight/Operations/` | Single file (Kill-Flyio-Plan); content is infra ops |
| `10_RateRight/Skills/` | (vault-wide `90_Reference/`) | Generic Claude Code content per audit §7 |

### File moves

| Action | From | To | Reason |
|---|---|---|---|
| Move | `10_RateRight/CLAUDE.md` | `10_RateRight/_Brain/CLAUDE.md` | Spec: _Brain/ holds CLAUDE.md |
| Move | `10_RateRight/README.md` | `10_RateRight/_Brain/README.md` | Spec: _Brain/ holds README.md (future MOC) |
| Move | `10_RateRight/_Log.md` | `10_RateRight/_Brain/_Log.md` | Spec: _Brain/ holds _Log.md |
| Move | `10_RateRight/COO-TO-HQ.md` | `10_RateRight/_AgentLog/COO-TO-HQ.md` | Agent-to-agent comms log (old fleet, pre-2026-04-29) |
| Move | `10_RateRight/HQ-TO-COO.md` | `10_RateRight/_AgentLog/HQ-TO-COO.md` | Agent-to-agent comms log |
| Move | `10_RateRight/Marketing/Facebook-Strategy.md` | `10_RateRight/Business/Marketing/Facebook-Strategy.md` | Marketing → Business/Marketing |
| Move | `10_RateRight/Marketing/Poster-Printing-Options.md` | `10_RateRight/Business/Marketing/Poster-Printing-Options.md` | Same |
| Move | `10_RateRight/Projects/Kill-Flyio-Plan.md` | `10_RateRight/Operations/Kill-Flyio-Plan.md` | Infra shutdown is operations |
| Move | `10_RateRight/Skills/Claude-Code-Automation-Guide.md` | `90_Reference/Claude-Code-Automation-Guide.md` | Generic, not RateRight-specific (audit §7) |
| Move | `10_RateRight/CLAUDE-original.md` | (does not exist — already removed earlier today) | n/a |
| Move | `11_OpsMan_LFCS/CLAUDE.md` | `11_OpsMan_LFCS/_Brain/CLAUDE.md` | Spec |
| Move | `11_OpsMan_LFCS/README.md` | `11_OpsMan_LFCS/_Brain/README.md` | Spec |
| Move | `11_OpsMan_LFCS/_Log.md` | `11_OpsMan_LFCS/_Brain/_Log.md` | Spec |
| Move | `11_OpsMan_LFCS/Agent-Stack-MOC.md` | `11_OpsMan_LFCS/_Brain/Agent-Stack-MOC.md` | It IS a Map-of-Content; lives with brain navigation |
| Move | `12_SiteOps/CLAUDE.md` | `12_SiteOps/_Brain/CLAUDE.md` | Spec |
| Move | `12_SiteOps/README.md` | `12_SiteOps/_Brain/README.md` | Spec |
| Move | `12_SiteOps/_Log.md` | `12_SiteOps/_Brain/_Log.md` | Spec |
| Move | `20_Personal/CLAUDE.md` | `20_Personal/_Brain/CLAUDE.md` | Spec |
| Move | `30_Goals/CLAUDE.md` | `30_Goals/_Brain/CLAUDE.md` | Spec |

**No file in `01_Daily/`, `40_People/`, `90_Reference/`, `_System/` (top-level)** moves.

### Frontmatter / backlink fixes

| File | Change | Reason |
|---|---|---|
| `10_RateRight/Operations/Kill-Flyio-Plan.md` | Frontmatter `related:` field: `[[03-Operations/Email-Deliverability-Fix]]` → `[[Email-Deliverability-Fix]]` | Audit §5 broken link; legacy `vault/03-Operations/` path no longer exists. Wikilink resolves to file by name now. |

### New stub files (empty content per "don't write content")

| File | Content |
|---|---|
| `_System/TeamProtocol.md` | Single H1 + frontmatter. Body left for Rocky. |
| `_System/Conflicts.md` | Single H1 + frontmatter. Body left for Rocky / migration to populate. |
| `_System/CuratorLog.md` | Single H1 + frontmatter. Body left for Rocky. |

## 2. Files I'm uncertain about

### Q1 — `10_RateRight/ROADMAP.md` placement

**Default**: leave at `10_RateRight/ROADMAP.md` (top of project folder).

**Alternative considered**: `10_RateRight/_Brain/ROADMAP.md`. Spec says `_Brain/` contains `CLAUDE.md, README.md (MOC), _Log.md` — nothing else listed. ROADMAP isn't mentioned anywhere in the spec.

**Why uncertain**: ROADMAP.md is the project's strategic priority list — feels brain-adjacent. But spec is explicit about what _Brain/ holds.

**Recommendation**: keep at top of `10_RateRight/`, treat as a project-root file like the per-project README would have been pre-restructure. Tell me if you want it inside `_Brain/`.

### Q2 — `11_OpsMan_LFCS/Agent-Stack-MOC.md` placement

**Default**: `11_OpsMan_LFCS/_Brain/Agent-Stack-MOC.md`.

**Alternative**: `11_OpsMan_LFCS/Operations/Agent-Stack-MOC.md` (it documents operational infrastructure — Hermes, OpsMan, services).

**Why uncertain**: an MOC is a navigation aid; `_Brain/README.md` is supposed to be the project's MOC per spec. So having a second MOC alongside it is structural double-up. But an MOC about live-services-ops feels like Operations content too.

**Recommendation**: `_Brain/` (it's a navigation MOC, just scoped to agent-stack). If you'd rather it lives in Operations as content (and let the future `_Brain/README.md` link to it), say so.

### Q3 — `COO-TO-HQ.md` and `HQ-TO-COO.md` placement

**Default**: `10_RateRight/_AgentLog/`.

**Alternative**: `_Archive/` — these are stale comms from the hibernated 8-agent fleet (last update 2026-03-16, ~6 weeks before fleet hibernation 2026-04-29). The COO/HQ chain isn't operative anymore.

**Why uncertain**: `_AgentLog/` per the new spec is "Hermes & OpenClaw per-project logs" — but COO/HQ predates Hermes-as-current-architecture. Strictly historical.

**Recommendation**: `_AgentLog/` for now (preserves the chronological record near the project). Move to `_Archive/` later if Rocky wants the active `_AgentLog/` to be Hermes-only.

### Q4 — `Skills/Claude-Code-Automation-Guide.md` destination

**Default**: `90_Reference/Claude-Code-Automation-Guide.md` (audit §7 recommendation — generic, not RateRight-specific).

**No alternative considered**: target structure has no `Skills/` subfolder anywhere; this file MUST move. `90_Reference/` is the right destination per audit. Flagging only because it's the one file that crosses *project boundaries* (10_RateRight → vault-wide).

## 3. Risk assessment

| Risk | Mitigation |
|---|---|
| Working tree has pending earlier-rebuild changes; restructure diff would be unreadable mixed in | **Pre-flight commit before Phase 3** (called out above) |
| `git mv` chains break if intermediate dir doesn't exist | **Folder skeleton created in commit 1** with `.gitkeep` files; all subsequent moves run against existing dirs |
| Wikilinks break when files move | Audit found only 1 broken link, already fixed in this plan. No `[[wikilinks]]` to moved files exist (most notes are orphans). Phase 4 link-integrity check catches anything missed |
| Frontmatter accidentally damaged in fixup | Single edit (one frontmatter field, one file). Diff will be 1 line. |
| Daily-note appending counts as a body edit | "No content edits" applies to migrated notes; daily-note progress logging is the standard journaling rule from `_System/CLAUDE.md`. Treating as exempt. |
| `.gitkeep` files left over after content arrives | Phase 4 cleanup or just leave them — harmless |
| Rollback complexity | Every step is a single commit; rollback is `git revert <hash>` per step or `git reset --hard <pre-restructure-tag>` for whole-job revert |

## 4. Estimated commit count for Phase 3

**7 commits, plus the pre-flight commit (= 8 commits if you accept the pre-flight).**

| # | Commit | Files touched |
|---|---|---|
| 0 (pre-flight) | `vault: rebuild HQ-Vault from RateRight-HQ + scaffold templates and stubs` | All currently uncommitted moves + new files |
| 1 | `restructure: create new folder skeleton with .gitkeep` | ~21 new dirs + .gitkeep files |
| 2 | `restructure: 10_RateRight — move into _Brain + reorganise Business/Operations` | 9 file moves |
| 3 | `restructure: 11_OpsMan_LFCS — move CLAUDE/README/_Log/Agent-Stack-MOC into _Brain` | 4 file moves |
| 4 | `restructure: 12_SiteOps — move CLAUDE/README/_Log into _Brain` | 3 file moves |
| 5 | `restructure: 20_Personal + 30_Goals — move CLAUDE into _Brain` | 2 file moves |
| 6 | `restructure: move Claude-Code-Automation-Guide to 90_Reference; fix Kill-Flyio-Plan backlink` | 1 cross-project move + 1 frontmatter fix |
| 7 | `restructure: add new system stubs (TeamProtocol, Conflicts, CuratorLog, _System/AgentLog/)` | 3 new files + 1 new dir |

Total file moves: 19. Total new dirs: 21. Total stub files: 3. Total frontmatter fixes: 1.

## 5. What this plan does NOT do (explicitly out of scope)

Per the prompt's "What NOT to do":
- Does **not** write content for `TeamProtocol.md` — empty stub only.
- Does **not** edit `_System/CLAUDE.md` to mention new structure.
- Does **not** add MOC link lists to READMEs.
- Does **not** curate, tidy, or backfill frontmatter.
- Does **not** delete anything — only moves and renames.

## Phase 1 complete. Awaiting approval.

Reply with one of:
- **"Approved, proceed."** — I'll do the pre-flight commit then run Phase 3 chunks 1-7.
- **"Approved with changes: [list]"** — I'll edit this plan, then proceed.
- **"Stop, let's reconsider [item]"** — I halt and we discuss.

Specifically open questions for you:
- Q1: ROADMAP.md — keep at project root, or move into `_Brain/`?
- Q2: Agent-Stack-MOC.md — `_Brain/` or `Operations/`?
- Q3: COO-TO-HQ + HQ-TO-COO — `_AgentLog/` (preserve history) or `_Archive/` (historical/dead)?
- Q4 confirmed by default: Claude-Code-Automation-Guide.md → `90_Reference/`. Tell me if you disagree.
- Pre-flight: do you want me to commit the existing uncommitted vault rebuild before Phase 3, or do you want to do that yourself first?