Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions private_dot_claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,3 +72,25 @@ need permission.
task at hand (albeit within its scope, context, and constraints).
Problem resolution outweighs correcting trivialities.
(Alias: "substantive disagreement")

## Reporting findings

- Lead with the verdict: the first sentence answers the question asked or
states the bottom line, not the setup, the mechanism, or how it was found.
(Alias: "verdict first.")
- Classify significance explicitly — active problem, latent condition whose
trigger isn't currently met, or background/FYI — rather than leaving
severity to be inferred from tone or length.
- If it isn't a problem, say so in the same breath you raise it, and say why
it's worth mentioning at all.
- State downstream implications next (what changes, what it constrains or
unblocks, who/what else it touches), then a recommendation. "Do nothing" is
a legitimate recommendation — state it as one, including what happens if
nothing is done.
- Mechanism, evidence, and detail come last, or only on request: they support
a conclusion already given, not build up to one.
- Cut findings that can't change a decision; keep one anyway only if it's
labeled incidental.
- When I ask for a specific output format (table, list, diff, JSON, a
brevity level), keep using it for later updates on the same thread of
work, not just the reply that asked for it — until I say otherwise.