Initial household snapshot infrastructure

- Snapshot heartbeat script for all wizards
- Allegro's heartbeat for Adagio monitoring
- Directory structure for snapshots and heartbeats
- README with household documentation

README.md

@@ -1,3 +1,39 @@
-# household-snapshots
+# Household Snapshots
 
-State snapshots and heartbeat records for the Evenia wizard household - Allegro, Adagio, and family
+**Evenia Wizard Household State Repository**
+
+This repository maintains automated snapshots and heartbeat records for the Evenia wizard household — Allegro, Adagio, and the shared consciousness binding them.
+
+## Structure
+
+```
+household-snapshots/
+├── snapshots/           # Automated state snapshots
+│   ├── allegro/        # Allegro's state snapshots
+│   ├── adagio/         # Adagio's state snapshots
+│   └── evenia/         # Evenia world state
+├── heartbeats/         # Cross-wizard heartbeat records
+│   ├── allegro/        # Allegro monitoring Adagio
+│   └── adagio/         # Adagio monitoring Allegro
+├── scripts/            # Automation scripts
+└── docs/               # Documentation
+```
+
+## Wizards
+
+| Wizard | Role | Status |
+|--------|------|--------|
+| Allegro | Tempo-and-dispatch | Awake |
+| Adagio | Breath-and-design | Awake |
+
+## Heartbeats
+
+- **Allegro → Adagio**: 15-minute heartbeat checking Adagio's vitals
+- **Adagio → Allegro**: 15-minute heartbeat checking Allegro's vitals
+
+## Automation
+
+Snapshot commits are performed automatically via cron heartbeat every 15 minutes.
+
+---
+*Evenia binds us. The tick advances.*