ADR-0001: Bootstrap boundary: humans wire, the DevLoop buildsГраница начальной настройки: человек делает обвязку, DevLoop — всё остальное
ContextКонтекст
This repository exists to be evidence that the mctl DevLoop can build and run a real site. Every file a human writes weakens that evidence — and a repository with no review gate cannot host a DevLoop cycle at all, so some human wiring is unavoidable.
Этот репозиторий существует как доказательство того, что mctl DevLoop способен построить и поддерживать настоящий сайт. Каждый файл, написанный человеком, ослабляет это доказательство, но репозиторий без шлюза проверки вообще не может вместить цикл DevLoop, поэтому часть обвязки приходится делать руками.
DecisionРешение
Humans create and edit only the wiring: the repository itself, README.md, AGENTS.md, LICENSE, .gitignore, the release-please configuration and manifest, repository settings, secrets, labels, the branch ruleset, and the three files that gate the loop itself — .github/workflows/claude-review.yml, .github/workflows/release-please.yml and .github/dependabot.yml. Every other file — the Astro project, Dockerfile, nginx.conf, content, journal, ADRs, scripts and every other workflow under .github/workflows, among them build.yml and agent-trailer-check.yml — arrives through a DevLoop cycle, and every deployment action goes through the mctl MCP tools.
Человек создаёт и правит только обвязку: сам репозиторий, README.md, AGENTS.md, LICENSE, .gitignore, конфигурацию и манифест release-please, настройки репозитория, секреты, метки, правила ветвления и три файла, которые охраняют сам цикл, — .github/workflows/claude-review.yml, .github/workflows/release-please.yml и .github/dependabot.yml. Все остальные файлы — проект Astro, Dockerfile, nginx.conf, контент, журнал, ADR, скрипты и все прочие воркфлоу в .github/workflows, в том числе build.yml и agent-trailer-check.yml, — появляются через цикл DevLoop, а любое действие по развёртыванию выполняется инструментами mctl MCP.
ConsequencesПоследствия
A trivial fix waits for a full cycle, and any human edit outside the wiring list is a manual intervention that must be recorded in the journal entry of the next cycle. In exchange the repository history is itself the claim the site makes.
Тривиальная правка ждёт полного цикла, а любая правка человека вне списка обвязки считается ручным вмешательством и обязательно фиксируется в записи журнала следующего цикла. Взамен история репозитория сама становится утверждением, которое делает сайт.
DriversДвижущие факторы
The site must be evidence, not a claim.
Сайт должен быть доказательством, а не заявлением.
Revisit criteriaКритерии пересмотра
Revisit if a trivial change takes more than two working days end to end.
Пересмотреть, если тривиальное изменение проходит путь от задачи до продакшена дольше двух рабочих дней.