Instruction file imported from aiprocadm/prt_ot_doc (
.cursor/rules/ai-agent-workflow.mdc). Copyright stays with the author.
Рабочий цикл агента
- Порядок:
README.md(ссылки на ТЗ/релиз/runbook).docs/spec/TZ_FULL_UNIFIED.md— канонический источник истины (раздел A — MVP, раздел B — полный объём, раздел E — правила доработки, §0.2 — протокол «сверка → выбор → код»).AI_IMPLEMENTATION_REPORT.md— последний handoff. «Следующий точный шаг» — гипотеза прошлой волны, а не приказ.- Сверка с ТЗ (обязательная, §0.2 канона): статусы в матрице/отчёте — заявления, не факты. Закрой хвост прошлого handoff («[ЗАПОЛНИТЬ]» / «НЕ ПРОГНАНО» / «⚠️ ОСТАЛОСЬ»); для целевых строк
docs/audit/TZ_COVERAGE_MATRIX.mdоткрой evidence-пути и прогони тесты строки; spot-check 2–3 смежныхdone; вердикты: сделано / не сделано / переделать. Расхождения → понизь статус (+python scripts/audit/check_tz_coverage_matrix.py) до новой работы. - Релевантные доки рядом с модулем.
- Только потом — код.
- Не меняй код до шагов 1–4, кроме явного P0-инцидента (тогда кратко зафиксируй в
AI_IMPLEMENTATION_REPORT.md). - Полная инструкция:
docs/AI_AGENT_WORKFLOW.md(мусор/дубли, запреты, проверки, формат краткого ответа). - После волны:
- обнови
AI_IMPLEMENTATION_REPORT.md(handoff: блок «Сверка» — что проверено и вердикты; что сделано, какие файлы, проверки, риски, «Следующий точный шаг»); - при необходимости —
docs/audit/TZ_COVERAGE_MATRIX.md(done— только с evidence: файлы + прогнанные тесты) иCHANGELOG.md; README.md— только если сменились ссылки, запуск или навигация.
- обнови
- «По ТЗ» без имени файла —
tz-spec-priority.mdc+AGENTS.md. Точка входа:docs/spec/TZ_FULL_UNIFIED.md. - В чате — кратко по пунктам §10 workflow, начиная с блока «Сверка с ТЗ»; детали — в
AI_IMPLEMENTATION_REPORT.md.