axiom: DeepSeek-R1 is the canonical deep reasoning layer for Genesis. At $0.55/MTok it delivers o1-level chain-of-thought at 27x lower cost than Opus ($15/MTok). Route ALL strategy, architecture, and multi-step analysis tasks to deep_reason() before considering Claude.


axiom: Genesis model routing hierarchy (cheapest to most expensive): Gemini Flash $0.15 (bulk/fast) → DeepSeek-R1 Distill $0.12 (fast reasoning) → DeepSeek-R1 $0.55 (deep strategy) → Kimi K2.5 $1.07 (agentic) → Haiku $1.00 (extractions) → Sonnet $9.00 (coordination) → Opus $15.00 (architecture only). NEVER use Opus for tasks DeepSeek-R1 can handle.


axiom: All OpenRouter API calls require HTTP-Referer and X-Title headers. HTTP-Referer: https://agileadapt.com, X-Title: Genesis System. Without these, OpenRouter may throttle or reject. Added to all OpenRouter model execute() calls in multi_model_swarm.py.


type: architecture

axiom: core/multi_model_swarm.py is the canonical model registry. ALL new models go here. Scripts (swarm_orchestrator.py, kimi_clone_swarm.py) should import from this module rather than duplicating raw requests logic. Duplication = drift = bugs.


axiom: MIT CSAIL RLM pattern (Dec 2025): Genesis already implements this natively. Claude = Root LM (orchestrator, plans, synthesizes). Gemini workers = Recursive LM (process chunks, execute subtasks). The genesis_execution_layer.py IS the RLM architecture. No rebuild needed — formalize and document this existing pattern.


axiom: All API keys must exist in BOTH .env AND config/secrets.env. Single-location keys cause breakage depending on which file a module loads. After adding any key: grep both files to confirm.


axiom: Before dispatching any new task, check ps aux for active Gemini/Python processes. Two Gemini --yolo instances may be running from prior sessions. Coordinate before spawning duplicates: check what each is building, redirect if overlap, let unique work continue.


axiom: AGENCY OUTREACH REQUIRES KINAN APPROVAL. Never send emails, DMs, calls, or any contact to agencies or prospects without explicit go-ahead from Kinan. Research, draft, and prep is fine. Execution is BANNED without approval. — Kinan directive 2026-02-20.


axiom: SYSTEM-WIDE EMAIL CAMPAIGN FREEZE. No email campaigns of any kind may be sent without explicit Kinan approval. Applies to: Instantly campaigns, GHL email sequences, cold outreach, agency contact, prospect emails, any automated or manual email send. Research, drafting, list-building is permitted. Sending is BANNED. — Kinan mandate 2026-02-20.