КОНТЕКСТБЛОК: {BLOCK_NAME}

ID: [{ID}]
Проект: {project_name}
Статус: planned|in_progress|completed
Тип: CODE|DOCS|OPS|DESIGN|CONTENT|TEST
Версия: {version}

ГРАНИЦЫ

ЧТО ДЕЛАЕТ:
{описание одним предложением}

ЧТО НЕ ДЕЛАЕТ:
- {что вне границ блока}
- {что делают другие блоки}

СТРУКТУРА

path/to/block/
├── BLOCK.md           ← это описание
├── {main_file}        ← entry point
├── {additional_files}
├── tests/
│   └── test_*.py
└── data/
    └── fixtures.*     ← тестовые данные

ЗАВИСИМОСТИ

Внешние библиотеки

• library_name (version)

Другие блоки

• [BLOCK_ID] → что использует

Shared данные

• shared/api.yaml → endpoints
• shared/constants.py → CONFIG

КЕШ ИЗ ЗАВИСИМОСТЕЙ

Важные данные из зависимых блоков (чтобы не читать их целиком):

# Из [AUTH] блока
def validate_token(token: str) -> bool:
    """Проверяет JWT токен.

    Args:
        token: JWT строка

    Returns:
        True если валиден

    Raises:
        TokenExpired: токен истёк
        TokenInvalid: невалидный токен
    """
    pass

# Из [CONFIG] блока
SECRET_KEY: str = "..."  # JWT секрет

ИНТЕРФЕЙС

Вход

• {параметры, данные}

Выход

• {результат, возвращаемые значения}

Ошибки

• Error1: когда возникает
• Error2: когда возникает

РЕАЛИЗАЦИЯ

{краткое описание подхода, алгоритма}

ТЕСТИРОВАНИЕ

Критерии готовности

• [ ] Все функции реализованы
• [ ] Тесты пройдены (100% pass)
• [ ] Type checking (mypy/tsc) пройден
• [ ] Документация обновлена
• [ ] Интеграция с зависимыми блоками работает

Тест-кейсы

1. {название кейса} — {что проверяет}
2. {название кейса} — {что проверяет}

Команда запуска тестов

{команда для запуска тестов этого блока}

МЕТРИКИ

• Размер: ~N строк/слов
• Оценка: N минут
• Сложность: low|medium|high
• Приоритет: 1-5

ИСТОРИЯ