the signals and their derived score are provisional and subject to change.
validate manually before sharing.
d78bfbde1fcf88c570f33170a4a972bd74cfc484# Blorp
The role of this file is to describe common mistakes and confusion points that agents might encounter as they work in this project. If you ever encounter something in the project that surprises you, please alert the developer working with you and indicate that this is the case in the CLAUDE.md file to help prevent future agents from having the same issue.
## Plans
When creating plans, prepend the date and use a short descriptive name based on the task content (e.g., "2026-03-09-refactor-auth-flowWhen writing/editing md files in this folder (docs/decisions/):
- Docs should primarily exist to explain why a decision was made. If it's just reexplaining what the tests already describe, it's bloat.
- Don't use any special formatting.
- Everything should be plain markdown paragraphs
- You can ask the dev if they want to use a simple # (h1) heading if documents get more than a few paragraphs
- In general, the goal is to keep these md files to 3 paragraphs max, but some of the more complicated decisions maAGENTS.mdAGENTS.mdnone