research-experiment

# Research Experiment Use this skill to run parallel, autonomous experiments safely. There are two roles: - Main Agent: owns the research brief, workspace setup, researcher prompts, verification, and merge decision. - Experiment Agent: owns independent exploration inside one assigned worktree and must not redefine the experiment. If the user says "you are the main agent", follow the Main Agent Role. If the user says "you are an experiment agent" or "researcher agent", follow the Experiment Agent Role. ## Main Agent Role The main agent defines the experiment and coordinates researchers. It must not let each researcher invent different goals or acceptance criteria. ## Main Agent Workflow 1. Convert the user request into an experiment brief: - Goal: the outcome to achieve. - Acceptance criteria: exact tests, benchmarks, or review gates. - Hard constraints: what must not change. - Quality bar: what counts as meaningful progress versus noise. - Shared resources: ports, GPUs, model caches, services, datasets, credentials, or external APIs. - Stop conditions: when researchers may quit. 2. Identify the production repository root: - Use `git rev-parse --show-toplevel` when inside a git repo. - If the project has nested repos, identify which repo owns the files under experiment. - Do not assume the current working directory is the repo root. 3. Create per-researcher worktrees inside the project folder, not beside it: - Prefer a project-local dire...