Give Your Coding Agent Eyes

说明与用途

编码代理现在使用功能笔记目录，只加载相关笔记，提高准确性并节省令牌。

问题

Coding agents start blind, needing to rediscover feature behavior each session, leading to inefficiency and errors.

结果

Agents now load only relevant feature notes, reducing token usage and improving accuracy. The system remains up-to-date with code changes and avoids leaking unrelated documentation.

工作流

• 1. Generate a catalog of feature notes every 20 commits or sprint end.
• 2. Store one small note per feature in .pi/notes/, each with a description trigger.
• 3. On agent start, use pi-context to inject a context block listing available notes with paths and descriptions.
• 4. Agent reads only the note whose description matches the current task.
• 5. If no match, agent proceeds without loading content.
• 6. Notes are regenerated automatically to stay in sync with code.
• 7. For cold starts, use doc-skills to scan repo, group files by feature, and create notes from source files.

证据

Twenty features cost me about 300 tokens — roughly one mid-sized note's worth — and every feature in the project is reachable.

来源

The description is a trigger condition, not a summary.

来源