agentleFS
Sign inStart free
ZhouYinLong-labZhouYinLong-lab/Dog-Skills/planning-with-files/SKILL.md

planning-with-files

Skill7 starsChanged 5 months agoMITView on GitHub

把开发规划持久化到项目 Markdown 文件中，解决 AI 编程最大的痛点——上下文压缩导致 架构决策和设计细节丢失。强制性将每次讨论的设计点、决策、进度自动写入 plan 文件， 下次开新对话时 Claude Code 读到这些文件即可恢复状态。 Trigger keywords: planning with files, 规划文件, 上下文持久化, 开发规划, 设计决策记录, plan this feature, 持久化规划, 防止上下文丢失, 状态恢复, 开发进度追踪, 架构决策记录。

67 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use react-best-practices, vercel-deploy and 4 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • OpenAISkill

    react-best-practices

    React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

    Also in 5 projects that use this

  • VercelSkill

    vercel-deploy

    Deploy applications and websites to Vercel with a claimable preview. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment". No authentication required - returns preview URL and claimable deployment link.

    Also in 3 projects that use this

  • AnthropicSkill

    web-artifacts-builder

    Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.

    Also in 6 projects that use this

  • HABUBUSSSkill

    strategic-compact

    Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

    Also in 3 projects that use this

  • GoogleSkill

    internal-comms

    A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

    Also in 6 projects that use this

  • JetBrainsSkill

    doc-coauthoring

    Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

    Also in 5 projects that use this

The file

Create a free account to mount
Files
SKILL.md

Planning with Files — 开发规划持久化

AI 编程最让人不省心的不是代码写得不对，是上下文压缩。三天后重开对话，它完全不记得之前的架构方案。

Planning with Files 解决的就是这个问题。

核心原理

把所有开发规划、设计决策、进度追踪都写进项目里的 Markdown 文件。不是"建议你记下来"这种软性建议，是强制性的。

每个设计讨论 → 自动更新对应 plan 文件
下次新对话   → Claude Code 读文件 → 状态恢复

安装

/plugin install planning-with-files@claude-plugin-directory

使用方式

装完之后对 Claude Code 说一句：

plan this feature

它会自动创建 Markdown 规划文件。后续所有的对话、操作都记录在这些文件里。就算你关掉终端出去吃个饭，回来重开对话，它看一眼文件就知道做到哪了。

为什么需要它

Claude Code 的上下文窗口有限。对话一长，为了省 token，会把前面的内容压缩成摘要。这个压缩过程里，很多关键的开发决策和设计细节就丢了。

Planning with Files 的本质是：用文件系统做"外置记忆"。

最佳搭配

  • Superpowers：一个管流程约束（先问再做），一个管状态持久化（写到文件）。两个互补，形成完整的开发闭环。
  • token-optimizer：确保 plan 文件不会被当作冗余内容清理掉

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free