# jcb-devports: приложение 1

На моих примерах: как я выполняю этот стандарт в своих проектах и на своих технологиях. Не требование — соответствие проверяется только по стандарту.

## Где держать реестр блоков

Отдельный файл в общей папке проектов (например, `PORTS.md`), а агенту — одна строка в его личных инструкциях
о том, где этот файл. Личные инструкции Claude Code — `CLAUDE.md` в папке настроек: `$CLAUDE_CONFIG_DIR/CLAUDE.md`,
а если переменная не задана — `~/.claude/CLAUDE.md`. Полный путь в общих документах не писать: он у каждого свой.

Реестр удобно делить на области: например, семейство связанных сервисов берёт блоки из своего диапазона, остальные
проекты — из другого.

## Почему `127.0.0.1`, а не `localhost`

`localhost` может разрешиться сначала в IPv6 (`::1`), а сервер слушает только IPv4 — подключение ждёт или падает.
Особенно заметно в скриптах проверок и в адресе базы.

## Почему проверять, свободен ли порт

Сервер разработки Nuxt, найдя порт занятым, забирает его и гасит чужой процесс — а вместе с ним гаснет и база,
которую тот процесс поднял. Проверить заранее (PowerShell):

```powershell
Get-NetTCPConnection -LocalPort 4000 -State Listen -ErrorAction SilentlyContinue
```

sh: `lsof -iTCP:4000 -sTCP:LISTEN`.
