firstmate

Solid

The `firstmate` build executor — launch ONE long-lived First-Mate session over a whole `.oh/tasks/<slug>/` task graph through the herdr → tmux → foreground runner ladder, where ralph launches 50 fresh single-story processes. Opt-in only, via `--executor=firstmate`; `ralph` stays the default. Documents the executor contract, the ladder and its detection gates, the naming contract, the session budget, the watch matrix, the recovery matrix, and the manual kill procedure for all three runner modes. TRIGGER when: launching or watching an `--executor=firstmate` build, "run firstmate for <slug>", a wedged or stuck firstmate session needs killing, a `FIRSTMATE-INCOMPLETE` line needs interpreting, a firstmate lock needs clearing, or the herdr/tmux/foreground degrade behavior needs explaining.

AI & Automation 38 stars 3 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 83/100

Stars 20%
53
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# firstmate — the build executor > **Name disambiguation — read this first.** Two different things in this repo > share the name, and the overload is **intentional**: the executor runs the > role's workflow. > > | | **`firstmate` — the build executor** | **First Mate — the supervisory role charter** | > |---|---|---| > | What | This skill: the third `--executor` arm | An operator-authored role definition | > | Where | `.oh/scripts/firstmate.sh`, `.oh/scripts/lib/session-runner.sh`, `.oh/skills/firstmate/` | [`.oh/context/rules/first-mate.md`](../../context/rules/first-mate.md) | > | Reached by | `--executor=firstmate` on `/ship-spec` or `/autopilot` | `.oh/prompts/advisor/*` (`plan.yml`, `implement.yml`, `pr.yml`) reference it | > | Identity | a *session*: `firstmate-<slug>` | a *role*: adaptive decomposition, routing, supervision, verification, synthesis | > > The executor's session prompt is a **derivative of that charter's prompt pack** > — `.oh/skills/firstmate/templates/session-prompt.md` follows the > `implement.yml` + `pr.yml` step order. That is why the names match. When a > reader says "First Mate," they mean the role; when a command says > `--executor=firstmate`, it means this executor. Never leave which one is meant > implicit. ## The executor contract `firstmate` is the third build shape alongside `ralph` and `delegate-advisor`. It is **opt-in** — reached only via `--executor=firstmate` — and **`ralph` is still the default and is retained indefinitely** as the ...

Details

Author
mifunedev
Repository
mifunedev/openharness
Created
5 months ago
Last Updated
today
Language
TypeScript
License
Apache-2.0

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

autopilot

Self-improvement loop: each hourly run implements the oldest open issue labeled `autopilot` that has no open PR. When the queue is empty it runs first-principles `/audit harness` research, files its own `autopilot` ticket from the top-ranked finding, and builds that. Decomposes via the pm agent, then runs `/ship-spec --issue`, which owns the build end-to-end (the two compacts bracketing implement, a worktree Advisor, `/delegate` workers running `.oh/scripts/ralph.sh`, the `/eval` gate, and the `/audit pr` promotable undraft) through to a ready-for-review PR whose description states why this item was selected. Harness-infra only (skills/rules/docs/scripts/crons/wiki) — never sandbox application code. Runs in its own per-run tmux session. Caps: 6 open autopilot PRs created per UTC day AND 10 total open; never auto-merges. TRIGGER when: the hourly .oh/crons/autopilot.md fires, or invoked manually on demand (e.g. /autopilot --dry-run to preview the next selection).

38 Updated today
mifunedev
AI & Automation Listed

executor

Implements a plan created by /architect. Reads the plan, claims a phase, works one task at a time in an isolated branch or worktree, verifies externally, commits, and records state in its own single-writer file. Designed for multi-agent parallel execution. Trigger: "execute the plan", "implement phase", "continue the plan", "work on next task", "pick up where we left off".

0 Updated 1 months ago
makieali
Code & Development Listed

coordination

How the first-mate coordinator decomposes work, dispatches the crew across isolated worktrees (treehouse + tmux + gnhf via fleetmind-launch), monitors, consolidates, and delivers forge-agnostically (PR on GitHub / MR on GitLab via forge.sh). Use when orchestrating multi-task or multi-repo work across the agent crew.

2 Updated 1 months ago
vinaygiri