research-and-go

name	research-and-go
argument-hint	<broad goal description>
description	Full pipeline: decompose a broad goal into sub-plans, draft each with adversarial review, then execute all of them autonomously. One command, walk away. Usage: /research-and-go <description>

/research-and-go <description> — Plan and Execute Everything

The full autonomous pipeline in one command. Decomposes a broad goal into focused sub-plans, drafts each with adversarial review, writes a meta-plan, and immediately executes it — all without pausing for approval.

Use when: you trust the pipeline and want end-to-end execution from a single description. For more control, use /research-and-plan (plan only) followed by /run-plan (execute).

Ultrathink throughout.

Arguments

/research-and-go <description>

• description (required) — the broad goal, in natural language. Same format as /research-and-plan.

Examples:

• /research-and-go Add physical modeling support for thermal and mechanical domains
• /research-and-go Implement all missing block diagram tool blocks from the gap analysis
• /research-and-go Close the runtime deployment parity gap

Step 0 — Tracking Setup

Before anything else, check whether another pipeline is already in progress.

MAIN_ROOT=$(cd "$(git rev-parse --git-common-dir)/.." && pwd)
mkdir -p "$MAIN_ROOT/.zskills/tracking"

Check for duplicate pipeline: Compute the scope slug first (see below), then check if $MAIN_ROOT/.zskills/tracking/research-and-go.$SCOPE/pipeline.research-and-go.$SCOPE exists (new subdir scheme — Phase 1 design doc Option B). If it does, STOP — this exact pipeline is already in progress. Read the file and report its contents. Do not proceed unless this is a deliberate re-run (see Re-run Handling below). Note: other research-and-go pipelines with DIFFERENT scopes are fine — they run in parallel without conflict.

Create the scoped sentinel:

SCOPE=$(echo "$DESCRIPTION" | tr '[:upper:] ' '[:lower:]-' | sed 's/[^a-z0-9-]//g' | cut -c1-30)
PIPELINE_ID="research-and-go.$SCOPE"
PIPELINE_ID=$(bash scripts/sanitize-pipeline-id.sh "$PIPELINE_ID")
# Recover SCOPE after sanitization (strip the "research-and-go." prefix).
SCOPE="${PIPELINE_ID#research-and-go.}"
mkdir -p "$MAIN_ROOT/.zskills/tracking/$PIPELINE_ID"
printf 'skill=research-and-go\ngoal=%s\nstartedAt=%s\n' "$DESCRIPTION" "$(date -Iseconds)" > "$MAIN_ROOT/.zskills/tracking/$PIPELINE_ID/pipeline.research-and-go.$SCOPE"

Where $DESCRIPTION is the broad goal passed to this command and $SCOPE is a slugified version for scoping.

Declare pipeline ID for hook scoping:

echo "ZSKILLS_PIPELINE_ID=$PIPELINE_ID"

This echo is read by the tracking hook from the session transcript to scope marker checks to this pipeline only. It must happen before any git operation.

Pre-decide the meta-plan path so the final-verify marker can be written immediately (gate is in place from pipeline start):

SCOPE_UPPER=$(echo "$SCOPE" | tr 'a-z-' 'A-Z_')
META_PLAN_PATH="plans/META_${SCOPE_UPPER}.md"
META_PLAN_SLUG=$(basename "$META_PLAN_PATH" .md | tr '[:upper:]_' '[:lower:]-')
# Convention matches /run-plan TRACKING_ID derivation
# (skills/run-plan/SKILL.md:388-398).

Lock down the final cross-branch verification requirement immediately. The pipeline will end with a top-level /verify-changes branch invocation that runs as a cron-fired turn after the meta-plan execution completes. By creating the requirement marker NOW (before any implementation), the hook will block any commit on main until this final verification has been fulfilled. The orchestrator cannot skip the final cross-branch check.

printf 'skill=verify-changes\nscope=branch\nrequiredBy=research-and-go\nmeta_plan=%s\nmeta_plan_slug=%s\ncreatedAt=%s\n' \
  "$META_PLAN_PATH" "$META_PLAN_SLUG" "$(date -Iseconds)" \
  > "$MAIN_ROOT/.zskills/tracking/$PIPELINE_ID/requires.verify-changes.final.$META_PLAN_SLUG"

Known cross-pipeline read gap (PHASE-5-UPDATE): run-plan reads this requires.verify-changes.final.$META_PLAN_SLUG marker from a different pipeline's subdir (r&g's subdir, not run-plan's). The flat-path reads at skills/run-plan/SKILL.md:1176-1177 and 1365-1368 still need updating to the subdir scheme. Tracked for Phase 5 — not touched here.

The marker is named with the meta-plan slug to match the pipeline scope the meta-plan /run-plan will emit (run-plan.<META_PLAN_SLUG>). The hook's pipeline-scoping pattern (*.${PIPELINE_ID#*.} in hooks/block-unsafe-project.sh.template:250) enforces this marker on the meta-plan orchestrator's commits but NOT on sub-plan commits (sub-plans run under their own scopes). Note: hook enforcement is gated on CODE_FILES being non-empty (hook line 243); since the meta-plan's pipeline-completion commit is content-only, the hook is a backstop -- /run-plan Phase 5c does the orchestrator-level check that actually defers Phase 5b until the fulfillment marker exists.

Re-run Handling

If $MAIN_ROOT/.zskills/tracking/$PIPELINE_ID/pipeline.research-and-go.$SCOPE already exists and this is a deliberate re-run of the same goal:

1. Read the existing pipeline.research-and-go.$SCOPE to confirm the goal matches.
2. Check which requires.* and meta.* files already exist in $MAIN_ROOT/.zskills/tracking/$PIPELINE_ID/.
3. For each existing requires.* entry, check if a corresponding fulfilled.* file exists in the same subdir. Only create new requirement files for unfulfilled requirements. (meta.* files are metadata and are idempotent — just re-touch.)
4. Touch existing requires.* files to refresh their mtime (prevents staleness false positives).
5. Overwrite the pipeline.research-and-go.$SCOPE sentinel with a fresh timestamp.

Step 1 — Decompose and Draft

Invoke /research-and-plan with auto, parent=research-and-go, and the full description:

/research-and-plan output $META_PLAN_PATH auto parent=research-and-go <description>

This:

1. Dispatches research agents to survey the domain
2. Identifies sub-problems and dependencies
3. Sizes scope for each sub-plan
4. Skips the user confirmation checkpoint — auto flag.
5. Drafts each sub-plan via dispatched /draft-plan agents (each gets full adversarial review in its own context)
6. Writes the meta-plan with pure implementation phases

The meta-plan path is pre-decided by /research-and-go at Step 0 and passed to /research-and-plan via the output argument -- /research-and-plan writes the meta-plan to that path. Confirm the path was written successfully (file exists and is non-empty) before proceeding.

Step 1b — Lock Down Requirements

After /research-and-plan returns and before execution begins, create tracking requirement files for every sub-plan and the meta-plan itself. These files let any observer (or a re-run) know exactly what the pipeline expects to accomplish.

MAIN_ROOT=$(cd "$(git rev-parse --git-common-dir)/.." && pwd)

For each sub-plan index i (from 1 to N, where N is the number of sub-plans produced by /research-and-plan):

These integer markers are dispatch metadata, not enforcement (per Phase 1 design doc OQ1). The hook's enforcement globs only scan requires.*, fulfilled.*, and step.*. Using the meta.* prefix keeps them out of the scope-filter path by construction, making the metadata intent explicit in the marker basename.

for i in 1 2 ... N; do
  printf 'skill=draft-plan\nindex=%d\nrequiredBy=research-and-go\ncreatedAt=%s\n' "$i" "$(date -Iseconds)" > "$MAIN_ROOT/.zskills/tracking/$PIPELINE_ID/meta.draft-plan.$i"
  printf 'skill=run-plan\nindex=%d\nrequiredBy=research-and-go\ncreatedAt=%s\n' "$i" "$(date -Iseconds)" > "$MAIN_ROOT/.zskills/tracking/$PIPELINE_ID/meta.run-plan.$i"
done

Also create a metadata marker for the meta-plan execution itself:

printf 'skill=run-plan\nid=meta\nrequiredBy=research-and-go\ncreatedAt=%s\n' "$(date -Iseconds)" > "$MAIN_ROOT/.zskills/tracking/$PIPELINE_ID/meta.run-plan.meta"

Replace 1 2 ... N with the actual sub-plan indices. The draft-plan metadata tracks the planning phase; the run-plan metadata tracks execution.

Pass tracking IDs to child skills: When dispatching /run-plan for each sub-plan, include the tracking index so child skills can mark their corresponding requirement as completed. For example, include tracking-index=3 in the dispatch prompt for sub-plan 3.

Step 2 — Execute

Landing mode detection

Before constructing the /run-plan invocation, detect whether the original $GOAL text contains pr or direct as a distinct word (same pattern as Phase 3a in /run-plan and /fix-issues, extended to recognize sentence punctuation .!? since this is prose-like goal text):

LANDING_ARG=""
if [[ "$GOAL" =~ (^|[[:space:]])[pP][rR]($|[[:space:]]|[.!?]) ]]; then
  LANDING_ARG="pr"
elif [[ "$GOAL" =~ (^|[[:space:]])[dD][iI][rR][eE][cC][tT]($|[[:space:]]|[.!?]) ]]; then
  LANDING_ARG="direct"
fi

Where $GOAL is the original description passed to /research-and-go. If the goal text does not mention either keyword, LANDING_ARG stays empty and /run-plan falls back to its config default (normally cherry-pick). Do NOT pass a literal empty token to /run-plan — omit the argument entirely when LANDING_ARG="".

Construct the /run-plan cron prompt

Build the prompt conditionally to avoid empty-token confusion. The cron is one-shot (recurring: false). Chunked finish auto self-perpetuates via /run-plan Phase 5c -- each completed phase schedules the next turn. The user-facing every N argument on /run-plan is unaffected; this change only removes the hardcoded wrapper from /research-and-go's kickoff.

if [ -n "$LANDING_ARG" ]; then
  RUN_PROMPT="Run /run-plan $META_PLAN_PATH finish auto $LANDING_ARG"
else
  RUN_PROMPT="Run /run-plan $META_PLAN_PATH finish auto"
fi

Immediately run the resulting invocation -- conceptually:

/run-plan $META_PLAN_PATH finish auto [pr|direct]

Concrete examples:

• Goal "Add dark mode" -> /run-plan $META_PLAN_PATH finish auto
• Goal "Add thermal domain. PR." -> /run-plan $META_PLAN_PATH finish auto pr
• Goal "Refactor logs direct" -> /run-plan $META_PLAN_PATH finish auto direct

This executes all implementation phases sequentially -- each delegating to /run-plan on the corresponding sub-plan via chunked cron-fired turns. Full verification, testing, and landing at each phase.

Step 3 — Final cross-branch verification (scheduled by /run-plan, not here)

After the meta-plan's last sub-plan completes its last phase, /run-plan Phase 5c detects the requires.verify-changes.final.$META_PLAN_SLUG marker. It schedules:

1. A cron firing Run /verify-changes branch tracking-id=$META_PLAN_SLUG
2. A re-entry cron firing Run /run-plan $META_PLAN_PATH finish auto

The verify cron runs at top level (full Agent tool), performs cross-branch verification (git diff main...HEAD), and on success writes fulfilled.verify-changes.final.$META_PLAN_SLUG. The re-entry cron then completes Phase 5b (mark plan complete) cleanly. The user sees the verify report as the final turn before the pipeline is truly complete.

Reference: scheduling logic lives in /run-plan Phase 5c (Phase A). This Step 3 is documentation only -- /research-and-go has already exited at the end of Step 2.

Pipeline Cleanup

Under chunked finish auto, /research-and-go Step 2 schedules a cron and exits -- Step 3 never runs in-session. Cleanup happens when the user (or a future automation) observes the pipeline is complete. Run bash scripts/clear-tracking.sh (interactive) to wipe tracking. Do NOT auto-wipe -- requires.verify-changes.final.* and its fulfillment marker are pipeline-completion records that should survive until the user confirms the pipeline finished.

If the pipeline failed at any point, tracking is preserved for inspection and re-run. See Step 0 Re-run Handling for the resume protocol.

Key Rules

• No confirmation checkpoints. The user said go — that's blanket approval for decomposition, planning, and execution. Do not pause between steps.
• Failure still stops. If /run-plan hits the Failure Protocol (cherry-pick conflict, test failures after landing, verification fails after 2 cycles), it stops and reports. go means autonomous, not reckless.
• Sub-plan staleness refresh applies. If a later sub-plan depends on an earlier one, /run-plan auto-refreshes it via /draft-plan before execution (the staleness check in Phase 1 step 6).
• This is the top of the pipeline. The execution chain: /research-and-go → /research-and-plan → /draft-plan (×N) → /run-plan (meta) → /run-plan (×N sub-plans) → /verify-changes (×N) → /commit (×N landings).