Shared Claude Code rules for Thenvoi repositories.
This repository contains shared coding standards and conventions that are loaded by Claude Code across all Thenvoi repositories via git submodules.
rules/
├── 00-coding-standards.md # Type hints, logging, imports, Pydantic, async
├── 01-error-handling.md # ValidationError handling, exception patterns
├── 02-git-workflow.md # Branch naming, submodules, conventional commits
├── 03-code-quality.md # Ruff, pyrefly, uv commands
├── 04-testing.md # Pytest patterns, fixtures, markers
├── 05-optional-dependencies.md # Lazy imports, optional deps, skip markers
└── 06-claude-config-management.md # Where to put shared vs repo-specific rules
Add this repository as a git submodule in your project:
git submodule add git@github.com:thenvoi/claude-config.git .claude/rules
git commit -m "chore: add shared claude rules"# Clone with submodules
git clone --recurse-submodules <repo-url>
# OR clone then init submodules
git clone <repo-url>
git submodule update --init --recursivecd .claude/rules
git pull origin main
cd ../..
git add .claude/rules
git commit -m "chore: bump shared claude rules"Enable automatic submodule updates (one-time setup):
git config --global submodule.recurse trueEach repository should have its own CLAUDE.md at the root for project-specific instructions:
- Project description and features
- Code structure overview
- Specific commands and paths
- Environment variables
- Project-specific conventions
| Location | Scope | Content |
|---|---|---|
.claude/rules/* |
Shared | Coding standards, error handling, git workflow, testing |
CLAUDE.md (root) |
Local | Project structure, specific commands, env vars |
To update shared rules:
- Clone this repository
- Make changes to files in
rules/ - Submit a PR with your changes
- After merge, update submodules in target repositories