codex-plan-detailed

Generates a bounded implementation plan for one bug fix, feature, or refactor.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a vague change request into an immediately implementable plan requires repo research, scoping discipline, and explicit verification criteria, which developers often skip or do inconsistently. ## Core Features & Use Cases - Bounded Planning: Researches the repository with local tools (rg, git status, targeted reads) and produces a plan listing every file, entity, action, and reason for a single bounded change. - Verification Contract: Every plan includes machine-checkable verification commands and testable acceptance criteria, with support for referencing roadmap goal IDs like EC-<ALIAS>-<N>. - Handoff & Manifest Integration: Writes plan artifacts, handoff files, reflections, and appends entries to plans/manifest.json via the phase_loop_runtime helpers. - Use Case: A developer asks for a plan to fix a specific bug; the skill inspects the relevant files, proposes the smallest coherent change set, documents docs impact, and lists the exact test commands that prove the fix. ## Quick Start Ask the agent to create a detailed implementation plan for a specific bug fix or small feature, for example: plan the change to add retry logic to the HTTP client module.

Frequently Asked Questions about codex-plan-detailed

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

FAQPage Schema
How do I create a detailed implementation plan for a bug fix?▼

Invoke the skill with a clear task description; it researches the repo with git status, git log, and targeted rg searches, then writes a plan listing every file change, verification commands, and testable acceptance criteria. The default output path is plans/detailed-<slug>-<timestamp>.md.

When should I use a detailed plan instead of a phase roadmap?▼

Use a detailed plan when one developer or one Codex thread should do the work end to end for a single bounded change. The phase roadmap pipeline is for multi-phase initiatives; this skill deliberately keeps scope under roughly 8 source files or 3 distinct changes.

Does the planning skill run tests or builds while planning?▼

No. In planning-only runs it does not execute tests, builds, formatters, or generators; it lists the verification commands in the plan instead. Commands run only when the user explicitly asks for validation or execution.

Can the plan reference roadmap acceptance criteria?▼

Yes. If the bounded change implements a roadmap phase goal, the plan references its EC-<ALIAS>-<N> identifier with the proving command instead of restating the criterion. Standalone changes use plain testable assertions.

What artifacts does the planning workflow produce?▼

It produces the plan markdown file, a repo-local handoff under .dev-skills/handoffs/codex-plan-detailed, a reflection for non-trivial runs, and a best-effort entry appended to plans/manifest.json via phase_loop_runtime.plan_manifest.