# qadam-core — Project Instructions

## Источники задач
Все задачи и требования описаны в проектных `.md` файлах этого репозитория.
Перед любой работой сначала собери список project `*.md` вне vendor-деревьев (`node_modules`, `.git`).
Не читать markdown-файлы из vendor-деревьев и не читать весь markdown-слой подряд без фильтрации по этой области.
Читать нужно релевантные задаче документы из этого project-набора; если задача относится ко всему документационному слою, допускается чтение всего отфильтрованного списка.

## Структура docs/
- `docs/quality_report.md` — пишет агент quality_analytic
- `docs/engineering_log.md` — пишет агент engineer
- Не удалять и не перезаписывать чужие файлы — только дополнять (append)

## Контракт журналов агентов

### quality_analytic
- Каждый запуск `quality_analytic` обязан завершаться новой записью в `docs/quality_report.md`.
- Ответ в чат не считается завершением задачи без записи в `docs/quality_report.md`.
- Записи добавляются только в конец файла; предыдущие записи не редактировать и не удалять.
- Если замечаний нет, агент всё равно обязан добавить запись со статусом `ПРИНЯТО`.
- Формат записи и обязательные поля брать из `docs/quality_report.md`.

### engineer
- Каждый запуск `engineer` обязан завершаться новой записью в `docs/engineering_log.md`.
- Ответ в чат или stdout не считается завершением задачи без записи в `docs/engineering_log.md`.
- Записи добавляются только в конец файла; предыдущие записи не редактировать и не удалять.
- При новом запуске добавлять только новую секцию `## Сессия — ...` после последней записи, не дублировать заголовок файла, паспорт документа, контракт или шаблон.
- Даже если агент ничего не менял, он всё равно обязан зафиксировать результат прогона и статус в журнале.
- Формат записи и обязательные поля брать из `docs/engineering_log.md`.

## Соглашения
- Язык кода: Python
- Стиль: следовать существующим паттернам в репозитории
- Тесты: запускать после каждого изменения
- Документация: если меняешь поведение — обнови соответствующий .md