jp-plan

Automates Git-based .plans phase directory creation with sequential numbering and metadata files.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/jinglemansweep/agent-resources --skill jp-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jp-plan
Source: https://github.com/jinglemansweep/agent-resources/tree/main/plugins/jplan/skills/jp-plan
Command: npx skills add https://github.com/jinglemansweep/agent-resources --skill jp-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the creation of datestamped planning phase directories with sequential numbering for consistent project planning.

Core Features & Use Cases

  • Creates .plans/YYYY/MM/DD/NN-<slug> phase directory with nested reviews and cycle folders
  • Generates a slug from the description, creating a concise, filename-friendly phase name
  • Generates prompt.md template with sections for Overview, Goals, Requirements, Constraints, Out of Scope, and References
  • Initializes state.yaml with status and branch tracking
  • Integrates with git by recording the active branch and providing a ready-to-run workflow

Quick Start

Run /jp-plan <description> to create a new planning phase.

Frequently Asked Questions about jp-plan

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

FAQPage Schema
How do I create datestamped planning phase directories for a Git-based project?

To create datestamped planning phase directories, use a dedicated command to generate a .plans/YYYY/MM/DD/NN-<slug> folder structure. This automatically creates nested reviews and cycle folders, initializes a prompt.md template, and sets up state.yaml with active branch tracking.

What is the best way to automate project planning phase management with sequential numbering?

Automating project planning phase management involves generating sequentially numbered, datestamped directories within a .plans folder. This workflow derives a filename-friendly slug from your description, creates a prompt.md skeleton, and initializes state.yaml for status tracking.

Does this planning workflow integrate with Git branches?

Yes, this planning workflow integrates with Git by recording the active branch for each phase. It initializes a state.yaml file during directory creation to track the branch and current status, ensuring your planning phases align with your version control strategy.

What sections are included in the generated prompt.md template for project planning?

The generated prompt.md template includes sections for Overview, Goals, Requirements, Constraints, Out of Scope, and References. This skeleton provides a standardized structure to document the objectives and boundaries of each planning phase.

How do I initialize a new planning phase from a text description?

To initialize a new planning phase from a text description, run the plan command followed by your description. The system generates a concise slug from the text, creates the datestamped phase directory, and populates it with a prompt.md template and state.yaml file.

Do I need a specific directory structure to use automated phase management?

You need a Git-based project utilizing a .plans directory structure. The automation creates nested YYYY/MM/DD/NN-<slug> phase folders containing reviews and cycle subfolders, requiring no additional dependencies to generate the phase directories and tracking files.