Перейти к содержимому

Общие правила и знания для своих проектов, не привязанные к одному проекту.

Раздел Что Как меняется Как на него ссылаются
Стандарты правила: «так делаем», проверяемо — соответствует / не соответствует редко, с версией и записью в «Истории» по имени и версии: «jcb-git-workflow v1.0»
Приложение 1 к стандарту как я выполняю стандарт на своих примерах и технологиях; ничего не требует свободно, без версии не ссылаются: читают, когда нужно
Гайды как сделать конкретное дело, по шагам: подключить службу, настроить инструмент, пройти процедуру по мере того, как меняется то, о чём гайд не ссылаются

Документ — стандарт, если по нему можно сказать «проект соответствует / не соответствует». Ответ на «почему» или «как» — приложение: у каждого стандарта своё «Приложение 1» на моих примерах.

Код Документ Версия О чём
jcb-git-workflow Ветки и версии v1.0 dev / main, слияния --no-ff, версии v<год>.<номер>
jcb-git-public-ready Репозиторий готов к публикации v0.1 личное — в private/ и *.local*, стоп-лист и сканер секретов перед коммитом
jcb-git-private-backup Бэкап личного v0.1 private/ — свой репозиторий, зашифрованный целиком, копия вне машины, проверка восстановления
jcb-dotenv Настройки только в .env-файлах v1.0 один набор переменных во всех файлах, переключатели явно
jcb-devports Порты v1.0 блок из 10 портов на проект, реестр вне репозиториев
jcb-external-services Внешние службы v1.0 без службы — без функции, модуль на службу, решение на сбой
jcb-testing Автопроверки v0.1 против production-сборки, виды server / ui / e2e, тестовые ручки
jcb-deploy Сборка и выкладка v0.1 образ, миграции при старте, /_health, списки до и после выкладки

Версия — v<старший>.<младший>: правило поменялось по сути (проект может перестать соответствовать) — старший номер (v2.0); добавилось или уточнилось, не ломая соответствия, — младший (v1.1). v0.x — черновик: может меняться как угодно, без новой старшей версии.

Проект, который следует стандартам, перечисляет их с версиями в своём CLAUDE.md (или README): jcb-git-workflow v1.0, jcb-dotenv v1.0.

Чтобы Claude в проекте знал стандарты, добавь в CLAUDE.md проекта одну строку — принятые стандарты с версиями и оглавление:

Стандарты: jcb-git-workflow v1.0, jcb-dotenv v1.0 — https://justcatboy.github.io/jcb-notes/llms.txt
Файл Что
llms.txt оглавление: как пользоваться и ссылки на .md всех документов
standards.json стандарты с текущими версиями и ссылками на все версии
llms-full.txt весь сайт одним файлом

Текст принятой версии не меняется: standards/<имя>/<версия>.md, например standards/dotenv/v1.0.md. Версия в шапке стандарта ведёт туда же.

Как сделать конкретное дело: по шагам.

Гайд Версия О чём
Google OAuth v0.1 клиент OAuth, Testing и публикация, привязка к аккаунту с той же почтой
Brevo v0.1 почта по SMTP: домен (DKIM, DMARC), отправитель, SMTP-ключ
Cloudflare Turnstile v0.1 виджет, проверка токена на сервере, тестовые ключи
Документ О чём
Мой стек на чём я пишу сейчас; многие стандарты выросли из него — Nuxt, PostgreSQL, Playwright
Eleventy и Astro почему этот сайт на Astro: кто стоит за каждым, как часто меняются, перспективы

JCB-NOTESdevИсходники на GitHubCC BY 4.0llms.txt