Home / Council and Characters / Characters and Visual Identity

Oracle Discovery & Journey System (v1) - the living spec

Updated Jul 11, 2026 · Affirmology_OracleDiscovery_Journey_System_v1.md

Oracle Discovery & Journey System (v1) - the living spec

Written 2026-07-11 by the CODE chat, consolidating Jeff's rapid-fire direction (2026-07-11) so the vision lives in one place, not scattered across chat. Extends Affirmology_OracleDiscovery_Profile_History_Proposal_v1.md (the approved A/B/C spec) with the gamified deep-inquiry + sequenced-journey layer Jeff added.

The through-line

The oracle chat is the one main feature AND the data flywheel. Every conversation should make the person feel known AND make their audios better. We win by owning CONTEXT (their life, not just their chart) plus the neuroscience/transformation toolkit. Beyond passive Q&A, the guide actively discovers, remembers, and gradually opens deeper self-inquiry as the person earns/wants it.

What is LIVE now (verified in code 2026-07-11)

• Active discovery behavior (light, value-first, one gentle question) - system-prompt level.
• Injects the person's known learned-info so it never re-asks.
• Persists the transcript server-side; the app reopens the last session.
• Warm consent copy ("your guide is getting to know you").
• Proactive chart + timely-sky conversation starters.
• B (conversation -> profile write-back): SHIPPED 2026-07-11 (api/oracle_distill.py, commit 73f81ce). Every few turns a cheap Haiku pass folds durable facts the guide learned into a marked block at the TOP of the person's Understanding (the slice the oracle already reads), so future audios
• chats inherit it. Append/merge only, never touches the chart. This is the flywheel's write-back half.

Still PLAN (prioritized)

1. Model tiering (cost): Haiku for casual chat + distillation (distillation already uses Haiku), council/Sonnet ONLY for real chart/reading questions. Today every chat message uses Sonnet.
2. Deep discovery exercises (Jeff, 7/11): a prepared LIBRARY of deeper self-awareness inquiry exercises the oracle can deploy on occasion. Two jobs: (a) get context we NEED for certain audios/tasks (IFS parts-work especially), (b) delight users who want a deeper self-awareness inquiry. Framed to the user as GAMIFIED curiosity/interest ("unlock a path"), the way many apps advertise. Each exercise = a named, structured prompt sequence with a purpose + what it profiles.
3. Sequencing / unlock journeys (Jeff, 7/11): the deep inquiries are SEQUENCED. People unlock certain exploratory paths/journeys, then they must get profiled deeper to progress, which unlocks the next. So: light discovery -> earns/opens a journey -> deeper profiling exercise -> unlocks the next path. Gate deeper exercises on readiness + prior context, not all at once.
4. Dynamic discovery dial: today the dial is a global env setting (ORACLE_DISCOVERY, default light); make it escalate to "active" when a person opens a clarity thread or enters a journey, and A/B-instrument it from logs.
5. History browse UI: app reopens the LAST session only; add a multi-session scrollback/archive.

CORPUS RESEARCH DIRECTION (Jeff, 7/11: "our corpus search should research these")

Mine the extended traditions + modern practice for inquiry METHODS, then make them ours: - IFS / parts work (Dick Schwartz lineage) - protector/exile/Self dialogue prompts. (Young for IFS depth per Jeff.) - Depth psychology / archetypes (Jung, active imagination), shadow work prompts. - Enneagram-based self-inquiry (Gurdjieff lineage - Jeff flagged its usefulness). - Journaling practice / guided prompts (Mindset Ninja Sol can help author these). - Gamified self-discovery patterns that consumer apps advertise (how they hook + sequence). Goal: distill into OUR uniqueness - short, chart-aware, multi-purpose inquiry exercises that both profile the person and feel like a game of self-curiosity. Feed the overnight corpus researcher these as backlog topics; keep tier-walled (A/B sources only).

HOW THE PIECES FIT

Discovery dial (how forward) -> deep-inquiry exercise library (what to ask, sequenced/unlockable) -> distillation write-back B (store what's learned) -> better audios + a guide that remembers. The corpus research feeds the exercise library its craft. Presentation = gamified "unlock your next path."

OPEN QUESTIONS FOR JEFF

• Journey taxonomy: what are the first 3-5 named exploratory paths (e.g. "Meet Your Protectors" (IFS), "Your Shadow Gift", "What You Actually Want")? Which unlocks first?
• Unlock mechanic: time-based, engagement-based, or context-completeness-based gating?
• Who authors the exercises: council oracles (Young=IFS, Sol=journaling), or a new "inquiry" oracle?

EDUCATION AS A SECONDARY PATH (Jeff, 2026-07-11) - future

Main lane is unchanged: audios with context, habit-forming, different uses through the day. But add an optional teaching layer for the systems, so the curious can learn: - Human Design: a visual of their bodygraph with open vs defined (closed) energy centers to help them understand themselves. This is a real visual asset (their own chart rendered as a bodygraph). - Other visuals likely useful too (chart wheels, Gene Keys sequences, etc.). - Education is a SECONDARY path (opt-in / unlockable), never the front door. It supports the audios, it does not replace them. Ties into the gamified unlock-journey idea above: learning a system can be one of the exploratory paths a person unlocks.