# Инструкции для агентов в `docs/delivery/**`

## Назначение

`docs/delivery/**` хранит правила поставки, трассируемость, карты связей и документы приёмки новой версии платформы.

## Перед изменениями

- Читать `docs/AGENTS.md`.
- Читать `docs/delivery/README.md`.
- Читать `docs/delivery/issue-map/index.md`, если меняется карта связей.
- Читать `docs/templates/index.md` и выбирать шаблон поставки под тип создаваемого документа.

## Карта связей

- Не создавать единый большой `issue_map.md`.
- Общий файл `docs/delivery/issue-map/index.md` должен оставаться индексом и краткой навигацией.
- Доменные связи вести в `docs/delivery/issue-map/domains/<domain>.md`.
- Связи отдельных рабочих срезов вести в предназначенных для них файлах внутри `docs/delivery/issue-map/**`.
- Если добавлен новый домен, добавить доменную карту и ссылку на неё в индекс.

## Рабочие срезы

- Планы и результаты рабочих срезов размещаются в принятой структуре `docs/delivery/**`.
- Документ рабочего среза должен ссылаться на домены и карты, но не дублировать большие таблицы из доменных файлов.
- Если рабочий срез меняет структуру документации, в том же PR обновляются соответствующие `AGENTS.md` и `README.md`.
- Координацию параллельных доменных агентов вести в `docs/delivery/coordination/**`: общий файл `agents.md` содержит только стабильный индекс агентов и зон ответственности, а текущий прогресс, временные переключения, блокировки и подробный бэклог лежат в отдельном файле агента.

## Правила содержания

- Документы поставки фиксируют порядок работ, приёмку и трассируемость, а не заменяют продуктовую или архитектурную канонику.
- Статусы документов в PR должны отражать целевое состояние после merge.
- Для текущей программы рефакторинга не переносить старые исторические материалы из `deprecated/**` механически.
