Skip to content

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 .md file 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.