ak-loop

name	ak:loop
description	Autonomous iterative optimization loop — run N iterations against a mechanical metric, learn from git history, auto-keep/discard changes. Use for improving measurable metrics (coverage, performance, bundle size, etc.) through repeated experimentation.
user-invocable	true
disable-model-invocation	true
when_to_use	Invoke only when an objective metric can drive repeated trials.
category	utilities
keywords	["optimization","iteration","metrics","loop"]
argument-hint	[Goal/Metric description] or inline config block
metadata	{"author":"agentkit","attribution":"Core patterns adapted from autoresearch by Udit Goenka (MIT)","license":"MIT","version":"1.1.0"}

ak:loop — Autonomous Optimization Loop

Constraint + Mechanical Metric + Fast Verification = Autonomous Improvement

When to Use

• Improve a measurable metric (test coverage, bundle size, ESLint errors, Lighthouse score, etc.)
• Autonomous execution over N iterations without manual intervention
• Git-tracked experiments where you want rollback on regression
• Exploring a search space of code changes with consistent evaluation

When NOT to Use

Situation	Better Tool
Subjective goals ("make it cleaner")	ak:cook
Bug fixing with known root cause	ak:fix or ak:debug
One-shot tasks, no repetition needed	ak:cook
No mechanical metric to measure progress	ak:cook --interactive
Files outside a defined scope	manual approach

Configuration Format

Parsed from user message. Missing required fields trigger a batched ask_user capability.

Required

Field	Description	Example
Goal	Human description of what to improve	"Increase test coverage in src/utils"
Scope	search_files capability pattern(s) for editable files	"src/utils/**/*.ts"
Verify	Shell command that outputs a single number	"npx jest --coverage --json | jq '.coverageMap | .. | .s? | to_entries | map(.value) | (map(select(.>0)) | length) / length * 100' | tail -1"

Optional

Field	Default	Description
Guard	none	Regression check command (exit 0 = pass)
Iterations