functional-clarity

# Functional Clarity Plugin

Принципы "Функциональной ясности" — философия разработки надежного, простого и понятного кода.

## Что это

Набор из 22 принципов и стилевых рекомендаций для написания кода, который:
- Легко понять и поддерживать
- Падает быстро и честно (fail-fast, без Error Hiding)
- Минимально сложен для решаемой задачи
- Использует современные возможности Python

## Что получаете при установке

- **SessionStart hook** — краткое напоминание ключевых принципов при старте каждой сессии
- **Skill `functional-clarity`** — полный набор принципов, загружается автоматически при упоминании "принципы", "code quality", "fail-fast", "рефакторинг" и др.

## Установка

```bash
claude --plugin-dir plugins/functional-clarity
```

Или добавьте в настройки проекта/глобальные настройки Claude Code.

## Ключевые принципы

1. Ограниченная зона ответственности (20-30 строк на функцию)
2. Минимальные изменения (расширяй, не дублируй)
3. Fail-Fast архитектура (graceful degradation только через feature flags)
4. Явная обработка ошибок (запрет Error Hiding)
5. Современный Python (типы, pathlib, context managers)

Полный список — 22 принципа — доступен через skill `functional-clarity`.

## Совместимость

Дополняет плагин `tdd-master`:
- **functional-clarity** — КАК писать код
- **tdd-master** — КОГДА писать тесты