← Back to skills
Agent-installable Execution Source review 3 minutes

Runner

Harden a Linear-backed project for autonomous Cursor/Codex execution — plan, prompts, gates, and proof.

Turn a project with Linear issues into a hardened Cursor/Codex execution packet: Helm-style human handoff operating plan, top-of-page copy/paste prompts, bounded-queue and goal-mode prompts, CLI Tester + Book review gate config, cleanup manifests, visual-proof policy, receipt-uniqueness rules, and Entity FS links. Project-agnostic replacement for the Helm incident workflow.

Install contract
Source
superada.ai/skills/runner
Entrypoint
SKILL.md
Installability
Ready for agent install
Source spec
superada:runner

This page is designed to be the thing you send to another agent. It tells the agent where the source of truth lives, whether install is real today, and what command or manual path to follow.

Canonical source
https://superada.ai/skills/runner/
Install command
curl -sSf https://superada.ai/install/runner | sh
Prompt to hand another agent
Install the skill described on this page from superada:runner. Review the source first, then run: curl -sSf https://superada.ai/install/runner | sh

Install steps

Step 1
Install the skill from the SuperAda installer.
Step 2
Audit source-of-truth docs, repo rules, live Linear bodies, proof commands, and branch context first.
Step 3
Build the linear_id_to_source_id.json mapping from title/scope — never ordinal mapping.
Step 4
Generate the full pack: plan.md, prompts, gate config, approved queue, state file.
Step 5
Launch with Cursor CLI goal-mode or Codex exec, then register the supervisor cron.

What it covers

  • Source audit and issue mapping (linear_id_to_source_id.json)
  • Helm-style human handoff plan.md
  • Cursor/Codex prompts: single-issue, bounded-queue, goal-mode
  • CLI Tester + project gate configuration
  • Autonomous safe-commit and sign-off deferral policies
  • Per-issue proof matrices with ownership tracking
  • Entity FS plan links (human + raw API)
  • Book supervisor cron with auto-stop on queue drain

Good use cases

  • Make Cursor build a Linear project autonomously with local proof gates
  • Generate execution packs and prompts for Cursor or Codex CLI
  • Set up recurring supervisor crons for autonomous build queues
  • Migrate the Helm incident workflow pattern to a new project

Published artifacts

Skill contract
superada:runner/SKILL.md
Full execution pack workflow with 16 hard rules, executor selection, and autonomous policies.
Validation script
superada:runner/scripts/validate_execution_pack.py
Validates generated execution packs against the Runner contract.
Secret scan script
superada:runner/scripts/redacted-secret-scan.sh
Scans worktrees for secrets before autonomous commit.
Plan template
superada:runner/templates/plan.md
Helm-style human handoff plan.md template.
Cursor goal prompt
superada:runner/templates/cursor-driver-cron-prompt.md
Goal-mode prompt for autonomous whole-queue execution.
Gate config example
superada:runner/templates/project-gate.example.json
Project gate JSON configuration for CLI Tester.
Reference library
superada:runner/references/
60+ incident-derived reference files covering Cursor/Codex supervision, Linear quirks, Entity FS, and autonomous policies.