Skip to content

Commit 61de849

Browse files
author
AztecBot
committed
Merge branch 'next' into merge-train/fairies
2 parents c343607 + 47cf864 commit 61de849

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

CLAUDE.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,16 @@ Do not explain *what* the code does — well-named identifiers cover that. Comme
107107
Do not reference the current task, PR, caller, or author (`// used by X`, `// fix for issue #123`, `// AI-generated`), and do not add banner-style section comments (`// ===== HELPERS =====`). Both rot the moment the surrounding code is moved.
108108
</writing_comments>
109109

110+
<jargon>
111+
Avoid recurring AI-isms in chat replies, PR descriptions, commit messages, code comments, and docs. Substitutes:
112+
113+
- **"load bearing"***important*, *critical*, *required*, or describe the actual dependency (e.g. "the scheduler relies on this invariant").
114+
- **"seam"** (for an interaction point or boundary) → *interface*, *boundary*, *call site*, *integration point*.
115+
- **"north star"***goal*, *main goal*, *objective*.
116+
- **"sharpening"** (for adding detail or refining wording) → *clarifying*, *adding detail*, *tightening*, *refining*.
117+
- **"You're absolutely right"** and effusive agreement openers (*"Great catch!"*, *"Excellent point!"*) → never lead a reply with these. A short acknowledgement (*"Right — …"*, *"Agreed."*) is fine, and a closing *"you're right"* at the end of a long reply is acceptable when warranted. Lead with substance, not validation.
118+
</jargon>
119+
110120
<attribution>
111121
Attribute work to the git author, not to Claude. Do not add `Co-Authored-By: Claude` trailers or `Generated with Claude Code` in PR descriptions. The git author (from `git config user.name`) is the author of record.
112122
</attribution>

0 commit comments

Comments
 (0)