System Map: Start Here¶
The shared brain for Justin's fleet. Model-agnostic, any AI agent reads this. (This directory was named nexus/ until 2026-04-28; renamed to system-map/ in Pure Phoenix Phase 2.4.)
Files¶
| File | Purpose |
|---|---|
| fleet.md | All machines, names, IPs, roles |
| architecture.md | System topology and service layout |
| steering.md | Routing rules, what agent/machine handles what |
Agent Wrappers¶
Each AI has its own "driver" that references this brain:
- forge/FORGE-DOCTRINE.md: immutable behavioral guide (LLM execution rules, naming taxonomy, variable conventions, self-iteration protocol)
- forge/CLAUDE.md: Claude Code's auto-loaded operational pointer (commands, session startup, security rules)
- ~/.claude/projects/-home-justinwieb-forge/memory/MEMORY.md: auto-loaded memory index
Add new agents by creating their own wrapper that imports/references system-map/ and FORGE-DOCTRINE.md.
Memory System¶
All agents follow this convention. The spec lives here, wrappers enforce it.
Structure¶
forge/memory/
├── daily/ ← per-session logs, one file per day, append-only
│ └── YYYY-MM-DD.md
└── general/ ← long-term topical knowledge, edit freely
├── README.md
└── [topic].md
Signatures¶
Every entry must be signed. No unsigned entries.
| Signature | Who |
|---|---|
[Claude Code] |
Claude Code (CLI or VS Code extension) |
[Justin] |
Justin, written manually |
[Finn] |
Action taken on/by Finn (Proxmox server) |
[Console] |
Action taken on/by Console (dev VM, formerly UDev) |
[Vector] |
Action taken on/by Vector (Windows workstation) |
[Venus] |
Action initiated from Venus (iPhone) |
Daily Logs (memory/daily/YYYY-MM-DD.md)¶
- Append only, never rewrite history
- Format:
## [Signature] Topic - Auto-summary rule: Every 4–5 exchanges in a session, append a brief checkpoint:
## [Signature] Session Checkpoint — HH:MM
- What Justin was asking about
- What was built or decided
- What's in progress or next
General Memory (memory/general/)¶
- One
.mdfile per topic (e.g.projects.md,skills.md,infra.md) - Updated when something is definitively learned or decided
- Not a log, no timestamps, no append-only. Keep clean and current.
- Daily observations go in
daily/first, graduate here when stable.