iterative-experiment

Run an autonomous optimization loop that commits, measures, and keeps improving iterations.

1|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/softwaresalt/csv-managed --skill iterative-experiment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iterative-experiment
Source: https://github.com/softwaresalt/csv-managed/tree/main/.github/skills/iterative-experiment
Command: npx skills add https://github.com/softwaresalt/csv-managed --skill iterative-experiment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the manual trial-and-error process of improving a measurable outcome by running a structured, repeatable loop that proposes changes, benchmarks them, and keeps only improvements.

Core Features & Use Cases

  • Hypothesis-driven change loop: generates one scoped modification per iteration, commits it, measures performance, and keeps or reverts based on improvement.
  • Baseline-first measurement: establishes a robust median baseline (with min/max variance context) before any experimentation begins.
  • Reproducible experiment logging: persists a TSV log of every iteration (including commits and deltas) under a configured results path for later review.

Quick Start

Run iterative-experiment with a clear goal, a maximum budget, and an optional scope to let it iterate until your metric threshold is met or the budget runs out.

Frequently Asked Questions about iterative-experiment

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

FAQPage Schema
How do I automate code optimization for a measurable benchmark metric?

An autonomous optimization loop automates measurable improvement by generating hypotheses, applying scoped changes, committing them, measuring the benchmark metric, and reverting regressions. It keeps only modifications that yield a measurable improvement.

What is the best way to run an autonomous iteration loop for repository workflows?

The best way is to use a structured autonomous loop that establishes a baseline measurement, proposes isolated changes within a defined scope, and commits only improving iterations. This ensures modifications remain controlled and reproducible.

Do I need a clean git state before starting automated benchmarking and schema changes?

Yes, you need a git-clean starting state before starting automated benchmarking or schema changes. The optimization loop requires this to safely commit changes and automatically revert on failure without risking unintended edits to your repository.

How does revert-on-failure work for isolated code modifications?

Revert-on-failure works by measuring the benchmark metric after each isolated code modification; if the iteration does not improve the baseline, the loop automatically reverts the commit. This guarantees that only performance-enhancing changes are kept.

Can I log experiment iterations to a TSV file for later review?

Yes, you can log experiment iterations to a TSV file. The loop persists a deterministic TSV experiment log of every iteration, including commits and deltas, under a configured results path to ensure reproducible experiment logging.

What are the limitations of using hypothesis-driven change loops for performance tuning?

Limitations of hypothesis-driven change loops include requiring a single numeric metric for evaluation and a bounded iteration budget. Modifications must also be isolated to a defined scope to prevent unintended edits, meaning it cannot handle unmeasurable or unbounded tasks.