ce-optimize

Run controlled experiments against a measurement harness to optimize software variants.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/xbpk3t/ce-codex --skill ce-optimize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ce-optimize
Source: https://github.com/xbpk3t/ce-codex/tree/main/skills/ce-optimize
Command: npx skills add https://github.com/xbpk3t/ce-codex --skill ce-optimize

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Systematically explores code/config variants by coordinating measurable experiments, gating, and logging to identify the best performing solution.

Core Features & Use Cases

  • Define objective metrics (hard or judge) and optimization targets that align with product goals.
  • Run iterative batches with a stable baseline and a best-so-far record, including automatic hypothesis backlog generation and updates.
  • Use isolated worktrees and scaffolding to safely modify code and reproduce results, with a persistent experiment log and strategy digest for resume and analysis.
  • Automatically manage dependencies and prompt-based evaluation for judge mode, or deterministic measurements for hard metrics.

Quick Start

Provide a YAML optimization spec or describe the optimization goal to start the iterative loop.

Frequently Asked Questions about ce-optimize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run controlled experiments to optimize code variants?

To run controlled experiments for code optimization, provide a YAML optimization spec to automate metric-driven iterative batches against a repeatable measurement harness. The system subjects multiple plausible variants to common measurements and records durable results.

What is metric-driven iterative optimization for software projects?

Metric-driven iterative optimization is systematically exploring code variants by generating hypotheses, testing them against a stable baseline, and gating improvements using hard metrics or LLM-based quality judgments to identify the best performing solution.

Does ce-optimize support LLM-based quality judgments instead of hard metrics?

Yes, the optimization harness supports judge mode for prompt-based LLM evaluation alongside deterministic hard metrics. Judge mode uses LLM-based quality judgments to evaluate variants when hard metrics are unavailable or insufficient.

How do I resume interrupted optimization batches and keep results auditable?

You can resume interrupted optimization batches using isolated git worktrees and a persistent experiment log. A strategy digest records baseline and best-so-far results, enabling resumable and auditable optimization across multiple sessions.

Can I enforce gate checks during automated code optimization?

Yes, the measurement harness enforces gate checks during iterative optimization batches. Gate checks validate whether generated code variants meet predefined objective metrics before accepting them as improvements over the stable baseline.

What are the limitations of using worktrees for isolated code optimization?

Worktrees require a compatible git repository to safely modify code and reproduce results. If your software project lacks a structured version control environment, isolated worktree scaffolding for experimentation cannot be utilized effectively.