Files
portal/docs/superpowers/specs/2026-06-16-commit-gitea-probe-artifacts.md
T

4.5 KiB

Фиксация в репозитории документов диагностики бэкап-сервера

Цель

Зафиксировать в системе контроля версий два документа проведённой диагностики резервного сервера Gitea — спеку пробы и её рабочий план — чтобы результат работы сохранился в истории репозитория и в резервных копиях. Это документально-фиксирующая задача: содержимое файлов уже готово, требуется только аккуратно занести ровно эти два файла в индекс, создать коммит и отправить его в удалённый репозиторий. Никакие другие файлы не затрагиваются.

Контракт фиксации

Фиксируются ровно два файла:

  • docs/superpowers/specs/2026-06-16-gitea-backup-status-probe.md — спека пробы состояния сервера;
  • docs/superpowers/plans/2026-06-16-gitea-backup-status-probe-v3.md — её рабочий план.

Порядок: (1) занести оба файла в индекс командой git add с явным перечислением путей — никаких массовых add -A, чтобы не зацепить посторонние изменения рабочего дерева; (2) создать коммит с описательным сообщением без круглых скобок и с трейлером соавторства; (3) отправить коммит в удалённый репозиторий командой git push. Каждая команда — одиночная, без цепочек.

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

Крайние случаи

  • Отправка отклонена удалённым. Если git push падёт с ошибкой доступа (по прежним записям внешний GitHub-аккаунт мог быть заблокирован, код 403), коммит всё равно остаётся в локальной истории, а полная копия истории хранится на резервном Gitea-сервере. Тогда отправку повторяют позже либо через резервный канал; данные не теряются.
  • Посторонние изменения в дереве. В рабочем дереве есть прочие незакоммиченные файлы; явное перечисление путей в git add и изоляция коммита по этим же путям гарантируют, что в коммит попадут только два целевых документа.

Критерий успеха

Задача завершена, когда создан коммит, содержащий ровно два перечисленных файла, с корректным сообщением, и предпринята попытка отправки в удалённый репозиторий. Результат отправки (успех или отказ доступа) сообщается владельцу как есть, без приукрашивания.

Конвенция оформления

Сообщение коммита — без круглых скобок, с обязательным трейлером Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>. Отчёт владельцу — простым языком: что закоммичено и прошла ли отправка.

[
  {"id":"vc1","kind":"EXTRACTED","ref":"docs/superpowers/specs/2026-06-16-gitea-backup-status-probe.md","anchor":"Контракт пробы"},
  {"id":"vc2","kind":"EXTRACTED","ref":"docs/superpowers/plans/2026-06-16-gitea-backup-status-probe-v3.md","anchor":"три независимых read-only сигнала"}
]