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.

Источник