** Английский ** *Русский **

##Что это такое?

** Готовый к использованию инструментарий**, который заряжает Claude Code для разработки Python и автоматизации QA. Как только вы опускаете его в свой проект, Клод Код мгновенно становится старшим инженером Python, который следует точным стандартам вашей команды.

** Без этого инструментария** — Клод Код — умный генералист. ** С помощью этого инструментария ** — Claude Code пишет Pythonic-код, проектирует архитектуры, генерирует тестовые пакеты OOP с Allure, проверяет уязвимости OWASP и следует вашим точным соглашениям.

Как работает конфигурация кода Claude

Когда вы запускаете код Клода в проекте, он читает специальные файлы из каталога:

Этот инструментарий предоставляет все эти компоненты, предварительно настроенные для Python.

Компоненты объяснены

###CLAUDE.md - Мозг

Самый важный файл **. Садитесь в корень вашего проекта. Клод читает его в начале каждого разговора и следует ему как закону.

Наш CLAUDE.md включает в себя: Python Conventions (PEP 8, подсказки типа, черный/рюфф/мипи)

• Строгие правила тестирования ООП (классы, уровни обслуживания, Очарование - обязательно)
• Рамочные правила (FastAPI, Django, SQLAlchemy, Celery)

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/