plan

Manage Codex plan documents stored under CODEX_HOME/plans.

Updated Aug 8, 2025
One-click install
npx skills add https://github.com/ale-alfaro/dotfiles --skill plan-ale-alfaro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/ale-alfaro/dotfiles/tree/main/common/.config/codex/skills/.system/plan
Command: npx skills add https://github.com/ale-alfaro/dotfiles --skill plan-ale-alfaro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Plan lifecycle management for Codex plans on disk, enabling creation, retrieval, updates, deletions, and organized storage for implementation work or reference documentation.

Core Features & Use Cases

  • Create, read, update, delete, and stash plan documents as frontmatter metadata stored under CODEX_HOME/plans (default ~/.codex/plans).
  • Keep plans centralized for project planning, architecture notes, and process-overview documentation; supports both implementation and overview plans.
  • List, find, and reference plans via dedicated scripts to validate frontmatter and discover plan metadata.

Quick Start

Stash a new plan by providing its name, description, and body to store the frontmatter under CODEX_HOME/plans.

Frequently Asked Questions about plan

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

FAQPage Schema
How do I manage project plan documents with frontmatter in Codex?

Plan management for Codex plans handles creating, reading, updating, and deleting plan documents stored under CODEX_HOME/plans. Each plan uses frontmatter metadata with required name and description fields, defaults to ~/.codex/plans, and supports implementation or reference documentation.

What's the best way to organize markdown project plans centrally on disk?

Centralizing markdown project plans is handled by storing them as frontmatter documents under CODEX_HOME/plans. This approach keeps architecture notes and implementation work organized, allowing dedicated scripts to list, find, and validate plan metadata efficiently.

Can I stash and retrieve implementation plans using markdown frontmatter?

Yes, you can stash implementation plans by providing a name, description, and body to store frontmatter metadata under CODEX_HOME/plans. Dedicated scripts then validate frontmatter and discover plan metadata to retrieve, read, or update the documents.

Does Codex plan management require specific dependencies to store documents?

No dependencies are required to use Codex plan management for storing documents. The system operates independently using scripts to manage plan files with frontmatter metadata, defaulting to the ~/.codex/plans directory without needing external packages.

How do I find and validate existing plan metadata in CODEX_HOME/plans?

Finding and validating existing plan metadata in CODEX_HOME/plans is done via dedicated scripts. These scripts list, find, and reference plans by validating the required frontmatter fields, ensuring name and description metadata are correctly structured.

When should I use frontmatter plan files instead of standard markdown documentation?

Frontmatter plan files should be used when you need structured lifecycle management for implementation work or overview reference. Unlike standard markdown, they enforce required name and description metadata, enabling programmatic discovery, validation, and organized storage under CODEX_HOME/plans.