plan

Create a new planning item (bug, feature, chore, or todo) as a markdown file inside docs/plan/. Use this whenever the user wants to track a new bug, feature, todo, follow-up, issue, or piece of deferred work in their repo — including phrases like "log this", "track this", "remember to", "I need to fix", "open an issue for", or any "we should do X later" request. Auto-initializes docs/plan/ if it doesn't exist yet.

Close (mark done) a planning item in docs/plan/. Use whenever the user finishes work on a tracked bug/feature/chore/todo — phrases like "I fixed it", "that's done", "ship that off", "close item 7", "mark X complete", "wrap up the search ticket" all trigger this. Sets status to done and stamps the closed date. The file is not deleted or moved — closed items stay in docs/plan/ as the history record.

Bootstrap a docs/plan/ folder in the current repo for tracking bugs, issues, chores, and todos as markdown files. Use this whenever the user wants to start a lightweight planning system, set up local issue tracking inside a repo, or asks for a "plan folder" / "todo tracker" / "issues directory" — even before they've used any other /plan-* command. /plan-add will auto-init if missing, so this command is primarily for explicit setup.

List planning items in docs/plan/, optionally filtered by status, type, priority, due date, or tag. Use whenever the user wants to see open issues/bugs/todos, check the status of planned work, find overdue items, or get an overview of what's in the plan folder. Phrases like "what's open", "what's due", "show me bugs", "list todos", "what's in the plan", "show overdue work" all trigger this. The default view hides done items.

Update an existing planning item in docs/plan/ — change its status, priority, due date, type, tags, or append a dated note. Use whenever the user wants to mark something in-progress, change a deadline, raise/lower priority, unblock something, retitle, or add a comment/note to a tracked item. Accepts either the numeric ID or a slug fragment from the title. Phrases like "start work on 7", "push X to next week", "mark item Y blocked", "add a note to the search ticket" all trigger this.