Зачем я завел этот инженерный блокнот

Как прогулка с собакой, Codex, Git и Astro сложились в простой сайт для рабочих заметок.

Гулял с собакой и почитывал разное про локальные модели, и где-то между “интересно, куда это всё приехало за последние месяцы” и “надо бы потом попробовать” поймал простую мысль: хочется уметь взять одну маленькую идею прямо с телефона, закинуть ее в Codex и посмотреть результат. Вот прямо со смартфона.

Понятно, что куча людей уже так живет, поставил задачу агенту, он поправил код, сделал pull request, CI/CD собрал и выкатил, но я почти все время сижу именно за ноутом, а на прогулках больше отдыхал. Но тут лето, прогулки становятся длиннее, особенно по выходным, и идеи тоже начинают приходить не тогда, когда ты удобно сидишь за монитором, а где-то между деревьями, поводком, телефоном в руке и мыслью, что вот эту штуку хорошо бы сразу попробовать, просто чтобы посмотреть, как оно.

Проблема в том, что пока дотопаешь до дома, пока сядешь за ноут, пока переключишься обратно, мысль уже либо остыла, либо ее перебили другие дела. А иногда еще и сам себя убедишь, что да ерунда какая-то была, не стоит возиться. Хотя если бы получилось сразу сделать маленький прототип и посмотреть, может, оказалось бы, что не такая уж и ерунда.

Так появилась идея сделать простой личный сайт для заметок. Не большой блог, не портфолио, не систему управления знаниями на все случаи жизни, а просто место, куда можно складывать рабочие мысли, короткие разборы и чек-листы. А заодно проверить сценарий, который давно хотелось попробовать: придумал идею с телефона, сформулировал задачу, Codex внес изменения в Git, сайт пересобрался, результат сразу на экране смартфона. Обкатать процесс.

Почему именно заметки

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

В инженерной работе таких повторяющихся “следующих разов” много. Сегодня разбираешься, почему маленькая правка не маленькая. Завтра снова объясняешь, почему контент на production и Git плохо дружат без правил. Послезавтра вспоминаешь, что надо было заранее спросить у интеграции про ошибки, ограничения и тестовые данные.

В какой-то момент понимаешь, что держать это всё только в голове так себе архитектура, потому что голова отлично подходит для думать, но довольно плохо подходит для хранить все рабочие выводы, особенно если эти выводы вспоминаются ровно тогда, когда уже поздно.

Что такое Astro и почему он здесь

Сайт сделан на Astro. Если совсем по-простому, Astro это инструмент для сайтов, где главный продукт это контент: заметки, документация, блог, страницы с текстами. Ты пишешь материалы в Markdown-файлах, а Astro собирает из них обычный быстрый статический сайт.

Для моего случая это почти идеально, потому что не нужна база данных, не нужна админка, не нужен серверный runtime на production, заметка это обычный файл в Git, изменения проходят через публикацию и CI/CD сайт автоматически собирается и выкладывается.

То есть Git становится хранилищем контента, Astro сборщиком сайта, а Codex помощником, который может по задаче создать или поправить заметку. Это не самая сложная архитектура на свете, и хорошо, потому что для личного инженерного блокнота сложная архитектура была бы подозрительна.

Как это собиралось

Сначала я в веб-чате GPT прикинул, что вообще можно сделать, какой стиль, какая структура, нужен ли сайт, нужна ли база, как лучше организовать контент, узнал про Astro. Потом подключил GitHub, завел репозиторий. После через Image2 накидал дизайн-референсы и попросил Web-Codex собрать первый MVP.

Получился простой статический сайт с главной, заметками, контентом в Markdown, сборкой на Astro. Потом уже дома, через локальный Codex, спокойно довел верстку, деплой и окружение.

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

Что здесь будет

Скорее всего, здесь будут заметки про то, с чем я реально сталкиваюсь: Bitrix и большие старые сайты, Git и production, который живет своей жизнью, интеграции, API и 1С, оценки задач, и конечно вайб-кодинг и работа с моделями и агентами, которые помогают во всем вышеописанном.

Это не учебник и не попытка изображать гуру. Скорее публичная рабочая тетрадь. Главный принцип простой: не идеально, но понятно и работает.

А если какая-то заметка через полгода поможет мне самому не разбираться заново, значит, сайт уже был не зря.