/DECK 04 · VAULT ARCHITECTURE
RAW · WIKI · SCHEMA

One brain. Three layers. A vault that stays alive.

A version-controlled Second Brain for the whole company — built on the Karpathy LLM-wiki pattern. Raw sources compile into a structured wiki, governed by a schema. Claude reads it, writes to it, keeps it alive.

3layersKarpathy pattern
1vaultWhole company
24/7Always on agents
0lossVersion controlled
Vault architecture · Karpathy LLM wiki pattern
01 / 12 · next
/01 · WHY A VAULT
/THE PROBLEM WE SOLVE

Knowledge in heads and chat threads doesn't compound.

01 · VERSIONED

Git-tracked

Every change auditable. No "who edited this?" mysteries.

02 · INTERLINKED

Wikilink graph

Concepts connect. The graph is the product — not the files.

03 · AGENTIC

Claude is the runtime

Reads schema, executes commands, compiles raw into wiki, lints the whole.

The vault is the operating system. The behaviour rules are the kernel. Claude is the shell.

Pattern: Karpathy three-layer LLM wiki
02 / 12
/02 · THE STACK

Raw → Wiki → Schema.

Three layers, each with a distinct job. Raw is immutable ground truth. Wiki is compiled, structured, interlinked. Schema is the rule-book that governs both.

LAYER 01

Raw Sources

00-Inbox/raw/

Articles, PDFs, transcripts, web clips. Immutable after capture. The ground truth every compiled note traces back to.

LAYER 02

Wiki

05-Galaxy/ · 03-Resources/

Atomic Galaxy notes — one idea, ≤300 words, ≥1 wikilink. Plus playbooks, templates, brand, skills.

LAYER 03

Schema

CLAUDE.md · program.md

The rules. Routing, behaviour, priorities, commands. Every session reads this first.

Raw compiles into Wiki. Schema governs the compile. Claude is the runtime.
03 / 12
/03 · FOLDER TREE

IPARAG + Client Spaces.

00

00-Inbox

Capture lands here. Raw sources in raw/ (immutable).

01

01-Projects/Active

Time-bound work with a finish line.

02

02-Areas

Ongoing responsibilities — Ads, Analytics, Sales, Amplio-Internal.

03

03-Resources

Brand/ · Playbooks/ · Templates/ · Research/ · Skills/

04

04-Archives

Completed projects. Retired notes.

05

05-Galaxy

Zettelkasten — atomic concept notes, wikilinked, one idea each.

06

06-Clients

Per-client spaces + _Prospects/ pipeline.

ROOT

CLAUDE.md · memory.md

Schema + session continuity at the root. Loaded every session.

Every top-level folder has a single purpose. Every file lives in one place.
04 / 12
/04 · ROUTING

Every input has one home.

  • Unsorted thought00-Inbox/Brain-Dump.md
  • Article / PDF / transcript00-Inbox/raw/ (never edit)
  • Work with a deadline01-Projects/Active/
  • Ongoing responsibility02-Areas/
  • Playbook / template / SOP03-Resources/
  • Atomic concept05-Galaxy/
  • Client work06-Clients/[name]/
  • Amplio-own work02-Areas/Amplio-Internal/

Amplio is never saved under 06-Clients/. Amplio is not a client. Routing rule, non-negotiable.

Raw immutable. Deadlines become projects. Concepts go to Galaxy.
05 / 12
/05 · HUB GRAPH

Seven hubs. No orphans.

Every note links to at least one hub. Hubs are the spine — indexes of indexes. That makes the wikilink graph navigable, not just a pile of files.

SPINE

[[memory]]

Session continuity. Read first, written last.

CONCEPTS

[[_Galaxy-Index]]

Atomic notes. The wiki proper.

SKILLS

[[_Skills-Index]]

Claude skills, callable on demand.

SOPs

[[_Playbooks-Index]]

Playbooks and how-tos.

CLIENTS

[[_Client-Index]]

Every client space, indexed.

PROSPECTS

[[_Pipeline-Dashboard]]

Scored leads, stages, next actions.

RETIRED

[[_Archives-Index]]

Notes retired from the active graph.

Rule 07 · Every note ships with a Related section → ≥1 hub wikilink
06 / 12
/06 · CLIENT SPACES

One space per client. One hub per space.

/STRUCTURE

06-Clients/[name]/

  • _overview.md — per-client hub: status, contacts, signals, health
  • data-context.md — connected sources, schemas, metrics
  • recommendations-tracker.md — closed-loop log of advice given
  • meeting-notes/ — dated per-meeting notes
  • reports/ — monthly + ad-hoc deliverables
/CONVENTIONS

Scaffolded from template

  • Kebab-case filenames across the board
  • YAML frontmatter: title, created, updated, tags, status, type
  • Summary line immediately after frontmatter
  • Every note ends with a ## Related section
  • _Prospects/ holds pre-client pipeline entries

Active today: 7 client spaces (direct + agency partner) — Certify Education · Odisei · Code & Wander · Birdie · The Lily Effect · Cropple · Rapid Agency. End clients contracted via an agency partner (Malone, Devenish, Alternative Energy) live under Rapid Agency, not as separate Amplio clients.

06-Clients/[name]/_overview.md is the per-client hub — always update it first.
07 / 12
/07 · SCHEDULED TASKS

A 10-task fleet keeps the vault alive.

MON 07:30

weekly-executive-briefing

Weekly exec readout.

DAILY 08:00

daily-client-data-pull

Pulls yesterday + 28d trailing.

DAILY 08:30

daily-access-tracker-sweep

Confirms API access across clients.

4x DAILY

employee-update-email-sync

Triages update_ emails.

DAILY 09:00

vault-autoresearch

7-phase compile · lint · enrich.

4x DAILY

daragh-update-email-sync

Partner-specific sync.

1st OF MO

certify-education-monthly-ads-report

Client monthly report.

DAILY 10:00

daily-client-learning-sync

Signals · health · 1a→1d measurement.

WED 10:30

certify-ads-experimentation

Experiment-planning pass.

DAILY 11:00

sync-scheduled-tasks-export

Keeps the portable fleet pack in sync.

Canonical prompts live in 02-Areas/Amplio-Internal/ai-tooling/scheduled-tasks/
08 / 12
/08 · AUTORESEARCH LOOP

Compile. Lint. Enrich. On repeat.

The vault is live. Raw sources compile into Galaxy notes. Broken links and stale content get linted. Thin notes get enriched. A health score decides when to run again.

PHASE 01
Context
PHASE 02
Compile raw
PHASE 03
Score & fix
PHASE 04
Inbox routing
PHASE 05+
Structural · Learning · Wrap
/RUNS
  • Daily at 09:00 CEST, cron 0 9 * * *
  • Rule 16 — orphan script runs Phase 3, target 0/0/0
  • Learning-lint confirms every active client has Health + Signals + tracker
/STATE TODAY
  • 198 active files · 0 orphans · 0 no-inbound · 0 no-outbound
  • ~50 Galaxy notes, 22 playbooks, 8 templates, 55 skills
  • Health score 95 / 100 — Excellent band, stable
See [[vault-autoresearch-playbook]] for the full loop
09 / 12
/09 · BEHAVIOUR RULES

Eighteen non-negotiables govern every session.

01 · 02 · 03

Vault-first · Load on demand · Verified metrics only

Search the vault before advising. Never recite from memory. Only cite the proof points in CLAUDE.md.

04 · 05 · 06

Cross-link · Keep it alive · Ask before assuming

Clients link to Galaxy, Galaxy links back. Every session leaves it richer. Clarify ambiguous commands.

07 · 16

No orphans

Every note has a Related section with ≥1 hub wikilink. Autoresearch hits 0/0/0 every run.

08 · 17

update_ emails sync + log

Amplio Updates emails rewrite overview, pipeline, index. Every triage decision logged for classifier training.

09 · 10 · 11

Close the loop · Signals · Test patterns

Recommendations tracked. Signals extracted. Contradictions downgrade pattern confidence.

12 · 13

Health · Data context

Every active client scored. Every active client has a data-context.md — API or manual.

14 · 15

Dashboard read-only · No sensitive data

The Vault Dashboard never writes. No revenue, tax IDs, contacts, scores, contracts or raw notes leave the vault.

18

Humanise outbound writing

Emails, posts, proposals, reports — always pass through the humanize-writing skill before shipping.

Full canonical list in CLAUDE.md § 6
10 / 12
/10 · THE VAULT DASHBOARD
/THE READ INTERFACE

One page. Same numbers. Refreshed twice a day.

Before the dashboard, "where are we with Odisei?" meant opening Obsidian, clicking through four folders, doing mental math. Now everyone reads the same snapshot without asking each other.

/WHAT IT SHOWS
  • Recurring revenue — MRR across active retainers
  • Client health — score, band, latest note · lowest first
  • Recommendation loop — open vs actioned per client
  • Active projects — P0 / P1 / P2, overdue flagged
  • Pipeline top 20 — tiered HIGH / MID / LOW
/HOW TO USE IT
  • Morning: open the dashboard before anything else
  • Scan health band < 70 → flag the client
  • Recommendations stuck? → update_ email with next action
  • Numbers look wrong? → submit the feedback form
/HOSTING · RULE #20
  • Worker: amplio-vault-dashboard
  • URL: ops.ampliodata.io (fallback amplio-vault-dashboard.round-star-123d.workers.dev)
  • KV namespace: dd432f3c01cf42af871b5f8d18892a5b
  • Access: hello@, alana@, daragh@, jule@ via One-Time PIN (24h session)
  • Refresh: daily-vault-dashboard-refresh · 08:15 + 17:15 local
/REGENERATE ON DEMAND
  • From 01-Projects/Active/Internal/vault-dashboard/
  • python3 generate.py && ./deploy-check.sh && ./deploy.sh
/FEEDBACK · TEACH THE VAULT
  • forms.gle/Bcs52Zjd7qsyuJuv8 — one atomic signal per submission
  • Correction · Gap · Confusion · Contradiction · Example
  • Submissions flow back into vault lint + autoresearch

The boundary. Dashboard is read-only. Writes flow only through update_ emails. Feedback on what the dashboard shows flows through the form. Nothing crosses the line.

01-Projects/Active/Internal/vault-dashboard/ · DEPLOY.md for rotation
11 / 12
/11 · NEXT
/KEEP IT ALIVE

Every session should leave the vault richer than it started.

ACTIVE FILES
198
0 orphans · 0 no-inbound · 0 no-outbound
HEALTH SCORE
95
Excellent band, stable
FLEET
10
Scheduled tasks touching the vault
READ CLAUDE.md § 2 ROUTER START WITH memory.md CAPTURE INTO 00-Inbox/Brain-Dump.md
Back to the Onboarding Suite · index.html
12 / 12