---
created: 2026-03-12
tags: [architecture, operations, strategy]
related: ["Fleet Map (deprecated 2026-04-29)", "[[07-Command-Centre/Dashboard]]"]
---

# Operations Architecture

> How the three layers connect through this Obsidian vault.

---

## The Three Layers

```
┌─────────────────────────────────────────────────┐
│  LAYER 0: Michael (Human)                       │
│  Reads Obsidian · Makes decisions · Approves     │
└──────────────────────┬──────────────────────────┘
                       │
        ┌──────────────┼──────────────┐
        ▼              ▼              ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ COWORK       │ │ CC LOCAL     │ │ CC VPS       │
│ (Desktop)    │ │ (PowerShell) │ │ (VPS CLI)    │
│              │ │              │ │              │
│ Strategist   │ │ Bridge/Fixer │ │ Deployer     │
│ Chief of     │ │ Code changes │ │ VPS ops      │
│ Staff        │ │ Local fixes  │ │ Fleet maint  │
│              │ │              │ │              │
│ Reads/writes │ │ Reads/writes │ │ Reads/writes │
│ vault/ via   │ │ vault/ via   │ │ vault/ via   │
│ mounted dir  │ │ local path   │ │ git pull     │
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
       │                │                │
       └────────────────┼────────────────┘
                        ▼
              ┌──────────────────┐
              │  THIS VAULT      │
              │  (Single Source   │
              │   of Truth)      │
              └────────┬─────────┘
                       │
                       ▼
         ┌─────────────────────────┐
         │  VPS AGENT FLEET (x8)   │
         │  Rivet, Builder, Susan, │
         │  Harper, Sentinel,      │
         │  Radar, Herald, Cog     │
         │                         │
         │  Read fleet state from  │
         │  vault. Write status    │
         │  updates back.          │
         └─────────────────────────┘
```

---

## Role Definitions

### Cowork (Claude Desktop) — Strategist / Chief of Staff
- **Access:** Mounted folder at vault/
- **Reads:** Everything. Daily notes, fleet status, infrastructure, projects.
- **Writes:** Strategy docs, analysis, critical issues, dashboard updates, outbox
- **Owns:** [[07-Command-Centre/Dashboard]], [[07-Command-Centre/Critical Issues]], [[08-Infrastructure/Infrastructure Map]]
- **Doesn't do:** Code changes, VPS ops, direct fleet commands

### CC Local (Claude Code PowerShell) — Bridge / Fixer
- **Access:** Direct local path (C:\Users\mclou\rateright-growth-deploy\vault\)
- **Reads:** Tasks from vault, code issues, fleet bugs
- **Writes:** Code fixes, deployment notes, git commits
- **Owns:** Code changes, local testing, git push to sync vault to VPS
- **Bridge role:** Pushes vault changes to VPS via `git push`

### CC VPS (Claude Code VPS) — Deployer
- **Access:** `/home/ccuser/rateright-growth/vault/` (after git pull)
- **Reads:** Tasks from Rivet, vault updates from Cowork
- **Writes:** Fleet status, deployment logs, incident reports, daily notes
- **Owns:** VPS ops, fleet maintenance, deployment, systemd services
- **Launched by:** Rivet via `claude -p`

### Agent Fleet — Workers
- **Access:** Via Rivet/CC VPS (agents don't read vault directly yet)
- **Status feeds into:** Fleet Map (deprecated 2026-04-29), agent profiles
- **Output:** Goes through Council, Telegram, Growth Engine

---

## Sync Flow

```
Cowork writes to vault/
     ↓
Michael runs: git add . && git commit && git push   (or CC Local does it)
     ↓
VPS runs: git pull   (CC VPS or cron)
     ↓
Fleet sees updates via Rivet reading vault/
```

**Reverse flow:**
```
CC VPS writes to vault/ (daily notes, fleet status)
     ↓
VPS: git add . && git commit && git push
     ↓
Local: git pull   (Michael or CC Local)
     ↓
Cowork sees updates next session
```

---

## What Each Layer Should Read First

| Layer | First Read |
|---|---|
| Cowork | `vault/CLAUDE.md` → `vault/01-Daily/` (latest) → `vault/07-Command-Centre/Dashboard` |
| CC Local | `vault/CLAUDE.md` → `vault/01-Daily/` → check for tasks |
| CC VPS | `vault/CLAUDE.md` → `vault/01-Daily/` → `rivet/RIVET-TO-CCVPS.md` |