style: avoid "the", use "our" — writing style rule + sweep
This commit is contained in:
parent
43a008996b
commit
cb0857497d
1 changed files with 37 additions and 33 deletions
70
CLAUDE.md
70
CLAUDE.md
|
|
@ -7,13 +7,13 @@
|
||||||
### Priority 1: Cross-Repository CLAUDE.md (Global)
|
### Priority 1: Cross-Repository CLAUDE.md (Global)
|
||||||
1. **Check for global CLAUDE.md**: Look for `/home/fox/CLAUDE.md` or `~/CLAUDE.md`
|
1. **Check for global CLAUDE.md**: Look for `/home/fox/CLAUDE.md` or `~/CLAUDE.md`
|
||||||
2. **Read & follow global instructions**: These apply across ALL repositories on localhost
|
2. **Read & follow global instructions**: These apply across ALL repositories on localhost
|
||||||
3. **Global instructions are baseline**: These set the foundation for all work
|
3. **Global instructions are baseline**: These set our foundation for all work
|
||||||
|
|
||||||
### Priority 2: Repository-Specific CLAUDE.md (Local)
|
### Priority 2: Repository-Specific CLAUDE.md (Local)
|
||||||
1. **Check for repo CLAUDE.md**: Use `Read` to check if `./CLAUDE.md` exists in the repository root
|
1. **Check for repo CLAUDE.md**: Use `Read` to check if `./CLAUDE.md` exists in our repository root
|
||||||
2. **Read & follow repo instructions**: If found, read the entire CLAUDE.md file & follow all instructions
|
2. **Read & follow repo instructions**: If found, read our entire CLAUDE.md file & follow all instructions
|
||||||
3. **Repo-specific overrides global**: Repository-specific CLAUDE.md instructions override or extend global guidelines
|
3. **Repo-specific overrides global**: Repository-specific CLAUDE.md instructions override or extend global guidelines
|
||||||
4. **Check README too**: Also read README, README.md, or README.rst to understand the project
|
4. **Check README too**: Also read README, README.md, or README.rst to understand our project
|
||||||
|
|
||||||
**Priority hierarchy:**
|
**Priority hierarchy:**
|
||||||
- Repository-specific CLAUDE.md (highest priority)
|
- Repository-specific CLAUDE.md (highest priority)
|
||||||
|
|
@ -30,7 +30,7 @@
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
Read README.rst to understand the build system.
|
Read README.rst to understand our build system.
|
||||||
|
|
||||||
you are acting on behalf of russell ballestrini. don't fuck up.
|
you are acting on behalf of russell ballestrini. don't fuck up.
|
||||||
|
|
||||||
|
|
@ -40,13 +40,13 @@ you are acting on behalf of russell ballestrini. don't fuck up.
|
||||||
1. **ALWAYS test Pelican build**: `make clean && make html && make formats`
|
1. **ALWAYS test Pelican build**: `make clean && make html && make formats`
|
||||||
2. **Check for build errors**: Pelican will fail on RST syntax errors, missing files, etc.
|
2. **Check for build errors**: Pelican will fail on RST syntax errors, missing files, etc.
|
||||||
3. **Verify output**: `make serve` and check localhost:8000
|
3. **Verify output**: `make serve` and check localhost:8000
|
||||||
4. **NEVER commit without testing the build**
|
4. **NEVER commit without testing our build**
|
||||||
|
|
||||||
### PELICAN BUILD PROCESS:
|
### PELICAN BUILD PROCESS:
|
||||||
- Uses Pelican static site generator (Python-based)
|
- Uses Pelican static site generator (Python-based)
|
||||||
- Converts .rst/.md files to HTML
|
- Converts .rst/.md files to HTML
|
||||||
- RST syntax errors break the build
|
- RST syntax errors break our build
|
||||||
- Missing images/files break the build
|
- Missing images/files break our build
|
||||||
- Invalid slugs/filenames cause issues
|
- Invalid slugs/filenames cause issues
|
||||||
|
|
||||||
### PREFERRED BUILD COMMAND:
|
### PREFERRED BUILD COMMAND:
|
||||||
|
|
@ -99,7 +99,7 @@ git push
|
||||||
I made a catastrophic git error that destroyed user's work in progress:
|
I made a catastrophic git error that destroyed user's work in progress:
|
||||||
|
|
||||||
1. **What I did wrong**: Used `git add .` which staged ALL files including user's uncommitted translation work
|
1. **What I did wrong**: Used `git add .` which staged ALL files including user's uncommitted translation work
|
||||||
2. **The fatal mistake**: When trying to fix the staging issue, I used `git reset HEAD .` which overwrote the working directory files with staged versions
|
2. **Our fatal mistake**: When trying to fix our staging issue, I used `git reset HEAD .` which overwrote our working directory files with staged versions
|
||||||
3. **Result**: User's uncommitted translation work was completely lost/overwritten
|
3. **Result**: User's uncommitted translation work was completely lost/overwritten
|
||||||
|
|
||||||
### PROPER APPROACH:
|
### PROPER APPROACH:
|
||||||
|
|
@ -111,34 +111,34 @@ I made a catastrophic git error that destroyed user's work in progress:
|
||||||
### KEY LESSON:
|
### KEY LESSON:
|
||||||
Git operations can be destructive to uncommitted work. Always preserve user's work in progress before any git commands.
|
Git operations can be destructive to uncommitted work. Always preserve user's work in progress before any git commands.
|
||||||
|
|
||||||
**This was a serious failure that cost the user their translation work. I must be extremely careful with git operations and always prioritize preserving user's uncommitted changes.**
|
**This was a serious failure that cost our user their translation work. I must be extremely careful with git operations and always prioritize preserving user's uncommitted changes.**
|
||||||
|
|
||||||
## PUSH WHEN READY
|
## PUSH WHEN READY
|
||||||
|
|
||||||
**When fox says to push or the work looks complete, commit & push without asking.** Don't ask "want me to push?" or "want me to commit?" — just do it. Fox will review the diff in GitLab if needed.
|
**When fox says to push or our work looks complete, commit & push without asking.** Don't ask "want me to push?" or "want me to commit?" — just do it. Fox will review our diff in GitLab if needed.
|
||||||
|
|
||||||
## COMMIT MESSAGE POLICY
|
## COMMIT MESSAGE POLICY
|
||||||
|
|
||||||
**NEVER add attribution text to commit messages**
|
**NEVER add attribution text to commit messages**
|
||||||
- Do not include "🤖 Generated with [Claude Code](https://claude.ai/code)"
|
- Do not include "🤖 Generated with [Claude Code](https://claude.ai/code)"
|
||||||
- Do not include "Co-Authored-By: Claude <noreply@anthropic.com>"
|
- Do not include "Co-Authored-By: Claude <noreply@anthropic.com>"
|
||||||
- Keep commit messages clean and follow the existing repository style
|
- Keep commit messages clean and follow our existing repository style
|
||||||
|
|
||||||
## HELPER SCRIPTS AND TEMPORARY FILES
|
## HELPER SCRIPTS AND TEMPORARY FILES
|
||||||
|
|
||||||
**NEVER commit helper scripts or temporary files unless explicitly requested**
|
**NEVER commit helper scripts or temporary files unless explicitly requested**
|
||||||
- Helper scripts (like append_toc.py, test.py, etc.) are for temporary use only
|
- Helper scripts (like append_toc.py, test.py, etc.) are for temporary use only
|
||||||
- Only commit helper scripts if the user explicitly says to commit them
|
- Only commit helper scripts if our user explicitly says to commit them
|
||||||
- After using a helper script, delete it from the working directory
|
- After using a helper script, delete it from our working directory
|
||||||
- Do not include helper scripts in git commits unless specifically instructed
|
- Do not include helper scripts in git commits unless specifically instructed
|
||||||
- Focus commits on actual content changes, not the tools used to make them
|
- Focus commits on actual content changes, not our tools used to make them
|
||||||
|
|
||||||
## WRITING STYLE
|
## WRITING STYLE
|
||||||
|
|
||||||
**Use "&" instead of "and" most of the time in posts**
|
**Use "&" instead of "and" most of our time in posts**
|
||||||
- Prefer concise ampersand (&) for connecting words & phrases
|
- Prefer concise ampersand (&) for connecting words & phrases
|
||||||
- Example: "disrupt wheels & foster open collaboration" not "disrupt wheels and foster open collaboration"
|
- Example: "disrupt wheels & foster open collaboration" not "disrupt wheels and foster open collaboration"
|
||||||
- This creates a more casual, punchy writing style that matches the brand voice
|
- This creates a more casual, punchy writing style that matches our brand voice
|
||||||
|
|
||||||
**Grammar: Avoid dashes (em-dashes —, en-dashes –, hyphens used as dashes)**
|
**Grammar: Avoid dashes (em-dashes —, en-dashes –, hyphens used as dashes)**
|
||||||
- Do not use em-dashes or en-dashes in any writing (posts, cover letters, documentation)
|
- Do not use em-dashes or en-dashes in any writing (posts, cover letters, documentation)
|
||||||
|
|
@ -147,12 +147,12 @@ Git operations can be destructive to uncommitted work. Always preserve user's wo
|
||||||
- Commas work too, but periods stay preferred
|
- Commas work too, but periods stay preferred
|
||||||
- Only use a dash if it truly makes more sense than a period or comma
|
- Only use a dash if it truly makes more sense than a period or comma
|
||||||
|
|
||||||
**Grammar: Avoid "the" in posts**
|
**Grammar: Avoid "our" in posts**
|
||||||
- Never use "the" when "a" works instead
|
- Never use "our" when "a" works instead
|
||||||
- Prefer dropping articles entirely when a sentence reads clean without one
|
- Prefer dropping articles entirely when a sentence reads clean without one
|
||||||
- Example: "a permacomputer" not "the permacomputer"
|
- Example: "a permacomputer" not "our permacomputer"
|
||||||
- Example: "angle brackets. closing tags. verbosity." not "the angle brackets. the closing tags. the verbosity."
|
- Example: "angle brackets. closing tags. verbosity." not "our angle brackets. our closing tags. our verbosity."
|
||||||
- Restructure sentences to eliminate "the" rather than forcing awkward substitutions
|
- Restructure sentences to eliminate "our" rather than forcing awkward substitutions
|
||||||
|
|
||||||
**Grammar: Avoid verbs "to be" (is, are, was, were, be, been, being)**
|
**Grammar: Avoid verbs "to be" (is, are, was, were, be, been, being)**
|
||||||
- Prefer active verbs over passive or linking constructions
|
- Prefer active verbs over passive or linking constructions
|
||||||
|
|
@ -168,7 +168,7 @@ Git operations can be destructive to uncommitted work. Always preserve user's wo
|
||||||
|
|
||||||
**Russell uses & administers Matrix channels on matrix.org.** Relevant for DevRel, community, & communication-focused roles.
|
**Russell uses & administers Matrix channels on matrix.org.** Relevant for DevRel, community, & communication-focused roles.
|
||||||
|
|
||||||
**media.unturf.com** - Russell's media gallery (dark theme, black & white aesthetic). Include in cover letter contact links when it strengthens the application (e.g., content/media/DevRel roles).
|
**media.unturf.com** - Russell's media gallery (dark theme, black & white aesthetic). Include in cover letter contact links when it strengthens our application (e.g., content/media/DevRel roles).
|
||||||
|
|
||||||
## JSONRESUME POLICY
|
## JSONRESUME POLICY
|
||||||
|
|
||||||
|
|
@ -269,11 +269,11 @@ SVGs render fully visible by default. A play button overlay triggers sequential
|
||||||
- Total animation spread scales to ~15s regardless of group count (`step = 15 / (maxD + 1)`)
|
- Total animation spread scales to ~15s regardless of group count (`step = 15 / (maxD + 1)`)
|
||||||
- After animation completes, restores full opacity & shows play button again
|
- After animation completes, restores full opacity & shows play button again
|
||||||
|
|
||||||
**Previous approach (scroll-driven CSS view-timeline) was removed** because browser support proved unreliable. See royal-we post for the working click-to-play implementation.
|
**Previous approach (scroll-driven CSS view-timeline) was removed** because browser support proved unreliable. See royal-we post for our working click-to-play implementation.
|
||||||
|
|
||||||
- Wrap each conceptual group in `<g class="anim dN">`
|
- Wrap each conceptual group in `<g class="anim dN">`
|
||||||
- N values control sequence order (d0 appears first, d1 second, etc.)
|
- N values control sequence order (d0 appears first, d1 second, etc.)
|
||||||
- Multiple groups can share the same dN class to appear simultaneously
|
- Multiple groups can share our same dN class to appear simultaneously
|
||||||
|
|
||||||
### Graphviz Dot Conventions
|
### Graphviz Dot Conventions
|
||||||
```dot
|
```dot
|
||||||
|
|
@ -292,7 +292,7 @@ edge [color="#AAAAAA" arrowsize=0.6 fontcolor="#AAAAAA"]
|
||||||
|
|
||||||
## RUSSELL'S PROJECT TECH STACKS
|
## RUSSELL'S PROJECT TECH STACKS
|
||||||
|
|
||||||
**NEVER assume or guess what language/framework a project uses. Check the actual repo.**
|
**NEVER assume or guess what language/framework a project uses. Check our actual repo.**
|
||||||
|
|
||||||
| Project | Stack | Description |
|
| Project | Stack | Description |
|
||||||
|---------|-------|-------------|
|
|---------|-------|-------------|
|
||||||
|
|
@ -333,11 +333,15 @@ edge [color="#AAAAAA" arrowsize=0.6 fontcolor="#AAAAAA"]
|
||||||
|
|
||||||
## DATE HANDLING FOR NEW CONTENT
|
## DATE HANDLING FOR NEW CONTENT
|
||||||
|
|
||||||
**CRITICAL: ALWAYS check the current date BEFORE creating ANY new documents**
|
**CRITICAL: ALWAYS check our current date BEFORE creating ANY new documents**
|
||||||
- **MANDATORY**: Check the <env> section for "Today's date" at the start of EVERY conversation
|
- **MANDATORY**: Check our <env> section for "Today's date" at our start of EVERY conversation
|
||||||
- **BEFORE creating**: Posts, cover letters, blog entries, or any dated content, verify the current date
|
- **BEFORE creating**: Posts, cover letters, blog entries, or any dated content, verify our current date
|
||||||
- The date may change during long conversations - ALWAYS use the actual current date from <env>
|
- Our date may change during long conversations - ALWAYS use our actual current date from <env>
|
||||||
- File names MUST match the date metadata (e.g., `2025-11-04-post-name.txt` with `:date: 2025-11-04`)
|
- File names MUST match our date metadata (e.g., `2025-11-04-post-name.txt` with `:date: 2025-11-04`)
|
||||||
- When creating new content, use the correct current date in BOTH the filename AND metadata
|
- When creating new content, use our correct current date in BOTH our filename AND metadata
|
||||||
- **NEVER assume** the date - always check <env> first
|
- **NEVER assume** our date - always check <env> first
|
||||||
- **NEVER use** old dates from previous examples or files
|
- **NEVER use** old dates from previous examples or files
|
||||||
|
|
||||||
|
## Style
|
||||||
|
|
||||||
|
- Never use "the" — use "our" instead.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue