othmanadi/planning-with-files

planning-with-files-zh

用于多步骤 AI 代理工作的持久化文件规划系统。将 task_plan.md、findings.md 和 progress.md 保存在磁盘上,生命周期钩子会注入选定的项目规划上下文。自动恢复只读取项目规划文件。只有显式运行 session-catchup.py --metadata 才会检查本机同项目的会话元数据;--replay 可输出有长度限制且由 nonce 框定的同项目摘录。可选门禁仅在宿主支持时请求继续,绝不执行 Markdown 中声明的命令。本技能没有网络上传路径。适用于研究或需要 5 次以上工具调用的工作。触发词:任务规划、项目计划、制定计划、分解任务、多步骤规划、进度跟踪、文件规划、帮我规划、拆解项目

All-time #1300 Trending #5509 First seen Mar 19, 2026
8-week activity · all time api

Installation

$ npx skills add https://github.com/othmanadi/planning-with-files
Feature your product here Skill page unit · reach builders installing agent skills View pricing →

Summary

  • Manus-style file-based planning system for organizing and tracking multi-step project progress.
  • Creates three persistent markdown files—task_plan.md, findings.md, and progress.md—that serve as disk-based working memory across sessions Automatically detects and loads active plans on each prompt, with tamper detection and attestation to prevent injection attacks Includes session recovery via catchup script to restore context from previous interrupted work and sync untracked changes Supports scoped plans (nested in .planning/ directories) and root-level plans, with clear rules for when to read, write, and update each file Provides templates, error tracking matrices, and a three-failure protocol to prevent repeated mistakes and guide decision-making before major actions

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from othmanadi/planning-with-files.

npx skills add https://github.com/othmanadi/planning-with-files

Browse all from othmanadi/planning-with-files

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 26.7K
License LICENSE
Default branch master
Open issues 8
Status Active

History

  1. First seen on skills.sh
  2. First recorded snapshot · 17,600 installs