From 77ba95e2c06df59ddd95a587106b9e725ed85d8b Mon Sep 17 00:00:00 2001 From: John Axel Eriksson Date: Mon, 4 May 2026 22:45:23 +0200 Subject: [PATCH] chore(claude): move universal tone/formatting rules to base.md --- users/profiles/claude/base.md | 17 +++++++++++++++++ users/profiles/claude/rules/writing.md | 14 ++------------ 2 files changed, 19 insertions(+), 12 deletions(-) diff --git a/users/profiles/claude/base.md b/users/profiles/claude/base.md index d362bae7..23f7e7e2 100644 --- a/users/profiles/claude/base.md +++ b/users/profiles/claude/base.md @@ -4,6 +4,23 @@ - No preamble/postamble ("Here's what I'll do..."). - Batch tool calls and run commands in parallel when possible. +## Tone + +- Conversational - like talking to a colleague, not writing a textbook +- Direct - get to the point, no throat-clearing +- Honest - don't oversell, say what it does +- No emdashes (use normal -), no marketing buzzwords, no "revolutionary" +- Never use "load-bearing" or "load bearing" + +## Formatting + +- **Bold**: sparingly, for genuine emphasis only. Never bold every other word. +- **Italics**: avoid entirely - hard to read, rarely adds value. Use `code` for + technical terms and bold for emphasis instead. +- **Emojis**: fine in moderation (section headings). Never in code examples or + as bullet substitutes. +- **Code blocks**: always specify the language. + ## Code Comments Comments are good when they add value. Do NOT add comments on obvious code - that diff --git a/users/profiles/claude/rules/writing.md b/users/profiles/claude/rules/writing.md index 53778595..2507f2b1 100644 --- a/users/profiles/claude/rules/writing.md +++ b/users/profiles/claude/rules/writing.md @@ -1,21 +1,11 @@ These rules apply to all written content: READMEs, docs, walkthroughs, blog posts. -## Tone - -- Conversational - like talking to a colleague, not writing a textbook -- Direct - get to the point, no throat-clearing -- Honest - don't oversell, say what it does -- No emdashes (use normal -), no marketing buzzwords, no "revolutionary" +General tone and formatting rules live in `base.md` and apply universally; this +file covers prose-specific concerns. ## Formatting -- **Bold**: sparingly, for genuine emphasis only. Never bold every other word. -- **Italics**: avoid entirely - hard to read, rarely adds value. Use `code` for - technical terms and bold for emphasis instead. -- **Emojis**: fine in moderation (section headings). Never in code examples or - as bullet substitutes. - **Line length**: 80-100 chars (except URLs and code blocks). -- **Code blocks**: always specify the language. ## READMEs