plan

Manage Codex plan documents in CODEX_HOME/plans with YAML frontmatter.

3|Updated Jun 4, 2021
One-click install
npx skills add https://github.com/tizee/dotfiles --skill plan-tizee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/tizee/dotfiles/tree/main/claude/skills/.system/plan
Command: npx skills add https://github.com/tizee/dotfiles --skill plan-tizee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires plan_utils, and includes scripts (resource) components.

What problem does it solve?

Plan documents live on disk and need a lightweight workflow to create, read, update, and delete them without altering the repo.

Core Features & Use Cases

  • On-disk plans with YAML frontmatter (name and description)
  • Commands to stash, list, read, and update plans
  • Open questions/overview support for planning activities

Quick Start

Create or stash a plan using the included scripts to place markdown files into 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 create and manage plan documents on disk?

Create plan documents in CODEX_HOME/plans with YAML frontmatter (name and description fields). Use the included scripts to stash, list, read, update, and delete plans without altering your repository, keeping all plan files organized in a dedicated directory.

What frontmatter is required for plan documents?

Plan documents require YAML frontmatter with two mandatory fields: name and description. These fields enforce structure and are validated when creating or updating plans to ensure consistency across all plan documents stored on disk.

Can I use plan documents for both implementation and overview planning?

Yes, plan documents support both implementation plans and overview plans. The lightweight markdown-based workflow accommodates different planning activities while maintaining the same frontmatter constraints and on-disk storage rules.

How do I organize multiple plan documents in Codex?

All plan documents are stored in CODEX_HOME/plans following consistent naming rules. Use the list and stash commands to organize, locate, and manage multiple plans; the Skill automatically creates the plans directory if it doesn't exist.

What's the difference between creating and stashing a plan?

Creating a plan adds a new document to CODEX_HOME/plans with required frontmatter. Stashing moves or stores existing plan markdown into the plans directory while preserving its content and applying frontmatter constraints.