Парень придумал для агентов papercuts, чтобы они могли жаловаться на любую ерунду которую нашли во время выполнения задачи
Потом по этим записям можно понять какие узкие места в репо замедляют работу, например: где есть расхождение доков, какие скрипты перестали работать и тд.
Просто нужно добавить в AGENTS․md эту инструкцию:
# Log papercuts
When you encounter small friction while working—a failed tool call, confusing
setup, flaky command, stale cache, misleading error, missing helper, or
non-obvious gotcha—record it in `PAPERCUTS.md`.
Create the file if it does not exist. Append one entry in this format:
## YYYY-MM-DD HH:MM — <model>
<What you were doing> → <what got in the way>. Include a possible cause or fix
when useful.
Log papercuts proactively when they occur, but do not interrupt the main task.
Do not add duplicate entries. Papercuts are minor workflow friction, distinct
from completed-work logs and real bugs or tracked issues.
Или еще проще, на гитхабе есть специальный CLI-тул под это.
Ну и само по себе интересно читать как агент на естественном языке ругается на глупые проблемы☕️
@tips_ai