ukubona/
│
├── roots/ # 🥾 Problems and APIs
│ ├── vendors/ # Apple, WhatsApp, Instagram, etc.
│ ├── raw_csv/ # LoseIt, HealthKit, Strava, Ukuzula Walking-Seminars, etc.
│ └── ingestion.py # Convert raw input to structured data
│
├── trunk/ # 🌲 Foundational Infrastructure
│ ├── agents/ # Agent registry and types
│ ├── parameters/ # Initial conditions, distributions
│ ├── simulation.py # Main simulation loop
│ └── settings.yaml # Master config: tick rate, toggles
│
├── fork/ # 🍴 Hamlet vs. Fortinbras (Binary Split)
│ ├── hamlet/ # HamletGPT: reflect, hesitate, recursive
│ ├── fortinbras/ # FortinbrasGPT: act, crash, simplify
│ └── toggle_logic.py # Switching rules, agent assignment
│
├── branches/ # 🌿 Recursion and Emergence
│ ├── hierarchy/ # Agent tree (cell → planet)
│ ├── collisions/ # Interaction logic (child w/ virus, dog tugs leash, etc.)
│ ├── update/ # Parameter propagation / death / birth
│ ├── vcv_matrix/ # Variance-Covariance structures per scale
│ └── memory_logs/ # Transcripts, decisions, emotional data
│
├── canopy/ # 🌞 Observability / Theology / UX layer
│ ├── observables/ # Data summaries, outputs
│ ├── reflections/ # GPT-generated insights
│ ├── theology/ # YAML, metaphysical config
│ └── dashboard/ # Export layer (when ready, not now)
│
└── README.md # Philosophy + Simulation Guide