Engineering and Delivery

Обновлено: 2026-07-16

SDD → vertical slice → evidence

1. Frame: outcome, non-goals, owner, scope и risks.
2. Specify: SDD/contract до реализации, если меняются flow, data, security, billing, integration или distribution.
3. Inspect: текущий code, tests, API и соседние patterns.
4. Implement: один законченный vertical slice вместо набора несвязанных внутренних изменений.
5. Verify: narrow tests, build, integration/E2E и visual QA по риску.
6. Reconcile: code, SDD и acceptance criteria должны описывать одну реальность.
7. Deliver: outcome, diff scope, evidence, risks и follow-up.

Scope discipline

• Не расширять задачу молча.
• Не переписывать рабочую область целиком без обоснованной необходимости.
• Не откатывать изменения пользователя или параллельного исполнителя.
• Проверять git status до edit, staging и commit.
• В mixed worktree staging выполняется явным списком файлов.
• Временный workaround получает причину и follow-up.
• Breaking contract требует ADR, migration и rollback plan.

Verification evidence

• Запускаются task-specific команды, затем общие checks по типу изменения.
• Build не заменяет interaction test.
• Unit test не заменяет integration contract.
• E2E не заменяет visual review.
• Screenshot не заменяет functional test.
• В handoff указываются точные команды и число passed/failed.
• Незапущенная проверка сопровождается причиной и residual risk.

Definition of Done

Задача готова, когда:

• пользовательский outcome реализован в заявленном scope;
• acceptance criteria наблюдаемы и проверены;
• SDD/ADR и implementation согласованы;
• tests/build/E2E/visual QA соответствуют риску;
• security и data boundaries не нарушены;
• unrelated changes сохранены;
• documentation и memory bank обновлены;
• follow-up оформлен как task, а не спрятан в финальном сообщении;
• release/deploy имеет rollback path, если меняет production.

Git delivery

• Одна branch и commit series описывают один outcome.
• Commit message коротко объясняет результат.
• Перед commit проверяются staged diff, git diff --check и релевантные tests.
• Commit, push, PR, merge и deploy — разные действия и требуют соответствующего scope.
• PR объясняет что изменилось, почему, влияние, evidence и риски.
• Default PR остаётся draft до прохождения обязательных checks, если команда не договорилась иначе.

Agent handoff

Исполнитель возвращает:

• фактический scope и изменённые файлы;
• состояние acceptance criteria;
• команды проверки и результаты;
• screenshots/reports/artifacts;
• риски и blockers;
• SDD/ADR/backlog updates;
• список намеренно нетронутых изменений.

Ответ «готово» без evidence не считается handoff.