Home / Engine / Agents and Council Architecture
Updated Jun 16, 2026 · Affirmology_InsightAgents_Design_v1.md
The analysis layer that decides WHAT to say and WHEN, not just how to say it.
Today the system computes a chart and the generator writes from it. Nothing studies the blueprint for a person's real potentials, and nothing meets the current moment (transits). So an audio is accurate but not always the most useful thing for that person right now. These agents add the missing analysis layer: they read the blueprint and the timing, decide what matters most, and point the generator at it.
Studies one person's full chart across all four systems and surfaces: - Convergences: where astrology, Human Design, Gene Keys, and numerology all point the same way (the strongest, most reliable themes). - Productive tensions: where the systems pull against each other (the growth edges). - Latent potentials and signature gifts: what makes this person uniquely them. Output: a ranked "what matters most for this person" brief plus suggested audio angles. This is the "tell me what makes me uniquely me" agent. It feeds the build report and opens the Studio composer already knowing the person's strongest threads.
Computes current transits (Swiss Ephemeris for today against the natal chart), plus the numerology personal year/month and any Human Design timing, and identifies what is being activated NOW: what is ripe, what is challenged, what window is open. Grounds the read in the transits corpus (already ~2,500 records). Output: a "this season for you" read that lets an audio meet the present moment, and a reason to return as the sky shifts. Powers a transit-aware, recurring audio type.
Combines the blueprint insight and the timing into concrete POTENTIALS: a launch window, a relational opening, a creative surge, a needed rest. Then recommends which audio (category and structure) best serves that potential right now, and why. This is the "better to know what to do with the information" piece: it turns analysis into a clear next audio.
As the customer base grows, studies patterns ACROSS many people's blueprints plus their comfort votes and feedback: which placements respond to which structures, what is landing, which chart signatures love which audio types. Feeds the leaderboard and the idea/variant agents. Needs data volume, so scaffold now and sharpen as audios accumulate.
Scans collective transits (big outer-planet movements, eclipse and retrograde seasons) and cultural wellness trends, and proposes timely, broadly relevant audio themes for everyone (an eclipse-season grounding, a retrograde wind-down), tied to real astrology rather than hype.
Birth data, then chart engines, then the ANALYSIS LAYER (Insight + Transit + Potentials), then structure choice, then the script generator, then audio. The analysis layer sits between the chart and the generator, and is also surfaced in the Studio: the composer opens with the person's insight brief, and categories can be recommended by the potentials agent.
Potentials and timing are reflective, motivational framings, never predictions, guarantees, or fatalism, and never medical or financial advice. Everything stays chart-driven and tier-walled: content comes from the person's own chart plus the A/B corpus.