context-pack
Skill1 starsChanged 8 days agoMITView on GitHub
交付期第 8 步,前置消熵:整程开工前派便宜子代理整理上下文包、主代理自己做关键模块的细化设计与技术验证;每切片开工前做开工包:上下文增量、技术设计与验证、细化推进方案、里程碑待办清单。spec 与 plan 写好之后、每个切片动手之前,或人说「整理上下文」「开工包」时加载。切片已开工不加载;写 spec 与 plan 归 spec-and-plan。
5 other projects use a version of this.
Adopted by
Most recently taken up by
- richardochristjia/skillstheir own version, first seen Nov 1, 2026
- oocx/tfplan2mdtheir own version, first seen Oct 8, 2026
- TIKAZI/TIKAZ-Codex-Context-Economytheir own version, first seen Aug 31, 2026
- Mesteriis/Engineering-Bible-AItheir own version, first seen Jun 28, 2026
- kambleakash0/agent-skillstheir own version, first seen Apr 6, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 5
- oocx/tfplan2md★ 174same name
- kambleakash0/agent-skills★ 10same name
- TIKAZI/TIKAZ-Codex-Context-Economy★ 3same name
- richardochristjia/skills★ 2same name
- Mesteriis/Engineering-Bible-AI★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository28 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- candid-friendSkill
- cleanupSkill
- clear-writingSkill
- delegate-briefSkill
- detailed-domain-designSkill
- domain-impact-analysisSkill
- formal-docs-landingSkill
- formal-guardSkill
- one-lesson-ruleSkill
- pass-the-batonSkill
- pqw-modeSkill
- progress-artifactsSkill
- requirement-and-invariantsSkill
- single-session-dev-flowSkill
- slice-closeoutSkill
- spec-and-planSkill
- teach-pqw-skillsSkill
- tech-research-and-reuseSkill
- think-closed-loopSkill
- think-evidenceSkill
- think-model-firstSkill
- think-orthogonalSkill
- think-ought-vs-isSkill
- think-right-then-wellSkill
- think-unknownsSkill
- write-agents-mdSkill
The file
Files
前置消熵
位置:交付期第 8 步,整程一次,每个切片开工前一次;开工包之后先实施,再收口。上一步 spec-and-plan(整程包)、cleanup(下一个切片),下一步 slice-closeout。顺序与例外见入口技能 single-session-dev-flow。
把不确定性从「实施时才发现」搬到「动手前就消除」。信息包一次整理,之后只增补。里程碑清单让进度可见,回看时不用重读整段实现。
两个尺度
| 尺度 | 什么时候 | 谁做 | 产出 |
| 整程包 | spec 与 plan 写好之后、第一个切片开工之前 | 便宜的子代理整理,主代理做关键设计与技术验证 | 整程上下文包 |
| 切片开工包 | 每个切片开工之前 | 上下文增量由便宜的子代理,其余三样主代理 | plan 里该切片下的开工包四节 |
整程包
整程包是主代理和每个子代理整程共用的事实清单,纯文本,不依赖会话记忆。派便宜的子代理整理时,派发理由是防主上下文膨胀:读很多文件的活不进主上下文。简报按 delegate-brief,只读,交回整程包文件。
整程包固定五节:
- 不变式:spec 不变式对照里的每条,原文加出处。
- 系统地图:本程涉及的领域、它们的边界与接缝,一张图加一段话。
- 先读什么,读到哪停:每项写文件与行范围、为什么读、读到哪里停;再写不要读什么。读多了会扩大范围。
- 最容易踩的耦合:哪条轴不能决定哪条轴,哪个外域概念不能进本域契约。
- 接入点:本程要用的项目命令与位置,从消费者 AGENTS.md 的「pqw-skills 接入」一节抄来。
写不出的项写「未知」,不猜。整程包里引用的每个文件都在起点提交上存在。
主代理在整程包交回后自己做两件事,不派:关键模块的细化架构设计(类型、签名、边界,加载技能 pstack:architect),以及必要的技术验证。技术验证用抛弃式原型回答一个具体问题,加载技能 mattpocock-skills:prototype;原型不进仓库。
切片开工包
四样齐了才动手。写进 plan 该切片的下面,不另开文件。
| 项 | 内容 | 谁做 |
| 上下文增量 | 这个切片额外需要的:涉及的文件与契约、相邻切片留下的事实、整程包里没有的。只写差额,不重抄整程包 | 便宜的子代理,或读量小时主代理自己 |
| 技术细节设计与验证 | 开头三问各一行;碰到状态与操作时先全化;这个切片的领域模型与对象模型(本片新增或改动的聚合、值对象、类型、签名、模块边界、关键算法),碰到形式化过的区域时补全精化对照表;动手前按 detailed-domain-design「方案论证」论证一遍,论证不过不动手,深度跟本片工作量走;有疑点的先用抛弃式原型验证;写明收口要守的关键位置(收口只对它们做结构读数与差分变异,整程全量留到交付前一次,与信息包的全量在前、增量在后正好反过来) | 主代理 |
| 细化的推进方案 | 把 plan 里这一片的一句话展开成有序步骤,分两轮:先改什么、测什么、什么时候合回、什么时候派子代理 | 主代理 |
| 里程碑待办清单 | 切片内有里程碑性质的待办,每条可勾选、有完成判据;哨兵和汇报件读它判断进度 | 主代理 |
切片完成时把清单勾完,没勾完的说明原因。
开工包里有几处要用思维模型,填到那一栏时各过一遍:
- 「技术细节设计与验证」开头三行。先答三问:应然、实然、差异。做法加载技能
think-ought-vs-is。 - 碰到状态与操作时写「全化表」一行,再写领域模型与对象模型;不碰写「不涉及状态」。先把状态与操作写成偏函数并全化,再翻成领域模型与对象模型。做法加载技能
think-model-first。 - 「技术细节设计与验证」里要验证的疑点,和全化表里填不出的格。没说清的地方先分清是事实、惯例还是偏好,去试、去查,不猜。做法加载技能
think-unknowns。 - 推进方案与里程碑分「做对」「做好一轮」两步。先做对,再单独做好一轮。做法加载技能
think-right-then-well。 - 「关键位置」按错了代价大的几条轴逐条问本片碰没碰到:判据与不变式守护点、状态转移、并发、失败与清理分支、对外契约边界。先拆出独立变化的轴,交叉成表逐格看。做法加载技能
think-orthogonal。
守住上下文窗口
大输出、长文件、重复读取、扇出规划都往子代理送,主上下文只留结论。自己读时,互不依赖的读取在同一步里一起发出。加载技能 pstack:principle-guard-the-context-window。上下文被压缩之后,先从 plan 的进度总览、整程包和自己的提交历史重建现状,再继续,加载技能 pstack:recall。
整程包与开工包是写给压缩后的自己的简报:压缩也是一次转手,要它记得的写进文件。转手会丢信息,回路越紧越稳,一块多大由接的一方验得完多少定。做法加载技能 think-closed-loop。
判据
- 整程包的每条事实有出处,没有「如前所述」「按我们讨论的」。
- 开工包四节都有内容,推进方案是有序步骤,里程碑每条有完成判据。
- 一个没有本次上下文的会话只拿整程包和开工包,能答出从哪个提交开工、能改什么、做到什么算完、关键事实的出处。
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
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.

