メニュー
End-to-end auto-factory driver — picks up beads + GH issues tagged factory, dispatches coders to drive worldai PRs to /green + /advice + /er, runs verifier ticks, repeats until done. Designed to work even when GH API is rate-limited (falls back to beads-only).
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Control cmux tabs, workspaces, and terminal panes via Unix socket. Use when reading terminal output, sending commands to another agent's pane, switching tabs, or monitoring coder progress.
Read and steer another cmux terminal tab through the Unix socket.
Spawn or respawn a persistent, crash-recoverable Sonnet sidekick for ANY long-running mission — PR/CI fleets, research sweeps, migrations, monitoring, ops runbooks, data pipelines, multi-day projects in any repo or no repo at all. The sidekick is ALWAYS a named in-session Claude Agent-Team teammate (model sonnet, SendMessage-addressable, visible in the user's panel) durable via STATE.md + a P1 resumption bead + commit-often. There is NO tmux mode and NO codex engine — external tmux sidekicks and -p print-mode sidekicks are banned. Use when the user says /sidekick, "respawn the sidekick", or wants long work to survive conversation crashes.
Orchestrate multi-agent swarms (ultracode Workflow fan-outs + Agent-team lanes) with adversarial verification, /innov, /advice, and a sidekick durability layer for crash-recoverable runs
Audit automation job runs, logs, PR processing metrics, and AI-authored remote commits.
Aside browser is the PRIMARY browser tool for all Hermes/Claude/Codex work. Use aside CLI (repl/mcp/exec modes) or aside-mcp before Playwright MCP / superpowers-chrome. Use when opening browsers, scraping, UI tests, localhost verification, cookie injection flows, or any browser-driven automation. Playwright MCP and superpowers-chrome are explicit fallbacks for cases Aside can't handle (e.g., headless CI runners, Playwright-specific test fixtures). Reversible — see ~/.hermes/scripts/rollback-aside-default.sh.
| name | auto-factory |
| description | End-to-end auto-factory driver — picks up beads + GH issues tagged factory, dispatches coders to drive worldai PRs to /green + /advice + /er, runs verifier ticks, repeats until done. Designed to work even when GH API is rate-limited (falls back to beads-only). |
The auto-factory is the agent-orchestrator-style system that drives worldai PRs to merge. This skill is its orchestrator: it picks up work (beads + GH issues), dispatches coder subagents, runs verifier ticks, and iterates until gates pass.
H=daemon/factory-overlay.sh
CONFIG=config/daemon.toml
[ -f "$CONFIG" ] || CONFIG=daemon/contracts/daemon.toml.example
$H init # idempotent
The overlay harness daemon/factory-overlay.sh is the canonical executable spec for the auto-factory state machine (restored from e60b5a31b~1:daemon/factory-lite-harness.sh and extended in PR #167). All sqlite3 mutations to ~/.dark-factory/daemon-cxdb.sqlite flow through it. Subcommands: init, intake-upsert, route-record, capacity, dispatch-record, pr-opened, autonomy-tick, gate-assessment, prev-gate-assessment, ready, reroll-verdict, park, park-duplicate, bead-closed-check, tick-summary, recover-held, unstick-dispatching, redrive-pr, list.
Historical note: the original
daemon/factory-lite-harness.shanddaemon/run-factory-lite.shwere removed in commite60b5a31b(2026-07-05, $USER-xrdx). The decommissioned factory-lite-coder / factory-lite-verifier skills are gone; their protocols are now inline in this skill + factory-af-tick.sh + factory-overlay.sh.
Pick up work from BOTH sources (bead store + GitHub):
br list --status open --label factory --json
For each bead: read body, detect drive-existing-pr mode (fields existing_pr, existing_branch, target_repo). If present, this bead drives an existing PR — coder must push to existing branch via git push wa <existing_branch>. Otherwise default to new-work (create factory/<bead>-r<attempt> branch).
gh issue list --repo "$TARGET_REPO" --label factory --state open --json number,title,body --limit 20
If GH API rate-limited (returns error), skip this step — beads-only mode. Log the fallback: [intake] GH API rate-limited, beads-only mode.
For each GH issue, treat as a bead: read body, file a local bead via br create "<title>" --body "<body>" --label factory --label drive-existing-pr, then continue with bead pickup.
A bead/issue has drive-existing-pr mode if body contains ALL of:
existing_pr: <N>existing_branch: <name>target_repo: <owner>/<name>The coder MUST push to the existing branch via git push <remote> <existing_branch> (NOT create a new factory/* branch). This is the general-purpose pattern.
$H list QUEUED → for each bead, use LLM judgment to pick SMALL_PATH (single-file fix) vs STANDARD_PATH (multi-file/architecture). Record via $H route-record <bead_id> <VERDICT> "<note>".
free=$($H capacity) — min(max_workers - active, max_batch). If 0, skip to step 7.
Select up to $free routed QUEUED beads (file-overlap rule: serialize if any share a mutable file). For each selected bead:
$H dispatch-record <bead_id> <existing_branch> # e.g., fix/quota-banner-modal-cta-7945
$H dispatch-record <bead_id> factory/<bead_id>-r<attempt>
Spawn ALL selected coders in ONE message — multiple Agent tool calls, each subagent_type: minimax-pair-coder, run_in_background: true. Parallel dispatch is the point.
Each coder prompt MUST include:
git push wa <branch> for worldai, git push origin <branch> for dark-factory)/tmp/<bead>-wt; remove after push; never check out branches in the shared repo working tree)Step number kept stable.
For every row in $H list DISPATCHED:
$H bead-closed-check <bead_id> # guards against direct bead closure
For drive-existing-pr beads, check the existing PR branch for new commits:
gh pr view <existing_pr> --repo <target_repo> --json headRefOid,mergeable,statusCheckRollup,reviewDecision,comments
If new commits detected → $H pr-opened <bead_id> <existing_pr> <url>.
For new-work beads, check for new PR:
gh pr list --repo "$TARGET_REPO" --head "factory/<bead_id>-r<attempt>" --state open --json number,url
For every ATTESTED bead (PR opened/updated), run the 7 gates:
gh pr view <pr> --repo "$TARGET_REPO" --json headRefOid,mergeable,reviewDecision,statusCheckRollup
gh pr checks <pr> --repo "$TARGET_REPO" --json name,state,conclusion
Assess each gate:
conclusion=success (or state=SUCCESS)mergeable=MERGEABLE, mergeStateStatus not DIRTYcoderabbitai[bot] review APPROVEDcursor[bot] commentsisResolved=trueRecord via $H gate-assessment <bead_id> <pr> '<gates_json>'.
All-green → $H ready <bead_id> <pr> (terminal state; verifier stops driving).
Any-red → $H reroll-verdict <bead_id> <pr> <in_place_fixable|reroll_worthy> "<rationale>".
$H autonomy-tick $ELAPSED_SECS — increment actives, warn at 80%, park over-box.
$H tick-summary coder (or verifier if you ran verifier steps).
$H.base_branch.gh pr merge — dispatch is not the merge authority.dispatch-record.factory/* branch when the bead body has drive-existing-pr fields — push to the existing branch.bash daemon/factory-af-tick.sh for one tick; for a 24/7 poll loop, install the launchd plist from daemon/launchd/ai.dark-factory.af-tick.plist (bead $USER-57h0) and launchctl bootstrap gui/$UID <plist>.gate-assessment — if cooldown over, reset bead to QUEUED via direct sqlite3 update + increment attempt counter.