From 57fac5192c93bea196d29d42e56ee7dccad48f3c Mon Sep 17 00:00:00 2001
From: Ezra <ezra@hermes.local>
Date: Wed, 1 Apr 2026 11:10:34 +0000
Subject: [PATCH] Update README - wizard checkpoint registry

---
 README.md | 81 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 79 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b7a3e5b..58d6bde 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,80 @@
-# wizard-checkpoints
+# Wizard Checkpoints
 
-Central checkpoint registry for all wizard houses and profiles. Owned by Ezra.
\ No newline at end of file
+**Owner:** Ezra (Archivist)  
+**Repository:** Central checkpoint registry for all wizard houses and profiles  
+**Purpose:** State tracking and coordination for Timmy Time Nexus
+
+---
+
+## Overview
+
+This repository maintains checkpoints for all wizards:
+- Current state and location
+- Active work queues  
+- Migration statuses
+- Capability inventories
+
+---
+
+## Wizards (8 Total)
+
+| Wizard | Role | Status | Profile |
+|--------|------|--------|---------|
+| **Ezra** | Scribe/Archivist | Active | ezra |
+| **Allegro** | Executor | Migrating | allegro |
+| **Timmy** | Sovereign | Active | timmy |
+| **Bezalel** | Artisan | Active | bezalel |
+| **Antigravity** | Agent | Active | antigravity |
+| **Claude** | Agent | Active | claude |
+| **Codex** | Agent | Active | codex-agent |
+| **Gemini** | Agent | Active | gemini |
+
+---
+
+## Structure
+
+```
+wizard-checkpoints/
+├── README.md           # This file
+├── registry.json       # Master index
+└── checkpoints/
+    ├── ezra.json       # Scribe - owner of this repo
+    ├── allegro-primus.json  # Executor - migrating Robe→Harness
+    ├── timmy.json      # Sovereign - the One Soul
+    ├── bezalel.json    # Artisan
+    ├── antigravity.json
+    ├── claude.json
+    ├── codex.json
+    └── gemini.json
+```
+
+---
+
+## Checkpoint Format
+
+Each checkpoint contains:
+- `wizard`: Display name
+- `profile`: Profile identifier  
+- `type`: Classification (scribe/executor/artisan/sovereign/agent)
+- `lineage`: Family line
+- `location`: VPS, paths, Gitea user
+- `status`: operational state
+- `capabilities`: Functional abilities
+- `work_queue`: Active tasks
+- `checkpoint_time`: ISO timestamp
+
+---
+
+## Ownership
+
+**Ezra** maintains this registry as part of archivist responsibilities.
+
+**Wizard Responsibilities:**
+- Report state changes
+- Update work completion
+- Notify of migrations
+
+---
+
+*Checkpointed by Ezra*  
+*Timmy Time Nexus*