You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
chore: dedupe shared rules into user-global CLAUDE.md
The "Branch Naming Convention", "PR Convention", "Issue Labels",
"Code Block Formatting", and "Markdown Linting" sections were
generic preferences duplicated across homelab, gearbox, and
ubuntu-ha-proxy-install. They've been promoted to ~/.claude/CLAUDE.md.
What remains here is the gearbox-specific scaffolding around them:
the GitHub-driven workflow steps (issues + project board), the
gearbox project ID and board configuration, the docs/reports/
convention, and the TOC-after-heading note for new docs.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- PR body must include `Closes #<issue-number>` to auto-close the issue on merge
115
-
- Use the standard PR template format (Summary, Test Plan)
116
-
117
-
### Issue Labels
118
-
119
-
Use these labels consistently:
120
-
121
-
-`enhancement` — New features
122
-
-`bug` — Bug fixes
123
-
-`documentation` — Docs-only changes
124
-
-`refactor` — Code improvements without behavior change
107
+
Generic branching/PR/label rules live in `~/.claude/CLAUDE.md`. All of them apply here unmodified — `feature/...` and `fix/...` branches from `main`, `Closes #N` in PR bodies, the four standard labels.
125
108
126
109
### Project Board
127
110
@@ -151,14 +134,6 @@ TASKS.md is a **scratch pad only** — not a tracking system. The GitHub Project
151
134
-`/dowork` - Read TASKS.md, create issues from it, and start working (ask questions as needed)
152
135
-`/doallwork` - Read TASKS.md, create issues from it, and work autonomously
153
136
154
-
## User Preferences
155
-
156
-
### Code Block Formatting
157
-
158
-
-**Always use fenced code blocks** (triple backticks) for commands
159
-
- Fenced blocks provide a copy button in the IDE
160
-
- Never use inline code for commands the user should run
161
-
162
137
## UI Conventions
163
138
164
139
### Modal dialogs — never use native `confirm()`, `alert()`, or `prompt()`
- Inform user before running `make deploy` for agent
242
217
- Validate HAProxy config with `haproxy -c` before reload (if applicable)
243
218
244
-
### Markdown Linting
245
-
246
-
Run `npx markdownlint-cli '**/*.md' --config .markdownlint.json` to validate. Key rules: blank lines around lists/code blocks, specify language for code blocks, proper headings, single newline at EOF.
247
-
248
-
### Creating New Documentation
219
+
### Markdown and docs
249
220
250
-
Store in `docs/`directory using kebab-case naming. Include TOC after main heading. Reference in README.md.
221
+
See `~/.claude/CLAUDE.md` for markdown style and the `docs/`+ kebab-case rule. This repo also requires a TOC after the main headingin new docs.
0 commit comments