Cross-Evolution
Purpose
Maintain a high evolutionary standard across all agent skills by identifying "Genes" (best practices), transferring them to skills that lack these features, and discovering new high-value genes from existing skills.
Axioms
1. Atomic Independence (No Cross-Skill Glue)
Skills and their scripts must be 'atomic'.
- 'FORBIDDEN': Any logic inside a skill's script that explicitly checks for or calls tools from another skill.
- 'The Agent is the Glue': Only the AI Agent is responsible for coordination.
2. Pragmatic Evolution (Occam's Razor)
- 'Just-In-Time Transfer': A gene is transferred only when it solves a recurring problem.
- 'KISS Compliance': Avoid bloating skills with genes they don't need.
- 'Fitness-Driven': Prioritize genes with highest weight for maximum fitness gain.
3. Living Protocol
This skill proactively evolves itself and its gene registry upon discovering new constraints.
Core Concepts
Gene
A modular implementation or documentation pattern that improves skill quality. Genes have a 'lifecycle': Proposed → Active → Deprecated → Extinct. Full registry with weights, detection rules, and conflicts: docs/genes.md
Horizontal Gene Transfer (HGT)
Copying a gene from a donor skill to a recipient without rewriting the recipient's core purpose.
Gene Discovery
Scanning existing skills for repeated high-value patterns not yet represented in the registry. If a candidate passes thresholds, it is automatically written into docs/genes.md under "Proposed Genes".
Genetic Drift
Genes carried by zero skills are candidates for deprecation. After sustained non-adoption, they go extinct.
Fitness
Quantitative health score per skill: earned_weight / applicable_weight × 100%. Domain-specific genes (recommend=none) only count if already present — reward, not penalty.
Recombination
When two genes conflict in the same skill, selective pressure creates a new hybrid gene.
Operating Modes
Mode 1: Scan & Audit
'Automated': bash "${SKILL_DIR}/scripts/audit-genes"
Produces: Gene × Skill matrix, fitness scores, genetic drift warnings, conflict alerts, recommendations, and discovered gene candidates (with registry sync).
Useful flags:
--no-discovery— skip discovery phase.--no-sync-discovery— discover candidates without writing to registry.
Mode 2: Mutation (Update)
Inject missing/extra genes into a target skill. Prioritize by weight × fitness impact.
'Value guard': Before transferring a gene, ask: "Does this gene solve a real problem the skill has encountered, or are we just making the fitness number go up?" If the latter — skip the transfer. Fitness score is a heuristic, not a goal. Optimizing the score instead of skill quality is the Farmville trap.
Mode 3: Speciation (Creation)
Create a new gene/skill by combining existing patterns (triggered by gene conflicts or recombination).