Codex Autoresearch

Mätt, återupptagbar optimeringsslinga med baseline, korrekthetsgrind och bevislogg

av TheGreenCedar · TheGreenCedar/codex-autoresearch

Testad · Fungerar ★ 8.8/10

Codex Autoresearch — Mätt, återupptagbar optimeringsslinga med baseline, korrekthetsgrind och bevislogg

Vad den gör

Förvandlar en vag förfrågan om att "göra det snabbare/mindre" till en mätt slinga: den registrerar en benchmark-baseline, kör en avgränsad ändring per paket, kör om korrekthetskontroller och loggar varje resultat (metrik, beslut, bevis, nästa åtgärd) till en återupptagbar sessionsfil med en avgränsad git-commit. Utlöses vid benchmark-driven optimering (testkörtid, paketstorlek, latens, minne), kvalitativ kvalitetsgap-forskning, återupptagande av en befintlig autoresearch-session, eller förberedelse av en granskningsgren-finalisering. Stöds av en Node CLI (autoresearch.mjs) som kör benchmark och kontrollerar kommandon lokalt.

Testrapport

Jag byggde ett leksaks-Node-projekt (sumTo via array+reduce, en bench.mjs som skrev ut METRIC seconds= och en checks.mjs), körde sedan slingan på två sätt under en tillfällig HOME. Baseline (ingen skill): Jag skrev bara om funktionen till en ackumulatorslinga och körde om bench (0.7297s -> 0.3652s) — en snabbare fil, ingen logg. Skill: setup skrev en session (autoresearch.md/.jsonl/.sh), doctor --check-benchmark bekräftade METRIC-kontraktet, next+log fångade baseline 0.7234, sedan loggade keep-paketet 0.3542 med kontroller som passerade (exit 0, "checks OK"), skapade en avgränsad git-commit 8d4e192 som endast berörde lib/sum.mjs, bifogade en ASI-anteckning (hypotes/bevis/nästa-åtgärd), och finalize-preview producerade en granskningsgren-plan som flaggade mognad "experimental". Avgörande skillnad: när jag matade in en snabbare-men-felaktig ändring (sluten form +1), avslutades paketets kontroller med 1 och CLI tvingade status checks_failed som den enda tillåtna statusen, vilket nekade att behålla — baseline-vägen har ingen sådan regressionsgrind.

Testad: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/TheGreenCedar/codex-autoresearch.git /tmp/codex-autoresearch-src
mkdir -p ~/.claude/skills
cp -R /tmp/codex-autoresearch-src/plugins/codex-autoresearch/skills/codex-autoresearch ~/.claude/skills/codex-autoresearch
# NOTE: this is a Codex PLUGIN, not a standalone skill. The SKILL.md drives a Node CLI that
# lives OUTSIDE the skill folder at /tmp/codex-autoresearch-src/plugins/codex-autoresearch/scripts/autoresearch.mjs
# Requirements: Node >= 24. On first run the CLI hydrates a runtime (downloads the matching
# GitHub release tarball with sha256 verification, or build locally from the clone).
# Run commands from the package root, e.g.:
#   node /tmp/codex-autoresearch-src/plugins/codex-autoresearch/scripts/autoresearch.mjs setup --cwd <project> --name <s> --metric-name seconds --direction lower --benchmark-command "<cmd printing METRIC name=value>" --checks-command "<cmd>"
# Intended install path is Codex's /plugins picker (TheGreenCedar -> codex-autoresearch), which bundles the CLI.

Kommandon och exempelprompter

/codex-autoresearchMätt, återupptagbar optimeringsslinga med baseline, korrekthetsgrind och bevislogg

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

Start a new Codex Autoresearch loop
Resume and inspect the current autoresearch run
Show the autoresearch dashboard and quality gaps

Läs hela rapporten →