Способы улучшения работы агентов с помощью papercuts

Я конечно видел много способов harness для агентов, но это пожалуй самый прикольный:

Парень придумал для агентов 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 —

→ . 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-тул под это.

Ну и само по себе интересно читать как агент на естественном языке ругается на глупые проблемы☕

Подписывайтесь на Telegram Tips AI | IT & AI.