LevNas/plan-task

Plan & Task Persistence

Goal

Maintain plans and task progress across Claude Code sessions so that work can be resumed without losing context.

Execution

Delegate the plan/task work to a Sonnet subagent to minimize main context consumption.

1. Determine the operation mode from user input or session context
2. Prepare structured input fields for the subagent
3. Spawn a subagent with the following configuration:

Agent(
  subagent_type: "general-purpose",
  model: "sonnet",
  description: "plan and task management",
  prompt: |
    You are a plan and task management agent. Read the procedure file and follow it precisely.

    ## Operation
    {mode}

    ## Input
    ### what（事実）
    {what}

    ### why（判断理由）
    {why}

    ### context（背景情報）
    {context}

    ### tags_hint（推奨タグ）
    {tags_hint}

    ## Instructions
    1. Read the procedure file at: {plugin_root}/skills/plan-task/procedure.md
    2. Execute the procedure section matching the operation mode: {mode}
    3. The project root is: {project_root}
    4. The tasks directory is: {project_root}/.claude/tasks/
    5. For setup, asset files are at: {plugin_root}/skills/plan-task/assets/
    6. Return: operation performed, files created/modified, current plan status, and knowledge candidates (if any)
)

Replace the placeholders:

• {mode} — one of: session-start, create-plan, update-progress, revise-plan, pause, complete
• {what} — the factual situation (e.g., "user wants to create a plan for Docker migration" or "three tasks completed, one blocker found")
• {why} — why this operation is needed now (e.g., "new session started, need to check for incomplete work")
• {context} — relevant background (current branch, related issues, recently modified files, active plan slug if known)
• {tags_hint} — recommended tags for any knowledge entries that may be created (especially relevant for complete mode)
• {plugin_root} — the plugin's installation path (shown in the skill loading message as "Base directory for this skill")
• {project_root} — the project working directory

4. Report the subagent's result to the user (operation performed, files modified, current status)
5. If the subagent returns knowledge candidates (typically from complete mode), invoke record-knowledge for each candidate using the structured fields provided

IMPORTANT: The procedure file path uses the plugin's base directory, NOT the project directory. Read the "Base directory for this skill" line from the skill loading message to determine the correct path.

Mode Selection Guide

| User signal | Mode | |---|---| | Session just started / post-compaction / resume | session-start | | "plan ...", "let's plan ...", "create a plan for ..." | create-plan | | "progress update", "update progress", signals a break | update-progress | | "revise the plan", "the approach needs to change" | revise-plan | | "taking a break", "that's it for today", "pausing" | pause | | "plan is done", "all tasks complete", "wrap up" | complete |