Agent skill

spec-planner

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

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/shaowei-g/codex-skills/tree/main/skills/spec-orchestrator/spec-planner

SKILL.md

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 with markerized front matter when safe to add or preserve
  • 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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

shaowei-g/codex-skills

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

0 0
Explore
shaowei-g/codex-skills

ekoen-frontend-code-review

Production-grade code review for the eKoEN frontend codebase. Use when asked to review, audit, inspect, or harden eKoEN React/Next.js frontend code, pages, components, hooks, API clients, or state layers for bugs, performance bottlenecks, TypeScript safety issues, request inefficiency, state-management risks, memory leaks, rendering regressions, error-handling gaps, duplication, or maintainability problems, especially when a structured severity-ranked report with code locations, root causes, suggested fixes, and example refactors is required.

0 0
Explore
shaowei-g/codex-skills

ekoen-backend.doc.route-error

Add HttpErrorRes responses to eKoEN backend routes when controllers can throw errors from app/util/errors/index.ts

0 0
Explore
shaowei-g/codex-skills

conventional-commit-helper

Generate and validate Conventional Commit messages for semantic-release workflows. Use when a user asks to write a commit message, asks to commit changes, asks for commit type/scope selection, or asks to enforce Conventional Commits consistency.

0 0
Explore
shaowei-g/codex-skills

codex-cli-subagent-transport

Use only when native subagent execution is unavailable and the caller needs one deterministic Codex CLI run with repo-local artifacts and a manifest-based result contract.

0 0
Explore
shaowei-g/codex-skills

skill-usage-logger

All skill MUST use this logger to record usage events in NDJSON format.Log Codex skill usage events to NDJSON with safe concurrent appends.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results