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