Перейти к содержимому

Software Development Flow

Software Development Flow реализует одно полное программное изменение как независимо принимаемые вертикальные units. Он владеет всем результатом репозитория — production code, тестами, coverage, документацией, schemas/types, generated/config outputs, compatibility и integration consequences — вместо разделения одного lifecycle между несколькими task workflows.

Окно терминала
mcp__moira__execution({
action: "prepare",
workflowId: "moira/software-development-flow",
parentExecutionId: "none"
})
mcp__moira__execution({ action: "execute", startAttemptId: "<ID попытки запуска из prepare>" })

Flow фиксирует source-grounded требования и полномочия, определяет одну простую visual preference (disabled, screenshots или html_report), создаёт и независимо проверяет architecture-aware план, после чего именно текущий план становится единственным источником visual и user-approval policy каждого unit. Flow готовит каждый unit по реальному репозиторию до изменений, реализует полное поведение с тестами и завершает работу исполнителя до проверок. После прохождения применимых проверок обновляется затронутая постоянная документация, затем проводится независимое ревью полноты unit. Найденный при документировании дефект продукта возвращает работу к реализации и проверкам, которые он затрагивает.

screenshots один раз снимает и действительно просматривает необходимые состояния. html_report переиспользует эти же принятые изображения в self-contained отчёте, загружает его через Moira Artifact API и отправляет публичный URL через настроенные каналы связи текущего пользователя; второй screenshot pass не выполняется. Сбой Artifact upload блокирует unit. Отсутствие настроенных каналов или ошибка отправки в достигнутой notification node не блокируют работу. Interactive approval плана, выбранных units и финального результата получает attention notification и ждёт решения в обычной директиве. В autonomous mode human-approval directives отсутствуют. Исключение — досрочное завершение всего запуска, и это не approval: когда блокер не снимается или unit не может быть закрыт, flow сообщает, что именно останется незавершённым, и завершает запуск только по явному подтверждению пользователя, которое autonomous mode никогда не выводит сам.

Findings классифицируются как product, test/validation, evidence, documentation/projection, invalid criterion или upstream plan/process defects. Product repair возвращается через producer completion. Verification-only и gate-local repair повторяют только устаревшие evidence. Mixed или invalid causes приводят к quality-preserving replan, а не к расширению реализации по сломанному контракту.

Каждый producer, validator, reviewer, repair role, checkpoint и report role текущего unit получает полный утверждённый unit из plans/{{plan_revision}}/plan.md. Эта активная ревизия остаётся источником истины после любого replan; запомненная формулировка и previous_plan_revision не являются входами исполнения. Только пять revision writers намеренно читают обе ревизии: они сохраняют исторический источник и записывают уже увеличенную текущую ревизию. Финальное cross-revision review может использовать исторические evidence с явным указанием ревизии происхождения, но не заменяет ими контракт активного плана.

Если исходный запрос уже разрешает последующий caller-owned push, pull request, publication, release или deployment, SDF во время intake сохраняет это намерение через execution reminder API текущего execution. Запись требует текущую ревизию шага workflow, но не увеличивает её и не делает предъявленную попытку шага недействительной. При обычном завершении standalone и child запусков reminder возвращается в Next requested actions. Он не становится unit плана разработки, не меняет vcs_commits_authorized, не выполняет действие и не даёт новых полномочий.

Runtime, browser, visual, integration, performance и full-suite checks остаются условными для конкретной фичи и репозитория. Постоянная документация закрывается вместе со своим unit. Одно общее финальное смысловое ревью сверяет весь результат с требованиями, включая согласованность документации между units; отдельной сверки только документации нет. Финализация включает общие проверки изменения, покрытие требований, фактический отчёт и локальную VCS reconciliation в пределах полномочий. Запуск завершается одним из трёх способов, и каждый отправляет best-effort уведомление через настроенные каналы пользователя: он завершается полностью; он завершается досрочно по явному подтверждению пользователя; либо разработка доведена до конца, а локальная финализация осталась заблокированной — и это сообщается именно так, а не как полностью завершённый запуск.

Первый шаг сохраняет название задачи с актуальными ревизиями до завершения. Его меняет только разрешённое изменение самой задачи; необязательная execution_note (до 120 символов) остаётся отдельно.

Настроенные каналы получают английский текст с заголовком флоу и задачи, ссылкой на запуск, целью, списком единиц, текущим итогом или блокером и ссылками на отчёты, без картинок и внутренних имён переменных. Исправленный план объявляется снова. Интерактивные сообщения согласования плана, выбранной единицы и финальной приёмки объясняют выбор; автономные запуски этих согласований не спрашивают.

Шаги-блокеры ждут человека в обоих режимах: исправить внешнее условие и повторить либо явно завершить весь запуск. При заблокированной финализации можно также закончить без финального локального коммита. Интерактивное закрытие единицы запрашивает согласие на пересмотр плана; автономное следует подтверждённой причине или спрашивает о завершении запуска. Полное завершение, завершение без коммита и подтверждённое пользователем досрочное завершение сообщаются раздельно, с ограничениями, состоянием локальных коммитов и дальнейшими действиями; итоговый список не показывает выполняющихся единиц.

Финальный и поединичные HTML-отчёты — самодостаточные публикации Artifact API; URL использует HTTP или HTTPS конкретного инстанса. Без каналов старт отклоняется, если новая подготовка явно не использует skipNotificationCheck: true; ошибка доставки не останавливает запуск.

Шаги, где SDF ждёт вашего решения, помечены как ждущие вас: подтверждение требований, согласование плана, приёмка единицы, закрытие единицы, финальная приёмка и шаги-блокеры (проверка здоровья, проверка в работе, широкая и финальная проверки, финализация). Пока запуск стоит на одном из них, страница запуска и его прогресс говорят ждёт вас и что от вас нужно, а сообщение с вопросом заканчивается строкой 🙋 waiting for you. Шаги-блокеры ждут вас и в автономном запуске — изменить внешнее состояние или завершить запуск можете только вы, — поэтому помечены в обоих режимах; закрытие единицы автономный запуск решает сам, и там ждущим вас не показан. Где флоу шлёт своё сообщение перед шагом, оно и есть первое уведомление; перед подтверждением требований сообщения нет, поэтому Moira уведомляет вас сама. Если ответа нет сутки, Moira один раз напоминает со ссылкой на запуск.

Представление процесса следует записанному маршруту и текущей ноде, показывая план, завершённые единицы и текущую работу. Исправление или перепланирование открывает соответствующий этап без выдуманных состояний. Данные отображения не меняют маршруты и полномочия. См. Представление процесса.

Используйте Software Development Flow для реализации в репозитории любого размера: его план и условные проверки масштабируются под фактическое изменение, сохраняя единый полный software lifecycle. Границы security/privacy, постоянные данные и migrations, breaking public contracts, несколько vertical units, неразрешённая архитектура и сложный rollout/recovery требуют более сильных units и evidence внутри этого же flow. Quick Task и Robust Task не заменяют software lifecycle.

Development-plan SDF может включать явно разрешённые локальные commits или checkpoints. Push, создание или merge pull request, publication, release и deployment являются работой caller или parent process и никогда не становятся development-plan units. Запуск SDF не разрешает notification, production mutation или administrative override; любой side effect остаётся ограничен originating authority.

SDF не объявляет externally writable runtime variables. Агент может просматривать registry через execution (action: "variables"), но visual settings, VCS authority, plan cursors и все остальные переменные SDF остаются read-only благодаря default-deny runtime policy.