planning-with-files-zh

The planning-with-files-zh skill provides a structured, file-based planning system designed to manage complex, multi-step tasks using persistent Markdown files. It addresses the limitations of transient context windows by treating the file system as long-term memory, allowing users to organize, track, and resume work across sessions. This approach ensures that important decisions, progress updates, and research findings are consistently recorded and retrievable, reducing the risk of losing context in extended workflows or after interruptions.

The core functionality revolves around three key files: task_plan.md for outlining phases and tracking progress, findings.md for storing research and discoveries, and progress.md for maintaining a detailed session log. The system enforces disciplined workflows through rules such as creating a plan before starting, updating files after each phase, and recording all errors. It also includes automated hooks that prompt users to read existing plans, maintain synchronization, and update progress after file operations. Additionally, it supports session recovery by detecting existing plans and synchronizing unsaved context, ensuring continuity even after interruptions or environment resets.

This skill is particularly useful for developers, researchers, and technical professionals handling complex projects that require structured planning and iterative execution. It is well-suited for tasks involving multiple tool interactions, long-running research, or step-by-step implementation processes. By promoting disciplined documentation and incremental updates, it helps users maintain clarity, avoid repeated mistakes, and efficiently manage large-scale or multi-phase work.