Auto Optimizer Tool

Overview

Self-optimization engine for the Gene Architecture. Analyzes agent performance from evaluation scores, computes aggregate statistics by template/gene type/cost tier, and auto-promotes versions meeting quality thresholds to production.

Available Operations

Analyze

• Analyze - Performance breakdown by template, gene type, and cost tier
• Returns aggregate scores with counts for each dimension

Promote

• Promote - Auto-promote best-performing versions to production
• Thresholds: >=10 evaluations, avg >= 4.0, 10% improvement, 5% regression check
• Supports dry-run mode for safe preview
• Logs promotion decisions to thoughts/architecture/

Report

• Report - Full optimization report with promotion candidates
• Shows each template's status, versions, eval count, and promotion eligibility

Genes

• Genes - Performance breakdown by gene type (gene, utility, soul) and cost tier
• Helps identify which gene categories perform best

Parameters

Parameter	Type	Required	Description
operation	string	Yes	One of: analyze, promote, report, genes
hours	number	No	Lookback window in hours (default: 168 = 7 days)
dryRun	boolean	No	Preview changes without applying (default: false)

Promotion Thresholds

• Minimum evaluations: 10
• Minimum average score: 4.0/5
• Must beat production by 10% improvement
• Must not regress any metric by 5%

Use Cases

• Automated agent version promotion
• Performance tracking across gene types
• Cost-tier optimization analysis
• Architecture decision logging