Конец начала - начало конца

Приветсвую всех сюда входящих! В ходе долгих размышлений и изучения system design, а также паттернов проектирования и ведения продукта, я пришел к выводу, что "Something" as code очень неплохой паттерн проектировая. Но обо всем по порядку. И начну я как всегда с истории о том, как я к этому пришел.

Глава 1. Бесконечное пространстоCopy Anchor Link

Мы создаем, что-то делаем, ставим задачи и проектируем. Время идет, задачи меняются, но постоянный вопрос ко мне так и остается: "Что будет финалом нашего продукта". Если коротко - я не знаю :). Если развернуто - никто не знает. НО! знать надо :) или иметь хотя бы представление...

За все свои 3 года работы в команде, я пришел к выводу: если люди не знаю, что они делают, то продукта не будет, ведь каждый имеет свое представление о прекрасном. Вот например, чтобы разработчик сделал свою работу - необходимо ТЗ, но почему? Давайте разбираться. Я - заказчик, вы - разработчики.

Я:

• Мне нужно сделать крутой сайт для школ

Вы:

• Что на нем должно быть? Какой функционал? Какие пользователи?

Я:

• "Что-то рассказал"

Вы:

• Понял, делаю...

Неделю спустя... Все забыли...

И это нормально, так работает память человека. И чтобы долго не растягивать, я сразу скажу, что хочу донести до вас: "Хранить на надо не в голове, а на каком-либо надежном носителе". Думаю, что всем понятно почему так(особенно после моего прекрасного примера :)).Но речь даже не об этом, она о бесконечном разнообразии инструментов для этого и не только...

Сегодня утром 10.10.2026 я понял, что у нас нет виденья... Сначала я зашел в Linear, чтобы проверить задачи и актуализировать их. Затем посмотрел сообщения в группе тг, зашел в miro и подумал, а что вообще делать... Вернее даже не так, а что мы вообще делаем...? Посмотрел docs репу в gitlab и еще больше запутался. Тогда то я и понял, что нужно что-то менять.

Глава 2. Все в одномCopy Anchor Link

ChatGPT навел меня на интересный кейс с ведением продукта: gitlab. GitLab мигрировал с Miro на хранение диаграм в коде(diagram as code) + уже использовал методологию хранения документов в коде(docs as code). И мне показалось это идеальным вариантом для версионирования и поддержания всего в одном месте. Но ведь мы так уже пробовали скажете вы, а я отвечу: да, но мы хранили все доки в одном месте, а теперь здесь будет общая база знаний, ссылок и тд, но подробности будут храниться в отдельных репозиториях, с удобной навигацией. Ну и самое главное - интерфейс, в котором вы собственно это и читаете :)

Что дальше?Copy Anchor Link