Python Stack for Claude Code

English | Русский

---

What Is This?

A ready-to-use toolkit that supercharges Claude Code for Python development and QA automation. Once you drop it into your project, Claude Code instantly becomes a senior Python engineer who follows your team’s exact standards.

Without this toolkit — Claude Code is a smart generalist. With this toolkit — Claude Code writes Pythonic code, designs architectures, generates OOP test suites with Allure, reviews for OWASP vulnerabilities, and follows your exact conventions.

How Claude Code Configuration Works

When you run Claude Code in a project, it reads special files from a .claude/ directory:

your-project/
├── CLAUDE.md              # Main instructions — "the brain"
├── .claude/
│   ├── rules/             # Always-on guidelines (activate by file type)
│   ├── skills/            # Deep knowledge (activated when context matches)
│   ├── agents/            # Specialized sub-agents (reviewers, planners, etc.)
│   ├── commands/          # Slash commands you type (/plan, /tdd, /verify)
│   └── hooks.json         # Automatic actions (format on save, type check)
└── src/

This toolkit provides all of these components, pre-configured for Python.

---

Components Explained

CLAUDE.md — The Brain

The single most important file. Sits in your project root. Claude reads it at the start of every conversation and follows it as law.

Our CLAUDE.md includes:

• Python conventions (PEP 8, type hints, black/ruff/mypy)
• Strict OOP test rules (classes, service layers, Allure — mandatory)
• Framework rules (FastAPI, Django, SQLAlchemy, Celery)
• Database rules (PostgreSQL types, indexes, N+1 prevention)
• Security rules (no eval, no hardcoded secrets, bandit)
• All available commands and agents listed

Think of it as: an onboarding doc for a new team member. Everything they must always follow.

---

Rules — Always-On Guidelines

Location: rules/ → copy to .claude/rules/

Markdown files that auto-activate by file pattern. Edit a .py file — Python rules kick in automatically.

---
paths:
  - "**/*.py"
---
# Python Coding Style
- Follow PEP 8
- Type annotations on all public functions
- black for formatting, ruff for linting

Rules vs CLAUDE.md: CLAUDE.md = always on for everything. Rules = activate conditionally by file type.

---

Skills — Deep Knowledge On Demand

Location: skills/ → copy to .claude/skills/