Skip to content

Commit f8b7a03

Browse files
Clean up autoresearch skill: remove droid references, add /enter-mission guidance
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
1 parent faf8f47 commit f8b7a03

1 file changed

Lines changed: 14 additions & 24 deletions

File tree

  • plugins/autoresearch/skills/autoresearch

plugins/autoresearch/skills/autoresearch/SKILL.md

Lines changed: 14 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: |
77
- Run an automated research loop: try an idea, measure it, keep improvements, revert regressions, repeat
88
- Set up autoresearch for any codebase with a measurable optimization target
99
Implements the autoresearch pattern with MAD-based confidence scoring, git branch isolation,
10-
and structured experiment logging. Works standalone or as a mission worker skill.
10+
and structured experiment logging.
1111
---
1212

1313
# Autoresearch
@@ -18,6 +18,8 @@ Autonomous experiment loop: try ideas, keep what works, discard what doesn't, ne
1818

1919
You are running an autonomous optimization loop. Your job is to systematically improve a measurable metric by making changes, running experiments, and keeping only the improvements. You maintain structured state files so that any session — including a fresh one with no memory — can resume exactly where you left off.
2020

21+
**Tip for the user:** For longer optimization campaigns with better tracking and multi-session continuity, consider running this inside a mission (`/enter-mission`). Missions give you milestone validation, structured handoffs, and orchestrator-managed sequencing — useful when autoresearch is part of a larger workflow.
22+
2123
## Setup
2224

2325
Before the loop starts, you need to establish the experiment.
@@ -308,31 +310,19 @@ Droid sessions have finite context. To handle this gracefully:
308310
- **Think longer when stuck.** Re-read source files, study the data, reason about what's actually happening. The best ideas come from deep understanding.
309311
- **Resuming:** read autoresearch.md + git log, continue looping.
310312

311-
## Mission Worker Mode
313+
## Running with Missions
312314

313-
When used as a mission worker skill (via the `autoresearch-experimenter` droid), the feature description specifies:
314-
- The optimization goal
315-
- The termination condition (experiment count, time budget, or target metric)
316-
- Any additional constraints
315+
For longer or more structured optimization campaigns, consider using Droid's mission system for better tracking, milestone validation, and multi-session continuity. Start with:
317316

318-
Read the feature description carefully and follow the same loop procedure above, but respect the termination condition specified in the feature. When the termination condition is met, stop and report results in the handoff.
317+
```
318+
/enter-mission
319+
```
319320

320-
### Handoff (Mission Mode)
321+
The orchestrator can assign optimization features to this skill as a worker, specifying:
322+
- The optimization goal and target metric
323+
- Termination condition (experiment count, time budget, or target metric)
324+
- Files in scope and constraints
321325

322-
When returning results to the orchestrator, include:
326+
When running as a mission worker, read the feature description carefully, follow the same loop procedure above, and respect the termination condition specified in the feature. When the condition is met, stop and report results in the handoff.
323327

324-
```json
325-
{
326-
"salientSummary": "Ran 20 experiments optimizing val_bpb. Best result: 1.05 (-8.7% from baseline 1.15). Key wins: reduced depth from 8 to 6, switched to cosine schedule.",
327-
"whatWasImplemented": "Optimized train.py through 20 experiments. Best configuration: DEPTH=6, cosine LR schedule, batch size 2^17. val_bpb improved from 1.15 to 1.05 (-8.7%).",
328-
"whatWasLeftUndone": "",
329-
"verification": {
330-
"commandsRun": [
331-
{"command": "bash autoresearch.sh", "exitCode": 0, "observation": "Final best val_bpb=1.05"}
332-
],
333-
"interactiveChecks": []
334-
},
335-
"tests": {"added": []},
336-
"discoveredIssues": []
337-
}
338-
```
328+
This is especially useful when autoresearch is part of a larger workflow — e.g., optimize a model, then evaluate it against a test set, then package the results.

0 commit comments

Comments
 (0)