Checklist

Checklist

Your task

Convert the most recent structured content in this conversation (plan, code review, task list, implementation steps, etc.) into a markdown checklist file saved to the project.

Instructions

1. Identify the content

Look at the current conversation context. Find the most recent plan, code review, implementation steps, or other structured content. This is what you will convert.

2. Generate a name

Derive a short, descriptive kebab-case name from the content's topic (e.g., auth-refactor, api-migration, payment-integration). The file will be saved as .claude/plans/<name>-checklist.md.

3. Check for existing file

Before writing, check if .claude/plans/<name>-checklist.md already exists. If it does, ask the user whether to overwrite, choose a different name, or cancel. Do NOT proceed without their answer.

4. Determine the right checklist granularity

Before converting, assess what level the checkboxes should be at:

• If the content is a plan from plan mode (generated by you): Keep the plan's text exactly as-is. Do not rewrite, summarize, rephrase, or restructure anything. Only add - [ ] markers to the major implementation sections/steps — NOT to every tiny sub-step within them. The user has already reviewed and approved this plan; your job is only to make it trackable.
• If the content is a plan that already has clearly defined large steps/sections: Add - [ ] markers at the level of those large steps. Do not break them down further into micro-checkboxes.
• If the content is a general task list or unstructured content without clear section breaks: Ask the user how they'd like it broken up before proceeding. Do NOT guess or create your own granularity.

5. Convert to checklist format

Transform the content into a checklist file following these rules:

• Preserve the original text exactly — keep all headings, sections, groupings, nesting, ordering, and wording intact. Do not rewrite, summarize, or rephrase any content.
• Only add - [ ] checkbox markers to the top-level actionable sections identified in step 4
• Keep non-actionable text (descriptions, context, rationale, sub-details within a section) as-is without checkboxes
• Maintain heading hierarchy (##, ###, etc.) exactly as in the original
• If items already have bullet points or numbered lists within a section, leave them as-is (they are detail under the checkboxed section, not separate checklist items)
• Nested checkboxes (e.g., - [ ]) should only be used if the original content had an explicit multi-level structure with distinct phases/sub-phases

6. Add the tracking header

Add this exact block at the very top of the file, before any other content:

<!-- CHECKLIST INSTRUCTIONS
IMPORTANT: When working on items in this checklist, you MUST check off each item
(change `- [ ]` to `- [x]`) AS SOON AS it is implemented/completed.
Do not wait until the end — check off each item immediately after finishing it.
This file is the source of truth for tracking progress.
-->

7. Ensure the directory exists

Create .claude/plans/ if it doesn't already exist.

8. Write the file

Save the checklist to .claude/plans/<name>-checklist.md.

9. Confirm

Tell the user the file path and a brief summary of what was captured. Remind them that items will be checked off as they are completed.