🧪 Test the New Session Management Features (Anthropic Patterns)

[OthmanAdi]

Help Us Test Session Management Features!

I've implemented session management patterns from Anthropic's article "Effective harnesses for long-running agents" in the feature/anthropic-patterns branch.

These features need testing before merging to main. Your feedback is critical!

---

What's New

1. Session Initialization Script

Run at the start of every session:

bash scripts/init-session.sh

What it does:

• ✅ Verifies planning files exist
• ✅ Shows current phase and git status
• ✅ Displays last commit
• ✅ Logs session start to progress.md
• ✅ Creates missing files if needed

2. Pass/Fail Status Tracking

Enhanced task_plan.md template with:

• Status icons: ⏸️ Pending | 🔄 In Progress | ✅ Pass | ❌ Fail | ⏭️ Skipped
• Test Results table for each phase
• Git Checkpoints table to log commits
• Phase Summary table for quick overview

3. Git Checkpoint Workflow

New documentation: docs/git-checkpoints.md

• "One phase, one commit" pattern
• Use git commits as rollback points
• Integrates with task_plan.md

4. Session-Start Verification

Automated checklist that verifies:

• Planning files present
• Git working tree clean
• Current branch status
• Last commit information

---

How to Test

1. Checkout the Branch

cd your-planning-with-files-repo
git fetch origin
git checkout feature/anthropic-patterns

2. Try It In a Test Project

cd ~/your-test-project
bash /path/to/planning-with-files/scripts/init-session.sh

3. Work Through a Multi-Phase Task

• Let the script create planning files
• Define some phases in task_plan.md
• Complete a phase and test it
• Mark it as ✅ Pass with test results
• Commit: git commit -m "feat(Phase 1): description"
• Log the commit hash in Git Checkpoints table
• Start a new session and run init-session.sh again

4. Read the Implementation Summary

See IMPLEMENTATION_SUMMARY.md in the branch for full details.

---

What We Need Feedback On

1. Does init-session.sh work on your system?

   • Unix/Mac: Does the bash script run smoothly?
   • Windows: Does the PowerShell version work?

2. Is the new task_plan.md template helpful?

   • Are the status icons clear?
   • Is the Test Results table useful?
   • Does the Git Checkpoints table make sense?

3. Does the workflow feel natural?

   • Plan → Implement → Verify → Commit
   • Does session recovery work when you restart?

4. Any bugs or issues?

   • Errors when running scripts?
   • Confusing documentation?
   • Missing features?

5. Suggestions for improvement?

   • What would make this better?
   • Any patterns from the Anthropic article we missed?

---

Related Issue

This work resolves Issue #19 requested by @wqh17101.

---

Documentation

• Git Checkpoint Workflow
• Implementation Summary
• Anthropic Article (inspiration)

---

Please test and share your experience! Once we have enough feedback and approval, I'll merge this to main.

Thank you!

Ahmad

[sukhmeet2390]

Will test it out. But the only reason i stick with this skill vs using get-shit-done is because I don't want it to do git commits.
Definitely helpful to run spawned tasks in parallel but Claude is over verbose at times and I don't want extra comments to automatically get pushed or adding extra step to work to first go back and re commit the files. Please keep it optional 🚀

[wqh17101]

Q1：

First, I encountered an issue with the minimax-m2.1 model. It failed to correctly provide the input parameters for the scripts, even though it successfully generated the .md file in the current directory.

 Bash(bash
      "xxx/.claude/plugins/cache/planning-with-files/planning-with-files/2.2.2/scripts/init-session.sh")
  ⎿  Error: Exit code 1

     === SESSION INITIALIZATION ===

     Project: project
     Date: 2026-01-19
     Time: 18:54:23
     Directory: /d/work/xxxxx

     === VERIFICATION CHECKLIST ===

     ℹ️  Creating missing planning files...
     ✅ Created task_plan.md
     ✅ Created findings.md
     ✅ Created progress.md
     ⚠️  Git has uncommitted changes
        Uncommitted files:
          ?? .claude/
          ?? .idea/
          ?? findings.md
          ?? progress.md
          ?? task_plan.md

Q2:

After one phase it will not commit by its own，maybe i need to commit manually

Q3：

When i use Please use the skill planning-with-files to continue your task. after i start a new session by cmd claude, it doesn`t continue as we expect.

I noticed that you intend to use the planning-with-files skill to continue the task, but you haven't specified what the task is yet.
Could you please clarify the specific task or project you'd like to accomplish? For example:
- Researching a technical solution
- Planning the implementation of a new feature
- Solving a complex technical issue
- Other multi-step planning tasks
- Once you provide the task details, I can utilize the planning-with-files skill to assist you with systematic planning and execution

Q4：

I saw

 Write(xxxxx\prompt.py)
  ⎿  PreToolUse:Write hook error: Failed with non-blocking status code: No stderr output
  ⎿  Wrote 1 lines to xxxxx\prompt.py

and never saw PostToolUse . I don't think that all things are right.

Q5（this not the problem on the Antropic Patterns）:

My claude dir is:
--~/.claude
---- plugins/cache/planning-with-files/planning-with-files/2.3.0
It seems that session-catup.py will not work normally.

def get_project_dir(project_path: str) -> Path:
    """Convert project path to Claude's storage path format."""
    sanitized = project_path.replace('/', '-')
    if not sanitized.startswith('-'):
        sanitized = '-' + sanitized
    sanitized = sanitized.replace('_', '-')
    return Path.home() / '.claude' / 'projects' / sanitized

[wqh17101]

How to Test

1. Clone the branch:

   git clone https://github.com/OthmanAdi/planning-with-files.git
   cd planning-with-files
   git checkout feature/anthropic-patterns

2. Test the init-session.sh script:

   # Create a new test project
   mkdir ~/my-test-project && cd ~/my-test-project
   git init
   
   # Run the init script (first time - creates files)
   bash /path/to/planning-with-files/scripts/init-session.sh "my-test-project"
   
   # Commit the files
   git add . && git commit -m "chore: Initialize planning files"
   
   # Run the init script again (simulates resuming a session)
   bash /path/to/planning-with-files/scripts/init-session.sh "my-test-project"

3. Verify the output:

   • The script should display a verification checklist.
   • It should show the current phase, branch, and last commit.
   • It should log the new session to progress.md.

4. Review the new task_plan.md template:

   • Open task_plan.md and verify the Phase Summary table, Test Results sections, and Git Checkpoints table are present.

---

Test well,but how to use in claude with a real task?

[wqh17101]

The latest test：@OthmanAdi

To sum up: The overall process is normal. I just need to execute init-session via the bash model ! at the beginning of Claude, and then let it continue with the task or start a new one, and it will run normally.

A few outstanding issues that can help us improve：

1. i think we need a command planning-with-files to init and resume. ref: https://github.com/anthropics/claude-plugins-official/tree/main/plugins/feature-dev
2. About the hook：
   I saw

 Write(xxxxx\prompt.py)
  ⎿  PreToolUse:Write hook error: Failed with non-blocking status code: No stderr output
  ⎿  Wrote 1 lines to xxxxx\prompt.py

and never saw PostToolUse . I don't think that all things are right.

3.Why here is an empty cmd？Is the session-catchup.py file still required? We need to detect whether to use python or python3 in the command line, as some environments lack the python3 command.

related to : #41

4. It can resume working, but it doesn't seem to have committed. It might be related to my prompt. I first executed init-session through bash mode and then told it "Please continue the task."

  项目结构

  test_paln/
  ├── hello.py           # 主程序 (Python 脚本，支持命令行参数)
  ├── task_plan.md       # 任务计划文档
  ├── progress.md        # 进度日志
  └── findings.md        # 发现与决策记录

  测试结果

  - python hello.py → "Hello, World!" ✅
  - python hello.py Claude → "Hello, Claude!" ✅

  待提交的变更

  - findings.md - 添加项目结构
  - progress.md - 记录本次会话
  - task_plan.md - 更新所有阶段状态

  需要我提交这些变更吗？

Maybe it would have been better if I had said, "Please continue executing the task using the skill planning-with-files."

[wqh17101]

@OthmanAdi Don't forget this one

[OthmanAdi]

Fixed in v2.11.0!

@wqh17101 Thank you for the reminder about Issue #39!

The autocomplete issue is now fixed. Added a new shorter command that works with autocomplete:

How to use:

1. Install plugin
2. Type /plan in Claude Code
3. Autocomplete shows /planning-with-files:plan

No extra setup needed!

Release: https://github.com/OthmanAdi/planning-with-files/releases/tag/v2.11.0

---

中文

@wqh17101 感谢你的提醒！

自动补全问题已在 v2.11.0 版本中修复。现在只需输入 /plan 就能在自动补全中看到命令了。

无需额外设置！

[wqh17101]

so,when will this new workflow to be merged? @OthmanAdi