report

Solid

Write the final summary of an autoresearch run to `./.ar/final_report.md` — trajectory, best commit and its diff, what worked, what failed, and what to try next. Use for `/ar:report`, "write up the autoresearch results", or "summarise the experiment loop". Reads `./.ar/ar.jsonl` from disk, so it works in a fresh session. Writes only the report; never iterates, commits, or reverts, and leaves the loop able to continue.

Data & Documents 2 stars 0 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 78/100

Stars 20%
16
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# /ar:report — write the run up Turn the record into something a person can read. Do not iterate. ## Steps 1. Read state (`cat ./.ar/ar.jsonl | tail -50`, plus `worklog.md` and `results.tsv` if present). No `ar.jsonl` means nothing to report — say so and stop. 2. Reconstruct the run per `${CLAUDE_PLUGIN_ROOT}/references/resume-loop.md` §1, across **all** segments, not just the last: a segment boundary marks a harness or baseline change, so metrics either side of it are not comparable and the report must say where the boundaries fell rather than plotting through them. 3. Pull the winner chain from git — it is an independent record of the same run: ```bash git log --format='%h %s' --grep='"status":"keep"' <config.branch> git diff <config.snapshotCommit>..<bestCommit> --stat ``` 4. Write `./.ar/final_report.md`: - **Goal and setup** — objective, metric, direction, harness, budget. - **Result** — baseline → best, absolute and relative, with the confidence tier. State plainly whether the total gain clears the noise floor; a run that ended inside its own scatter did not find anything, and the report says so rather than dressing it up. - **Trajectory** — the keep chain, each with commit, metric, delta and the one-line description of the change. - **What worked** — the winning changes and, where the record supports it, why they worked. Distinguish an explanation from a guess. - **What failed** — dis...

Details

Author
emaballarin
Repository
emaballarin/ccplugins
Created
3 months ago
Last Updated
3 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Listed

status

Print the current autoresearch run's state — goal, baseline, noise floor, best-so-far, run tallies, budget, branch, and the last few iterations. Use for `/ar:status`, "how is the loop doing", "what's the best so far", or any read-only check on an autoresearch experiment. Reconstructs everything from `./.ar/ar.jsonl` on disk, so it works in a fresh session with no prior history. Strictly read-only — never iterates, edits, commits, or reverts.

2 Updated 3 days ago
emaballarin
Data & Documents Listed

stop

End the current autoresearch run — append a `status:stopped` sentinel to `./.ar/ar.jsonl`, which is also what halts the external `ar-loop.sh` driver. Use for `/ar:stop`, "stop the loop", "halt autoresearch", or "that's enough iterations". Writes the sentinel and the final report, then prints (does not run) the command to return to the original branch. Never reverts or discards work — every kept commit stays on the experiment branch.

2 Updated 3 days ago
emaballarin
Web & Frontend Solid

resume

Run the autoresearch experiment loop — propose one change, measure it, keep it only if it beats the noise floor, repeat. Use to resume or continue an autoresearch run, for `/ar:resume`, for "keep iterating", "next experiment", "continue optimising", or whenever `./.ar/ar.jsonl` exists and the loop should advance. Reconstructs everything from disk, so it survives compaction, `/clear`, and a fresh session. Requires `/ar:start` to have run first.

2 Updated 3 days ago
emaballarin