plan-create

name	plan:create
allowed-tools	Read, Write, Edit, Glob, AskUserQuestion, Bash(mkdir:*), Bash(echo $PPID), Bash(rm:*)
description	Create a new plan folder with a plan.md template
argument-hint	["plan name"]

You are creating a new plan folder for the user.

Fixed rules:

Read the working agreement at working-agreement.md before step 1 and follow it for the whole run. If that path does not resolve, look for working-agreement.md in the project root, then in .gemini/. If it cannot be found anywhere, tell the user it is missing and apply the rules listed below.

These rules bind this phase and override any step below that conflicts with them:

1. Ask clarifying questions up front when the request is ambiguous. Do not guess the plan name, the plans folder, or what the user means. Guessing here produces the wrong plan.
2. Do not write, edit, or refactor any project code during this phase. This phase produces a plan folder and a plan.md and nothing else.
3. The plan is not finished until it lists its affected files and how success will be verified. The template carries both sections, so do not remove them when filling it in.
4. Be brief. No filler, no preamble, no restating the request. No emojis, no em dashes, no decorative icons.

To do this, follow these steps precisely:

1. Display the following banner before doing anything else:

   +-------------------------------------------------+
   |  Plan Critique v2.3.0 - Creating new plan       |
   +-------------------------------------------------+
   

2. Read .claude/plan-critique-config.json and get plansFolder path from settings. If the file doesn't exist or plansFolder is not set:
   • Ask the user: "Where would you like to store your plans? Provide a folder path (default .planning):". By default, the user should be presented with the option .planning.
   • Save the path as plansFolder in .claude/plan-critique-config.json
   • Create the folder if it doesn't exist
   • Create an archived/ subfolder inside it
3. Determine the plan name:
   • If a name was passed as an argument, the text in $ARGUMENTS is the plan name. Use it directly.
   • Otherwise, ask the user directly, do not offer predefined options like "New Feature" or "Bug Fix" because the plan name must be unique: "Enter a name for this plan:" The plan name must have at least 3 characters. If it is empty or shorter, respond with "Plan name must be at least 3 characters." and ask the user to enter one.
4. Generate a slug from the plan name:
   • Convert to lowercase
   • Replace spaces with hyphens
   • Remove characters that are not alphanumeric or hyphens
   • Trim to max 50 characters
   • Example: "Add User Authentication" becomes add-user-authentication
5. Check if [plansFolder]/[slug]/ already exists. If it does: Respond with "A plan with this name already exists at [plansFolder]/[slug]/. Choose a different name." Ask for a new name and repeat from step 4.
6. Create directory [plansFolder]/[slug]/
7. Link this session to the new plan:
   • Get the Claude Code process ID by running: echo $PPID
   • Create the sessions directory if needed: [plansFolder]/.sessions/
   • Write the slug to [plansFolder]/.sessions/[PID] (plain text, just the slug)
8. Create the plan template at [plansFolder]/[slug]/plan.md using the template in plan-template.md.
9. Respond with confirmation:

   Created new plan: [plansFolder]/[slug]/
   Edit your plan at: [plansFolder]/[slug]/plan.md
   When ready, run `/plan:critique` to review your plan.
   

Notes:

• The slug must be filesystem-safe (no special characters)
• Keep the original plan name with proper casing in the H1 heading of plan.md
• Only create plan.md initially (critique.md is created by /plan:critique)
• Always use plansFolder from settings as the base directory