jcb-devports: приложение 1
На моих примерах: как я выполняю этот стандарт в своих проектах и на своих технологиях. Не требование — соответствие проверяется только по стандарту.
Где держать реестр блоков
Заголовок раздела «Где держать реестр блоков»Отдельный файл в общей папке проектов (например, PORTS.md), а агенту — одна строка в его личных инструкциях
о том, где этот файл. Личные инструкции Claude Code — CLAUDE.md в папке настроек: $CLAUDE_CONFIG_DIR/CLAUDE.md,
а если переменная не задана — ~/.claude/CLAUDE.md. Полный путь в общих документах не писать: он у каждого свой.
Реестр удобно делить на области: например, семейство связанных сервисов берёт блоки из своего диапазона, остальные проекты — из другого.
Почему 127.0.0.1, а не localhost
Заголовок раздела «Почему 127.0.0.1, а не localhost»localhost может разрешиться сначала в IPv6 (::1), а сервер слушает только IPv4 — подключение ждёт или падает.
Особенно заметно в скриптах проверок и в адресе базы.
Почему проверять, свободен ли порт
Заголовок раздела «Почему проверять, свободен ли порт»Сервер разработки Nuxt, найдя порт занятым, забирает его и гасит чужой процесс — а вместе с ним гаснет и база, которую тот процесс поднял. Проверить заранее (PowerShell):
Get-NetTCPConnection -LocalPort 4000 -State Listen -ErrorAction SilentlyContinuesh: lsof -iTCP:4000 -sTCP:LISTEN.