# Spec Planner

> Use when `spec.md` is ready but `plan.md` is missing, incomplete, risky, or not execution-ready.

- Skill: `shaowei-g/spec-planner` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add shaowei-g/spec-planner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shaowei-g/spec-planner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: shaowei-g (https://skillmd.com/u/shaowei-g)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/shaowei-g/spec-planner

---


# Spec Planner

Use this skill when planning is the current phase for one feature.

## Shared Contracts

Load this shared shortcut first:

- `../references/shared-specialist-contract.md`

Open the deeper canonical shared references only when the shortcut is insufficient for the current situation.

## Purpose

Use this skill when at least one is true:

- `spec.md` is ready and `plan.md` does not exist
- `plan.md` exists but is incomplete or risky
- architecture, interfaces, dependencies, risks, or verification strategy must be defined without decomposing tasks
- a later artifact depends on an incomplete plan and routing must move backward

## Read Order

- `.codex/prompts/speckit.plan.md` first
- `.codex/prompts/speckit.constitution.md` if present
- `specs/<feature>/spec.md`
- `specs/<feature>/plan.md` if present
- related implementation context only when needed to keep the plan realistic

## Owned Outputs

- `plan.md`
- plan-level architecture and dependency decisions
- implementation-ready approach notes for the assigned feature

## Phase-Specific Rejected Criteria

Return `rejected` if `spec.md` is missing, materially ambiguous, or not ready enough to support planning.

## Phase-Specific Blocked Criteria

Return `blocked` if technical constraints, interfaces, or dependencies required to produce a viable plan are unavailable.