gemini-plan-phase

Generates interface-freeze and swim-lane implementation plans for roadmap phases targeting Gemini execution.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a roadmap phase into an executable implementation plan is error-prone: lanes overlap on shared files, verification commands go unspecified, and downstream executors fail on under-declared file ownership. This Skill converts a phase from a versioned phase roadmap spec into a validated, execution-ready lane plan for Gemini. ## Core Features & Use Cases - Interface Freeze Gates: Defines exact symbols, schemas, commands, and endpoint shapes as checkable gates before implementation begins. - Disjoint Lane Decomposition: Splits work into swim lanes with complete owned-file sets (tests, snapshots, lockfiles, migrations), acyclic dependencies, and explicit provided/consumed interfaces. - Contract Validation: Validates dispatch hints, execution policy literals, spec-closeout sections, and acceptance criteria against the shared phase-loop protocol before writing the plan artifact. - Use Case: Given specs/phase-plans-v2.md, produce plans/phase-plan-v2-FOUND.md with lane DAG, verification commands, and EC-referenced acceptance criteria ready for gemini-execute-phase. ## Quick Start Ask the planner to plan the FOUND phase from specs/phase-plans-v2.md into an execution-ready lane plan for Gemini.

Frequently Asked Questions about gemini-plan-phase

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

FAQPage Schema
How do I generate an implementation plan from a roadmap phase?▼

Point the planner at a versioned roadmap like specs/phase-plans-v*.md and select a phase by alias, number, or name. It researches the repo, defines interface freeze gates, decomposes disjoint lanes, and writes plans/phase-plan-<VERSION>-<PHASE_ALIAS>.md.

What is a swim-lane plan with interface freeze gates?▼

A swim-lane plan splits a phase into lanes with one-sentence scope, disjoint owned files, and explicit provided/consumed interfaces. Interface freeze gates pin exact symbols, schemas, or endpoint shapes so downstream executors build against stable contracts.

Why does plan execution fail with overlapping_write_ownership?▼

The lane-IR validator refuses execution when two lanes in the same wave own the same file. Fix it by moving shared files into a preamble lane or collapsing the overlapping lanes into one before emitting the plan.

Can the planner run tests or builds during planning?▼

No. Planning-only runs must not execute tests, builds, formatters, migrations, or verification commands; they are listed in the lane plan instead. Validation runs only when the user explicitly asks for it.

Does it support Gemini subagents for parallel planning work?▼

Subagents are used only when the user explicitly requests delegation and the Gemini CLI session exposes a suitable mechanism. Read-only agents handle reconnaissance; implementation agents get bounded tasks, never the planning synthesis itself.