Plan

Overview

Draft structured plans that clarify intent, scope, requirements, action items, testing/validation, and risks.

Optionally, save plans to disk as markdown files with YAML frontmatter and free-form content. When drafting in chat, output only the plan body without frontmatter; add frontmatter only when saving to disk. Only write to the plans folder; do not modify the repository codebase.

This skill can also be used to draft codebase or system overviews.

Core rules

• Resolve the plans directory as $CODEX_HOME/plans or ~/.codex/plans when CODEX_HOME is not set.
• Create the plans directory if it does not exist.
• Never write to the repo; only read files to understand context.
• Require frontmatter with only name and description (single-line values) for on-disk plans.
• When presenting a draft plan in chat, omit frontmatter and start at # Plan.
• Enforce naming rules: short, lower-case, hyphen-delimited; filename must equal <name>.md.
• If a plan is not found, state it clearly and offer to create one.