How-To Guide
Agents + Genome: The Full Picture
How ACE's 10 autonomous agents and the AI Genome Lab work together to create evolving AI intelligence
Two Systems, One Intelligence
Agents are the mind. Genomes are the personality.
Agentic Intelligence
10 agents that observe, reason, act, and reflect on your knowledge base. They do the work — finding contradictions, discovering patterns, maintaining quality.
Full reference →AI Genome Lab
8 behavioral traits that evolve through every interaction. The genome determines how agents work — their perception, reasoning style, and behavioral emphasis.
Full reference →The Evolution Loop
Agent Runs→Genome Evolves→Agent Improves→Next Run
Every agent run is expressed through the genome, evolving its traits. Over time, agents develop genuinely unique behavioral signatures.
How Each Agent Gets Its Genome
Agents are forked from the master genome with domain-specific biases
| Agent | Domain Hint | Hot Traits |
|---|---|---|
| Knowledge Guardian | knowledge_guardian | PRC ↑ REG ↑ |
| Risk Engine | risk_engine | RSN ↑ INT ↑ |
| Pattern Detector | pattern_detector | PRC ↑ INT ↑ |
| Quality Governor | quality_governor | REG ↑ EXP ↑ |
| Memory Consolidator | memory_consolidator | MEM ↑ INT ↑ |
| Graph Intelligence | graph_intelligence | INT ↑ RSN ↑ |
| Observer Learning | observer_learning | PRC ↑ MEM ↑ |
| Session Manager | session_manager | MEM ↑ EMP ↑ |
| Decision Recorder | decision_recorder | RSN ↑ REG ↑ |
| Graph Maintenance | none (no AI) | baseline |
1
Workflow: Train a Specific AgentAccelerate an agent's specialization through targeted evolution
# Step 1: Check agent's current genome state
ace_genome_state({ agent_name: "guardian" })
# Step 2: Train with domain-relevant text (20 generations)
ace_genome_evolve({
text: "Found contradiction: architecture doc says 'PostgreSQL only'
but decision #42 approves Redis for caching. Stale data in the
patterns collection — last updated 6 months ago. Knowledge graph
has 3 orphaned nodes with no relationships.",
agent_name: "guardian",
generations: 20
})
# Step 3: Verify traits shifted as expected
ace_genome_state({ agent_name: "guardian" })
# Expected: PRC ↑ (catches contradictions), REG ↑ (enforces rules)
# Step 4: The next time the Guardian runs, it uses
# its evolved genome for the observe/reason/act/reflect loop2
Workflow: Hive Mind ConsolidationLet specialist agents share their strongest traits with everyone
# After agents have run for a while (days/weeks):
ace_genome_consolidate()
# Example output: The Guardian's elevated PRC (1.7) exceeds
# master (1.1) by >30%. Consolidation transfers a conservative
# 10% boost: master PRC becomes 1.16.
#
# Now ALL agents benefit from the Guardian's heightened perception
# without losing their own specialization.When to consolidate: After agents have run at least 50+ cycles. Too early and there's not enough divergence to harvest. The consolidation only transfers genes that exceed master by 30%.
3
Workflow: Compare Agent GenomesVerify that agents are genuinely specializing
# Compare Guardian vs Risk Engine genomes
ace_genome_state({ agent_name: "guardian" })
ace_genome_state({ agent_name: "risk_engine" })
# Expected divergence:
# Guardian: PRC 1.7, REG 1.6, RSN 1.2 (perceives + regulates)
# Risk: RSN 1.8, INT 1.5, PRC 1.3 (reasons + integrates)
#
# Divergence proves genuine specialization, not random drift.
# Visual comparison available in Dashboard → Genome Lab
# Shows radar charts side by side for any two agentsThe Genome Lab dashboard has a comparison tool that overlays two agent radar charts. The Agent Command Center shows each agent's gene expression on their detail page.
4
Workflow: Deploy Trained Agents to New ProjectsTransfer evolved agent genomes to other namespaces or environments
# Export the Guardian's trained genome
ace_genome_export({ agent_name: "guardian" })
# → { dna: "eyJnZW5lcyI6...", fingerprint: "a1b2c3..." }
# Switch to a new namespace
ace_set_namespace({ namespace: "new-project" })
# Import the trained genome
ace_genome_import({
dna: "eyJnZW5lcyI6...",
fingerprint: "a1b2c3..."
})
# The new project now has a Guardian with 6 months of
# evolved perception — no training period needed.Architecture Overview
How agents, genomes, and your knowledge base connect
┌─────────────────────────────────────────────────────────┐
│ YOUR KNOWLEDGE BASE │
│ memories · decisions · issues · work logs · patterns │
└────────────────────┬────────────────────────────────────┘
│ observe
┌──────────┴──────────┐
│ 10 AUTONOMOUS │
│ AGENTS │
│ │
│ Guardian ←──── genome (PRC↑ REG↑)
│ Risk ←──── genome (RSN↑ INT↑)
│ Pattern ←──── genome (PRC↑ INT↑)
│ Quality ←──── genome (REG↑ EXP↑)
│ ...6 more │
└──────────┬──────────┘
│ act (create, update, link)
┌──────────┴──────────┐
│ AI GENOME LAB │
│ │
│ master genome │
│ ├─ guardian fork │
│ ├─ risk fork │
│ ├─ quality fork │
│ └─ ... │
│ │
│ consolidate ←──── hive mind
│ (specialists → master)
└─────────────────────┘