skills.rest
chdalski
chdalskiCOMMUNITY
Explore all skills by this author →
GitHub

ensure-plans-dir

Ensure the .ai/plans directory and CLAUDE.md guide match the canonical template.

7|1|Updated Feb 12, 2026
Search Tags:#template#claude#plans#directory#architect#format-guide
One-click install
npx skills add https://github.com/chdalski/claude_orchestration --skill ensure-plans-dir
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ensure-plans-dir
Source: https://github.com/chdalski/claude_orchestration/tree/main/blueprint_v2/.claude/skills/ensure-plans-dir
Command: npx skills add https://github.com/chdalski/claude_orchestration --skill ensure-plans-dir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents planning failures caused by a missing or inconsistent plan directory and format guide by ensuring the .ai/plans directory and its CLAUDE.md format guide are present and current before writing plans.

Core Features & Use Cases

  • Presence Check: Reads .ai/plans/CLAUDE.md to confirm the format guide exists.
  • Template Synchronization: Compares the guide to the canonical template at .claude/templates/plan-format.md and writes the template if the guide is missing or differs.
  • Context Loading: Loads the final CLAUDE.md content into context so the Architect and lead can write plans that follow the expected structure.
  • Use Case: Run at the start of Phase 1 planning to ensure all subsequent plan files are created in a consistent, machine-parseable format.

Quick Start

Run the ensure-plans-dir skill at the start of Phase 1 planning to create or refresh .ai/plans/CLAUDE.md from the canonical template and load it into context.

Frequently Asked Questions about ensure-plans-dir

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

FAQPage Schema
How do I ensure the .ai/plans directory exists and follows the correct format guide?▼

To ensure the .ai/plans directory exists and follows the correct format guide, run a directory presence check that synchronizes CLAUDE.md against the canonical template at .claude/templates/plan-format.md, loading the finalized guide into context for consistent planning.

Why do my Claude architect plans fail to parse consistently during Phase 1 planning?▼

Claude architect plans fail to parse consistently during Phase 1 planning when the .ai/plans directory is missing or its CLAUDE.md format guide is out of sync with the canonical template, preventing machine-parseable structure across generated plan files.

What is the best way to set up a machine-parseable plan directory for Claude?▼

The best way to set up a machine-parseable plan directory for Claude is to verify the directory presence and compare the existing CLAUDE.md guide against a canonical template, writing the template if differences are found before loading the format into context.

How do I sync my plan format guide with the canonical template?▼

To sync your plan format guide with the canonical template, compare the existing CLAUDE.md guide against .claude/templates/plan-format.md and write the canonical template directly to the .ai/plans directory if the guide is missing or differs.

When do I need to run a directory check for the .ai/plans format guide?▼

You need to run a directory check for the .ai/plans format guide at the start of Phase 1 planning, ensuring the Architect prepares plans that are stored and parsed consistently by verifying the canonical template before writing any plan files.

Related Skills

Explore More Software Engineering Skills→
joshribakoffjoshribakoff
2

plan-management

Organize project plans with standardized templates, numbering, and directory structure.

Community
Intermediate
BrunoAMSilvaBrunoAMSilva

update-implementation-plan

Generate and synchronize implementation plans from updated requirements.

Community
Advanced
hongbietcodehongbietcode
3

planning

Generate structured software project roadmaps with YAML frontmatter in plan.md.

Community
Basic
zhouboyu-xrealzhouboyu-xreal

excalidraw

Create and edit Excalidraw diagrams from JSON-formatted .excalidraw files.

Community
Basic