Как соавторствовать¶

Порядок¶

Правки вносятся через pull request — прямой коммит в main не принимается. Это не формальность: точка, где человек сказал «да», должна быть видна в истории, и методология описывает ровно этот принцип для агентов.
Одна правка — одна тема. PR, меняющий три раздела по трём разным поводам, невозможно обсудить.
В описании PR — что меняется и почему. Если правка опирается на источник, ссылка обязательна.

Требования к содержанию¶

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

Зрелость называется по шкале. идея — текст без применения. пилоты — одна-две названных команды. промышленная практика — несколько независимых внедрений или числа. Рядом со шкалой указывается, чем оценка подтверждена.

Вендорский источник помечается. Материал компании, продающей платформу, полезен, если в нём описан процесс, но читатель должен видеть, что сторона заинтересована.

Числа приводятся с методикой. «До 95% сокращения» без описания замера — реклама, а не число; такие формулировки в текст не берутся, либо берутся с явной пометкой, что это заявление вендора.

Отрицательный результат записывается наравне с положительным. Что пробовали и отвергли — отдельный раздел, а не умолчание.

Чего здесь не делаем¶

Не ссылаемся на личные рабочие системы участников как на доказательство.
Не пишем «AI-powered», «agentic», «self-healing» без описания процесса за словом. Приложение с детектором маркетинга — про это.
Не переписываем чужой плейбук: если мысль взята, у неё есть автор и ссылка.

Устройство репозитория¶

docs/
  index.md                   титульная
  playbook/skeleton.md       каркас методологии
  razvedka/otchet.md         сведённые выводы разведки
  razvedka/materialy.md      список источников
  razvedka/ramka.md          сетка, по которой опрашивался рынок
  razvedka/drafts/           полные карточки по слоям: артефакты, роли, права агента
  process/contributing.md    этот файл
mkdocs.yml                   навигация и сборка сайта

Сайт живёт на https://ai-native-sdlc-6g0.pages.dev. Публикация запускается с сервера командой ./deploy.sh — токен Cloudflare ограничен по IP, поэтому автоматический деплой из GitHub Actions не проходит. Дата последней правки под каждой страницей берётся из истории git.