A curated collection of Claude Code rules and custom skills for software development. These configurations enforce consistent coding standards, architectural patterns, and development workflows when working with Claude Code as your AI pair programmer.
Rules are project-level instructions that Claude Code automatically follows during every interaction.
| Rule | Description |
|---|---|
| backend.md | Python backend architecture — modular monolith with onion / ports-and-adapters layering, framework-free domain, repository pattern, unit of work, service layer, route-owned transactions, and an HTTP-only API layer |
| frontend.md | React application development — component design, state management, routing, API client architecture, authentication, performance optimization, and deployment |
| testing.md | Testing philosophy — logic-free tests, fakes over mocks, test isolation, naming conventions, TDD workflow, and quality tools (Hypothesis, mutmut, PyHamcrest) |
| ci.md | CI/CD pipeline design — modular jobs, coverage reporting with Codecov, and local reproducibility via act |
| workflow.md | Agent workflow orchestration — plan-first approach, subagent strategy, task management, self-improvement loop, and verification standards |
Skills are reusable, user-invocable capabilities that extend Claude Code with domain-specific workflows.
| Skill | Trigger | Description |
|---|---|---|
| pr-review-expert | /pr-review-expert |
Structured PR/MR review with blast radius analysis, security scanning, breaking change detection, test coverage delta, and a 30+ item checklist |
| test-runner | /test-runner |
Runs unit tests, e2e tests, and linters (black, flake8, ruff) after Python code changes; enforces >= 90% coverage |
| Server | Purpose |
|---|---|
| Playwright | Browser automation for testing and interaction via @playwright/mcp |
- Clone this repository (or copy the
.claude/directory) into your project root. - Adjust rules and skills to fit your project's stack and conventions.
- Claude Code will automatically pick up the rules from
.claude/rules/and make skills available via slash commands.
For more on Claude Code configuration, see the official documentation.
The following rules sections are based on ideas and patterns from these books:
- Frontend — React Mega-Tutorial by Miguel Grinberg
- Testing — Angry Tests by Yegor Bugayenko