Skip to content
Skills Library
AI & agents · Planning

cvg-plan-loop

/cvg-plan-loop

Orchestrate a monitored planning loop where a planner drafts the plan and independent plan review with focused rechecks gates completion. Use when the user asks to create or revise a plan through supervised specialist sessions on Codex threads or Claude Code background agents.

Repository
convergo ↗
Licence
MIT
Last repository change
13.09.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
4
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 13.09.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • SKILL.md zawiera komentarze HTML (4). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

Orchestrate a monitored planning loop where a planner drafts the plan and independent plan review with focused rechecks gates completion. Use when the user asks to create or revise a plan through supervised specialist sessions on Codex threads or Claude Code background agents.

Arguments

/cvg-plan-loop [planning goal, requirements path, behavior contract path, or planning prompt]
Original author description

Orchestrate a monitored planning loop where a planner drafts the plan and independent plan review with focused rechecks gates completion. Use when the user asks to create or revise a plan through supervised specialist sessions on Codex threads or Claude Code background agents.

How it works

  1. Phase 0: Orchestrator Setup
  2. Phase 1: Planner Handoff
  3. Phase 2: Fresh Plan Review
  4. Phase 3: Return Review Feedback to Planner
  5. Phase 4: Focused Re-Review
  6. Phase 5: Review Exit
  7. Completion Summary
Original SKILL.md headings · 181 lines, 935 words
SKILL.md preview
---
name: cvg-plan-loop
description: Orchestrate a monitored planning loop where a planner drafts the plan and independent plan review with focused rechecks gates completion. Use when the user asks to create or revise a plan through supervised specialist sessions on Codex threads or Claude Code background agents.
argument-hint: "[planning goal, requirements path, behavior contract path, or planning prompt]"
---

# Plan Loop

Use this skill for plan-only cvg-multi-session orchestration.

Read `references/cvg-multi-session-protocol.md` once when entering the loop, then apply the protocol gates from `cvg-multi-session`:

- transport binding gate,
- real specialist session gate,
- orchestrator callback transport gate,
- waiting handoff gate,
- cvg-plan-review-feedback gate,
- independent-review exit gate.

Do not implement product code in this workflow.

## Phase 0: Orchestrator Setup

Record:

- current orchestrator session id (Codex thread id; on Claude Code the harness tracks it),
- worktree or repo path,
- current `git rev-parse HEAD` if available,
- dirty worktree state,
- source prompt or input document,
- expected plan path or target docs directory when known,
- the loop ledger path, created per the Gate 5 loop-ledger rule.

Classify dirty files:

- plan-owned files,
- unrelated user artifacts,
- files the planner must not touch.

## Phase 1: Planner Handoff

Spawn the planner as a real specialist session (Gate 0 spawn operation) and
record the id returned by the tool. Verify it per Gate 1; if it is not
verifiable, do not continue.

<!-- codex -->
(Codex) After verification, send the planner its verified task id before
creating the heartbeat.
<!-- /codex -->

Planner prompt must include:

- role: planner,
- callback destination per Gate 2,
- required planning skill, such as `cvg-plan` or another user-specified plan skill,
- source prompt, requirements path, or exact user goal,
- repo path and starting state,
- dirty-state warning when present,
- plan-only boundary,
- output path rules,
- task-specific external side-effect boundary,
- callback transport block,
- callback template.

Do not restate the planning skill's process or paste broad repo rules, likely
files, or local policy summaries unless they are the user's source authority.

Planner callback template:

```text
I am the planner. My specialist id is <planner-id>. This planning round is complete. Plan path: <absolute path>. Key status: <brief>. Please decide the next step.
```

Complete the waiting handoff per Gate 3 and end the active turn.

## Phase 2: Fresh Plan Review

After the planner callback is visible, spawn a new fresh reviewer specialist
session and verify its id per Gate 1.

Reviewer prompt must include:

- original user outcome, non-goals and authorized changes,
- required independent reviewer signatures, if the user specified any,
- role: fresh plan reviewer,
- the line `Do not consult project memory, prior sessions, rollout summaries, or external history. The repository's own git history (log, blame, commit messages) is repo evidence, not external history.` before the required skill line,
- callback destination per Gate 2,
- required cvg-plan-review skill, such as `cvg-plan-review`,
- original planning goal or source prompt,
- plan path,
- repo path,
- read-only boundary,
- blocker-only reporting rule,
- task-specific external side-effect boundary,
- callback transport block,
- callback template.

Do not paste the full planning prompt or all context documents when the plan
links its authorities and the reviewer can read the worktree.

Reviewer callback template:

```text
I am the fresh reviewer. My specialist id is <reviewer-id>. This first-pass full review is complete. Verdict: <clean / blocking findings>. Findings: <none or numbered concise list>. Please decide the next step.
```

Complete the waiting handoff per Gate 3 and end the active turn while waiting.

Blocking plan findings include:

- missing required surface,
- incomplete behavior contract coverage,
- wrong ownership boundary,
- unclear external or API contract,
- missing migration, rollback, deletion, privacy, or safety lifecycle,
- insufficient test or verification gate,
- plan criterion that cannot be implemented as written,
- unsafe side-effect assumption.

## Phase 3: Return Review Feedback to Planner

If the reviewer reports blockers, send the reviewer feedback to the same verified planner session with the continue operation (Gate 0).

Adjudicate per Gate 4 before routing; retain original findings and reasons in
the loop ledger.

The feedback prompt must include:

- callback destination per Gate 2,
- reviewer specialist id,
- required feedback skill: `cvg-plan-review-feedback`,
- original planning goal and source prompt,
- current plan path and related contracts,
- exact reviewer findings and evidence-based adjudications under a
  `Plan Review Feedback Input` section,
- task-specific external side-effect boundary,
- callback transport block,
- callback template.

Do not restate the feedback skill's intake, classification, or revision rules.

Complete the waiting handoff per Gate 3 and end the active turn.

## Phase 4: Focused Re-Review

After the planner feedback callback is visible and a reviewable plan revision exists, send a focused re-review request to the same verified reviewer session with the continue operation.

Focused scope:

- verify old blockers were addressed,
- check directly related contradictions introduced by the revision,
- do not redo broad review unless the plan's core design changed.

The focused re-review prompt must include the callback
transport block and exact callback template.

Complete the waiting handoff per Gate 3 and end the active turn.

If the planner reports a contract decision, escalation, or clarification need, route that callback to the appropriate reviewer or user decision before requesting re-review.

If same reviewer still finds blockers, repeat Phase 3.

If the same reviewer passes, evaluate completion in Phase 5.

## Phase 5: Review Exit

Apply Gate 5 for completion, new full-review conditions, adjudications and the
original repair-round cap. When another full review is warranted, use the
Phase 2 prompt and verify the new specialist identity. Carry non-blocking P2
notes into the completion summary.

## Completion Summary

Report:

- plan path,
- planner specialist id,
- reviewer specialist ids,
- callback transport status,
- blockers and planner `cvg-plan-review-feedback` results,
- independent review verdict and focused rechecks,
<!-- codex -->
- heartbeat cleanup (Codex),
<!-- /codex -->
- known gaps.

Versions

RepositoryScoreLicence
This page · gomilesf/convergo100MIT
gomilesf/convergo100MIT
gomilesf/convergo100MIT

Database snapshot: 13.11.2026 · package version b299203f4837 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100cvg-build-loop
    Orchestrate a monitored implementation loop where a worker implements the plan and independent code review with focused rechecks gates completion. Use when the user asks to run a supervised implementation or build loop on Codex threads or Claude Code background agents.
  • 100cvg-build-loop
    Orchestrate a monitored implementation loop where a worker implements the plan and independent code review with focused rechecks gates completion. Use when the user asks to run a supervised implementation or build loop on Codex threads or Claude Code background agents.
  • 100codex-claude-loop
    Use when driving a gated build loop where Claude orchestrates and Codex CLI implements — Claude plans and judges, Codex plans/implements from a persistent thread, with approve-the-plan and review-the-diff gates that refuse to be skipped. For delegating serious multi-file work to…
  • 90build-loop-claude-code
    Use when building features with **Claude Code** in any codebase and the work should go through a disciplined build → review → test → fix loop. Triggers on "run the build loop", "build the next task", "continue the plan", "build this feature properly", or any request to implement…
  • 90build-loop-codex
    Use when building features with **Codex** (OpenAI Codex CLI) in any codebase and the work should go through a disciplined build → review → test → fix loop. Triggers on "run the build loop", "build the next task", "continue the plan", "build this feature properly", or any request…
  • 100codex-review
    Use when you want an independent Codex review of a plan, spec or code change at a major checkpoint or before merging, when asked for a "codex review" or "second opinion", or before writing `codex exec` by hand.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.