JCB-NOTES
Общие правила и знания для своих проектов, не привязанные к одному проекту.
| Раздел | Что | Как меняется | Как на него ссылаются |
|---|---|---|---|
| Стандарты | правила: «так делаем», проверяемо — соответствует / не соответствует | редко, с версией и записью в «Истории» | по имени и версии: «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»Чтобы 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