Codex Deep Planning Orchestrator

Deprecated for GPT-5.6 Sol. Use native Codex Plan Mode, with focused verification or adversarial review skills when needed. Do not use this package for new work.

Overview

Run a Codex-native deep planning protocol that adapts to software with Git, software without Git, business artifact work, and mixed business-coding projects. Produce durable planning artifacts, proof criteria, and a reviewed execution strategy before implementation.

Core Contract

• Treat the user's invocation text as the planning objective.
• Create or reuse the target project's .deep-planning/ workfolder.
• During planning, do not edit implementation files. Allowed planning writes are .deep-planning/, .ultraplan/plan.md, approved design/plan docs, CONTEXT.md, and accepted ADRs.
• Every phase updates .deep-planning/state.md.
• Every phase ends with exactly one status: READY_FOR_PROCEED, BLOCKED_NEEDS_USER_DECISION, BLOCKED_BY_MISSING_EVIDENCE, or FAILED_VALIDATION.
• Stop at explicit proceed gates. Continue only after the user says PROCEED or gives equivalent explicit approval.
• Use companion skills when available: $repo-map-codex, $verification-plan-codex, $adversarial-plan-review-codex, $grill-with-docs-codex, $grill-me-codex, $handoff-codex, $ultraplan-codex, superpowers:brainstorming, superpowers:systematic-debugging, superpowers:writing-plans, and superpowers:verification-before-completion. If unavailable, perform the same behavior locally.
• Use Codex subagents only when explicitly allowed by the user or current session instructions. Otherwise perform bounded local exploration and review.