llmlb: Skill for Codex

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.
• Allow overview-style plans that document flows, architecture, or context without a work checklist.

Decide the task

1. Find/list: discover plans by frontmatter summary; confirm if multiple matches exist.
2. Read/use: validate frontmatter; present summary and full contents.
3. Create: inspect repo read-only; choose plan style (implementation vs overview); draft plan; write to plans directory only.
4. Update: load plan; revise content and/or description; preserve frontmatter keys; overwrite the plan file.
5. Delete: confirm intent, then remove the plan file if asked.

Plan discovery

• Prefer scripts/list_plans.py for quick summaries.
• Use scripts/read_plan_frontmatter.py to validate a specific plan.
• If name mismatches filename or frontmatter is missing fields, call it out and ask whether to fix.

Plan creation workflow

1. Scan context quickly: read README.md and obvious docs (docs/, CONTRIBUTING.md, ARCHITECTURE.md); skim likely touched files; identify constraints (language, frameworks, CI/test commands, deployment).
2. Ask follow-ups only if blocked: at most 1-2 questions, prefer multiple-choice. If unsure but not blocked, state assumptions and proceed.
3. Identify scope, constraints, and data model/API implications (or capture existing behavior for an overview).
4. Draft either an ordered implementation plan or a structured overview plan with diagrams/notes as needed.
5. Immediately output the plan body only (no frontmatter), then ask the user if they want to 1. Make changes, 2. Implement it, 3. Save it as per plan.
6. If the user wants to save it, prepend frontmatter and save the plan under the computed plans directory using scripts/create_plan.py.