opencode-phase-loop

Bridges OpenCode operators to the repo-local phase-loop runner for status, resume, and bounded run flows.

2|1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Consiliency/agent-harness --skill opencode-phase-loop-consiliency
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: opencode-phase-loop
Source: https://github.com/Consiliency/agent-harness/tree/main/skills-src/opencode/opencode-phase-loop
Command: npx skills add https://github.com/Consiliency/agent-harness --skill opencode-phase-loop-consiliency

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running the phase-loop orchestration runtime from OpenCode requires knowing the correct CLI commands, shared state files, and blocker semantics; this Skill gives OpenCode operators a thin bridge to the repo-local runner without reimplementing phase selection, reconciliation, or execution logic. ## Core Features & Use Cases - Command Mapping: Translates OpenCode intents (handoff, status, monitor, resume, run, dry-run, sync-skills) into the correct phase-loop or codex-phase-loop CLI invocations with bounded defaults like --max-phases 1. - Shared State Inspection: Reads .phase-loop/state.json, events.jsonl, handoff files, and run heartbeats to report automation status, verification status, and frozen blocker literals such as branch_sync_conflict. - Drift and Blocker Diagnosis: Detects installed-skill drift (missing_root, missing_skill, drifted) and guides repair via sync-skills --apply, plus branch-governance preflight handling for pipeline-mode dispatches. - Use Case: An OpenCode user asks to resume a stalled phase-loop run; the Skill checks monitor --once --json for the current blocker, confirms the worktree state, and issues a bounded phase-loop run --max-phases 1 --closeout-mode manual. ## Quick Start Ask the assistant to check phase-loop status from OpenCode, for example: "Show me the current phase-loop status and any blockers before I resume the run."

Frequently Asked Questions about opencode-phase-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run phase-loop from OpenCode?▼

Use the repo-local phase-loop CLI with a bounded scope, such as `phase-loop run --max-phases 1 --closeout-mode manual`. The Skill maps OpenCode intents like run, dry-run, resume, and status to the correct CLI commands without inventing a second runner.

How do I check phase-loop status and blockers?▼

Run `phase-loop status` or `phase-loop monitor --once --json` for exact machine state. The shared state in `.phase-loop/state.json` and `events.jsonl` reports automation status, verification status, and frozen blocker literals like `branch_sync_conflict`.

What is a branch_sync_conflict blocker in phase-loop?▼

It occurs in pipeline mode when the roadmap is committed only on an unpushed local branch and the runtime guard refuses to switch to the pipeline branch. Push the roadmap to the base branch, or pass `--allow-branchgov` to switch anyway.

How do I fix installed-skill drift in the OpenCode bridge?▼

Run `phase-loop sync-skills --check` to inspect drift, then `codex-phase-loop sync-skills --apply` to repair the local bridge when the advisory record reports `missing_root`, `missing_skill`, or `drifted`. Installed skills are a manual reentry surface, not required for the runner.

Does the OpenCode phase-loop bridge reimplement the runner?▼

No. It is a thin bridge that points OpenCode at the shared loop state and command surface; phase selection, reconciliation, event writing, and execution remain in the repo-local phase-loop runtime.