Home / Start Here / Orientation and Onboarding

Affirmology System Interface Guide v1

Updated Jun 16, 2026 · Affirmology_SystemInterface_Guide_v1.md

Affirmology System Interface Guide v1

How any chat or agent plugs into our system: the map, the per-person report index, how to run the engine, and a capsule to paste into outside chats.

First, know which kind of chat you are

• INSIDE the system: a Cowork session opened in the AFFIRMOLOGY folder, or a Claude Code session in the repo. You have file access and a shell. You can read every doc and RUN the agents. Start by reading Affirmology_PROJECT_STATE.md and this guide (CLAUDE.md points you here automatically).
• OUTSIDE the system: a plain claude.ai chat or another tool with no access to this folder (the Destiny Suite chat is one). You cannot see our files or run the engine. You are for thinking and writing. Paste the Bootstrap Capsule below to orient, and paste in any specific report you need (for example Jeff's Gene Keys profile).

The Bootstrap Capsule (paste this at the top of any OUTSIDE chat)

You are helping with Affirmology. Affirmology turns a person's cosmic blueprint (astrology, Human Design, Gene Keys, numerology) into hyper-personalized, first-person affirmation audio called Sacred Audio, framed as a software update for the Subconscious Operating System. Hard rules: no em dashes anywhere; first person, present tense, spoken aloud; recognition over instruction; content comes only from the person's own chart; keep the "Subconscious Operating System" frame; Sol is "Sol" or "Soledad," never "Soul"; never name a specific meditation teacher (say "heart coherence breath" or "embodied gratitude induction"). The real engine, agents, charts, and reports live in Jeff's AFFIRMOLOGY workspace and run inside Cowork or Claude Code, not here. You do not have access to them in this chat. You are for drafting scripts and ideas. If you need exact chart detail, ask me to paste the specific report. The four core charts: Jeff Parker Love (Sep 11 1982, 4:19pm, Anderson SC: Virgo Sun, Cancer Moon, Capricorn Rising, Manifesting Generator, Life Path 22). Sol Ballard (Jan 23 1986, 10:28am, El Paso TX: Aquarius Sun, Cancer Moon, Aries Rising, Generator 2/4, Emotional authority, Life Path 3). Colin Jacobs (Apr 17 1976, 2:30pm, Boston MA: Aries Sun, Virgo Rising, Birthday 8). Josh Parini (Oct 21 1985, 6:00am, San Jose Costa Rica: Generator 2/4, Sacral). Openings matter: never open with "close your eyes / take a deep breath / welcome" or by reciting placements. Use a specific sensory drop-in line, meet the real state, set the posture, then turn into the chart so the placement is felt, not announced.

Where everything lives (the map)

• Source of truth: Affirmology_PROJECT_STATE.md. Read first, always. It overrides older notes.
• The engine (Python): affirmology-agent/. Chart math in src/affirmology/chart/ (astrology, human_design, gene_keys, numerology, geocode, astrocartography). Script generation in src/affirmology/agents/script_generator.py. Voice, mix, PDF, build report in agents/. Corpus pipeline in src/affirmology/corpus/. CLI entry: python -m affirmology.cli.
• The Studio (web app): affirmology-studio/ (api/ FastAPI, web/ front-end, api/structures.py the named structure templates). Approved design: CLAUDE OUTPUTS/Affirmology/Affirmology_StudioUI_v3.html. Build brief: Affirmology_StudioBuildBrief_v1.md. Deploy: Affirmology_StudioDeploy_Runbook_v1.md.
• The agents roster and visual map: Affirmology_AgentRegistry_v1.md, Affirmology_AgentPipelineMap_v1.svg.
• The corpus: SQLite DB at /Volumes/Affirmology/corpus/corpus.db (env AFFIRMOLOGY_CORPUS_DB), ~12,900 records, 6 traditions, tier-walled A/B. Status: Affirmology_CorpusStatus_2026-06-13_v1.md.
• Craft references: Affirmology_ScriptStyle_Reference_v1.md, Affirmology_AudioOpenings_Framework_v1.md, Affirmology_BeforeBed_AudioStructure_v1.md, Affirmology_TechniquesLibrary_v1.md.

Per-person reports (the index Jeff could not find)

• Jeff Parker Love: Affirmology_GeneKeysProfile_v1.md, Affirmology_HumanDesignProfile_v1.md, Affirmology_AstrologyChart_v1.md, Affirmology_NumerologyProfile_v1.md (the unnamed profile docs are Jeff's). Birth data also in affirmology-agent/src/affirmology/verification/known_charts.py.
• Josh Parini: Affirmology_JoshParini_GeneKeysProfile_v1.md, Affirmology_JoshParini_HumanDesignProfile_v1.md, Affirmology_JoshParini_SacredAudio_v1.pdf, scripts Affirmology_JoshParini_Script_v1/v2.md. Birth data also in known_charts.py.
• Sol Ballard and Colin Jacobs: full chart payloads, facts files, and a finished render live in affirmology-agent/out/soledad_ballard_demo_2026-05-29/ and affirmology-agent/out/colin_demo_2026-05-29/ (see each backend/chart.json and the *_facts.md files). Confirmed birth data is in PROJECT_STATE section 7.
• To regenerate any person's full chart fresh, run the engine (below).

How to actually run the agents (inside the system only)

• Compute a chart / full render: python -m affirmology.cli --name "<Name>" --date YYYY-MM-DD --time HH:MM --location "<City, ST>" with --script (cheap, script only) or --audio (spends ElevenLabs, QC-gated at --speed 1.0). Add --concept "<structure directive>" and --build-report.
• Studio API: GET /api/structures, POST /api/script, POST /api/audio/{job_id}, GET /api/jobs, GET /api/health.
• Corpus: python -m affirmology.corpus.run --data-dir /Volumes/Affirmology/corpus ....
• Running happens in a Cowork session in this folder or a Claude Code session in the repo. A plain web chat cannot run these; it works from pasted context.

The rule for starting any chat

• Inside the system: read PROJECT_STATE and this guide first (CLAUDE.md enforces this).
• Outside the system: paste the Bootstrap Capsule, then paste any specific report you need. Iterate. The gaps close by working between human and computer, chat after chat.