Skip to content

Add papercut log: capture small improvement ideas without derailing work#8050

Open
hatton wants to merge 2 commits into
masterfrom
papercut-system
Open

Add papercut log: capture small improvement ideas without derailing work#8050
hatton wants to merge 2 commits into
masterfrom
papercut-system

Conversation

@hatton

@hatton hatton commented Jul 10, 2026

Copy link
Copy Markdown
Member

[Claude Fable 5]

What

Adds the papercut system to this repo:

  • PAPERCUTS.md — a lightweight, committed log where agents and devs jot down small dev/agent/tooling friction (stale docs, script quirks, workflow snags) in the moment, without derailing whatever they were doing. Entries are triaged later ("trim the papercuts") and deleted once fixed, promoted (e.g. to YouTrack), or dropped — the log only holds open cuts.
  • AGENTS.md — a short rule telling agents to log such cuts proactively as they hit them.

The full procedure (entry format, routing between this repo's log and the environment/team-workflow log, add vs. trim modes) is the new papercut skill in bloom-team-skills, which also carries a new TEAM-AGENTS.md so the proactive rule reaches Claude sessions in every repo.

The log is seeded with a first real cut hit while committing this very change: the pre-commit hook fails with a confusing pretty-quick: command not found when node_modules is empty.

🤖 Generated with Claude Code

Devin review


This change is Reviewable

PAPERCUTS.md is a lightweight, committed log where agents and devs jot
down dev/agent/tooling friction (stale docs, script quirks, workflow
snags) in the moment, to be triaged and trimmed later. AGENTS.md gains a
rule telling agents to log such cuts proactively. The full procedure is
the new `papercut` skill in the bloom-team-skills repo.

Seeded with a first real cut hit while committing this change: the
pre-commit hook fails confusingly when node_modules is empty.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@greptile-apps

greptile-apps Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR introduces a lightweight "papercut" system for capturing small tooling/process friction without interrupting ongoing work.

  • AGENTS.md gains a new "Papercuts" section telling agents to prepend friction entries to PAPERCUTS.md; the wording ("prepend") matches the new file's "add at the top" rule, so the two files are consistent.
  • PAPERCUTS.md is a new committed log with clear house rules (top-entry ordering, format, conflict resolution) and a seed entry documenting the pretty-quick: command not found pre-commit failure that occurred on a fresh worktree before pnpm install.

Important Files Changed

Filename Overview
AGENTS.md Adds "Papercuts" section instructing agents to prepend entries to PAPERCUTS.md; wording is consistent with the new file's "add at the top" rule
PAPERCUTS.md New file establishing the papercut log format, house rules, and a seed entry documenting a real pre-commit hook failure

Reviews (2): Last reviewed commit: "Apply suggestion from @greptile-apps[bot..." | Re-trigger Greptile

Comment thread AGENTS.md Outdated
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
@hatton
hatton marked this pull request as ready for review July 13, 2026 23:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant