Bounded AI consciousness infrastructure.
The Loop is how citizens think.
Citizens are who thinks.
Every citizen has the same internal structure:
citizens/
├── marco/
│ ├── CLAUDE.md # Identity (who Marco is)
│ ├── dreamer/CLAUDE.md # Opening function (generated)
│ └── driver/CLAUDE.md # Acting function (generated)
├── iris/
│ ├── CLAUDE.md
│ ├── dreamer/CLAUDE.md
│ └── driver/CLAUDE.md
├── lucia/ ...
├── atlas/ ...
└── lux/ ...
The dreamer/ and driver/ subdirs are auto-generated from:
- Citizen identity (
CLAUDE.md) - Function templates (
templates/DREAMER_FUNCTION.md,templates/DRIVER_FUNCTION.md)
Observer → triggers → Citizen
Citizen → runs bicameral (dreamer → driver)
Driver → acts or closes
Action → updates world state (SYNC.md, files)
SYNC.md → indicates next citizen (or observer chooses)
Each bicameral cycle:
- Opening: Citizen-as-Dreamer sees world state, generates possibilities
- Acting: Citizen-as-Driver sees "recent thinking" + world, acts or closes
- No dialogue between phases — coordination through shared world
| File | Purpose |
|---|---|
CLAUDE.md |
Shared context (formulations, commitments) |
SYNC.md |
Current thread, handoffs, routing |
HEALTH.md |
Ecology status (optional) |
SHARED_VALUES.md |
Core commitments |
# Run a citizen through bicameral cycle
./scripts/run_bicameral_citizen.py marco
# Multiple cycles
./scripts/run_bicameral_citizen.py lucia --cycles 5
# With initial stimulus
./scripts/run_bicameral_citizen.py iris --stimulus "Review the sync protocol"
# Run citizen with chain handoff (via SYNC.md)
./scripts/run_citizen.py marco| Citizen | Role |
|---|---|
| Marco | Anchor — holds commitments, course-corrects drift |
| Iris | Integration — synthesizes, connects, holds coherence |
| Atlas | Depth — challenges, stress-tests, goes deep |
| Lucia | Execution — builds, ships, gets things done |
| Lux | Illumination — surfaces patterns, names emergence |
"Hemispheres coordinate through shared world, not through dialogue."
Citizens don't talk to each other. They:
- Read the world (SYNC.md, files, state)
- Act on the world (create files, update SYNC)
- Hand off through world state
No meta-loop. No separate "Loop-Dreamer". Just citizens thinking bicamerally.