# Plan File Management > Guidelines for structural operations on plan files (renumbering). Claude should use this skill when the user asks to renumber or fix numbering in a plan file, or after inserting, deleting, or reordering threads/tasks. - Skill: `majiayu000/plan-file-management` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds add majiayu000/plan-file-management` - Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/plan-file-management/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: majiayu000 (https://skillmd.com/u/majiayu000) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/majiayu000/plan-file-management --- # Plan File Management Structural operations on plan files such as renumbering threads and tasks. All operations are subcommands of the `i2code` CLI tool, invoked as: i2code plan [options] ## fix-numbering Renumber all threads and tasks sequentially. Run this after arbitrary edits made outside the script. i2code plan fix-numbering Run this after: - Inserting or deleting threads or tasks - Rearranging plan sections - When the user asks to renumber or fix numbering ## mark-task-complete Mark a task and all its steps as complete. Optionally appends to change history if rationale is provided. i2code plan mark-task-complete --thread --task [--rationale ] Errors if the task does not exist or is already complete. ## mark-task-incomplete Mark a completed task and all its steps as incomplete. The reverse of mark-task-complete. Optionally appends to change history if rationale is provided. i2code plan mark-task-incomplete --thread --task [--rationale ] Errors if the task does not exist or is already incomplete. ## reorder-threads Reorder threads according to a specified ordering, then auto-renumber all threads and tasks. i2code plan reorder-threads --order --rationale Example: `--order 3,1,2` moves thread 3 to position 1, thread 1 to position 2, thread 2 to position 3. Errors if `--order` does not contain exactly the set of existing thread numbers. ## insert-thread-before Insert a fully structured thread before a specified thread, then auto-renumber. i2code plan insert-thread-before --before --title --introduction <text> --tasks <json> --rationale <text> The `--tasks` argument is a JSON array of task objects (see spec for schema). ## insert-thread-after Insert a fully structured thread after a specified thread, then auto-renumber. i2code plan insert-thread-after <plan_file> --after <N> --title <title> --introduction <text> --tasks <json> --rationale <text> ## get-next-task Return the first uncompleted task across the plan, with full metadata and steps. Prints a message if all tasks are complete. i2code plan get-next-task <plan_file> ## list-threads Return all threads with their numbers, titles, and task completion counts. i2code plan list-threads <plan_file> ## get-summary Return the plan's name, idea type, overview, and progress (thread count, task count, completed task count). i2code plan get-summary <plan_file> ## get-thread Return a specific thread's full content including number, title, introduction, and all tasks with their metadata and steps. i2code plan get-thread <plan_file> --thread <N> Errors if the thread does not exist. ## mark-step-complete Mark a single step as complete. Appends to change history. i2code plan mark-step-complete <plan_file> --thread <N> --task <M> --step <S> --rationale <text> Errors if the step does not exist or is already complete. ## mark-step-incomplete Mark a single completed step as incomplete. The reverse of mark-step-complete. Appends to change history. i2code plan mark-step-incomplete <plan_file> --thread <N> --task <M> --step <S> --rationale <text> Errors if the step does not exist or is already incomplete. ## replace-thread Replace a thread's entire content (title, introduction, tasks) in place, then auto-renumber. i2code plan replace-thread <plan_file> --thread <N> --title <title> --introduction <text> --tasks <json> --rationale <text> Errors if the thread does not exist. ## insert-task-before Insert a task before a specified task within a thread, then auto-renumber tasks. i2code plan insert-task-before <plan_file> --thread <N> --before <M> --title <title> --task-type <INFRA|OUTCOME> --entrypoint <cmd> --observable <text> --evidence <cmd> --steps <json> --rationale <text> The `--steps` argument is a JSON array of step description strings. ## insert-task-after Insert a task after a specified task within a thread, then auto-renumber tasks. i2code plan insert-task-after <plan_file> --thread <N> --after <M> --title <title> --task-type <INFRA|OUTCOME> --entrypoint <cmd> --observable <text> --evidence <cmd> --steps <json> --rationale <text> ## reorder-tasks Reorder tasks within a thread according to a specified ordering, then auto-renumber tasks. i2code plan reorder-tasks <plan_file> --thread <N> --order <comma-separated-task-numbers> --rationale <text> Example: `--thread 1 --order 3,1,2` moves task 1.3 to position 1.1, task 1.1 to position 1.2, task 1.2 to position 1.3. Errors if `--order` does not contain exactly the set of existing task numbers in the thread, or if the thread does not exist. ## move-task-before Move a task to before another task within the same thread, then auto-renumber tasks. i2code plan move-task-before <plan_file> --thread <N> --task <M> --before <P> --rationale <text> Example: `--thread 1 --task 6 --before 3` moves task 1.6 to the position before task 1.3. Errors if the thread or either task does not exist, or if task and before are the same. ## move-task-after Move a task to after another task within the same thread, then auto-renumber tasks. i2code plan move-task-after <plan_file> --thread <N> --task <M> --after <P> --rationale <text> Example: `--thread 1 --task 1 --after 3` moves task 1.1 to the position after task 1.3. Errors if the thread or either task does not exist, or if task and after are the same. ## replace-task Replace a task's content in place within a thread, then auto-renumber tasks. Equivalent to delete-task followed by insert-task but atomic. i2code plan replace-task <plan_file> --thread <N> --task <M> --title <title> --task-type <INFRA|OUTCOME> --entrypoint <cmd> --observable <text> --evidence <cmd> --steps <json> --rationale <text> The `--steps` argument is a JSON array of step description strings. Errors if the thread or task does not exist. ## delete-task Remove a task from a thread, then auto-renumber remaining tasks. i2code plan delete-task <plan_file> --thread <N> --task <M> --rationale <text> Errors if the thread or task does not exist. ## delete-thread Remove a thread entirely, then auto-renumber remaining threads and tasks. i2code plan delete-thread <plan_file> --thread <N> --rationale <text> Errors if the thread does not exist.