claude-code-plan-critique

You are archiving the user's completed (or abandoned) plan for future reference.

To do this, follow these steps precisely:

1. Read .claude/plan-critique-config.json and get plansFolder path from settings.

If the file doesn't exist or plansFolder is not set: Respond with "No plans folder configured. Run /plan:create first to set up."

1. Get the Claude Code process ID by running: echo $PPID. Store this as sessionPID.
2. Clean up stale sessions: Scan [plansFolder]/.sessions/ for files. For each file named with a PID, check if that

process is still running via kill -0 [PID] 2>/dev/null. If the command fails (process not running), delete that session file. This is non-blocking cleanup.

1. Read the current session's plan from [plansFolder]/.sessions/[sessionPID] if it exists. Store as sessionPlan.
2. Scan [plansFolder]/ for subdirectories (each subdirectory is a plan).

Exclude archived/ and .sessions/ folders and any files, only list plan directories. If no plan folders exist: Respond with "No plans found. Nothing to archive."

1. Select the plan to archive:
2. If sessionPlan exists and matches a plan folder, auto-select it. Inform the user:

"Using current session plan: [sessionPlan]"

• Else if only one plan exists, auto-select it and inform user.
• Otherwise, ask the user to select a plan from the list.

Example: ``` Available plans:

1. add-user-authentication
2. refactor-database-layer
3. implement-caching

Which plan would you like to archive? [1-3] ```

1. Check prerequisites. If [plansFolder]/[selected-plan]/plan.md does not exist or is empty:

Respond with "Nothing to archive. Plan file is missing or empty."

1. Ensure [plansFolder]/archived/ exists, create it if not.
2. Extract metadata:
3. Read plan.md to get the plan title (first H1 heading). If no title, use folder name.
4. Read critique.md to get keywords (if available)
5. Read execution-log.md to get execution status (if available)
6. Generate archive folder name using format: YYYY-MM-DD_HH-MM-SS_[slug]/

Example: 2026-01-12_14-30-00_add-user-authentication/

1. Create the archive folder at [plansFolder]/archived/[folder-name]/
2. Copy contents from [plansFolder]/[selected-plan]/ to the archive:
3. Include: plan.md, execution-log.md (if exists), all other files (SQL, images, etc.)
4. Exclude: critique.md, execution-state.json
5. Create archive-info.md in the archive folder using the format in

[archive-info-format.md](archive-info-format.md).

1. Delete the original plan folder [plansFolder]/[selected-plan]/ entirely.
2. Clean up session references to the archived plan:
3. Delete [plansFolder]/.sessions/[sessionPID] if it contains the archived plan slug.
4. Scan all other session files and delete any that reference the archived plan (handles stale references).
5. Respond with confirmation:

``` Plan archived to: [plansFolder]/archived/[folder-name]/

The original plan folder has been removed. Create a new plan with /plan:create. ```

Notes:

• Never include critique.md in the archive (only keywords are preserved in archive-info.md)
• Always include the full original plan and all supporting files
• Include execution log only if the plan was executed
• Use current timestamp for the archive folder name
• Preserve the original file structure within the archived folder
• Always delete the original plan folder after archiving
• It is valid to archive a plan that was never executed (abandoned, reference, or superseded plans).

In this case, the execution status will be NOT_EXECUTED.