Когда вы подключаете AI-ассистента к проекту, он не знает ни ваших правил, ни архитектуры, ни того, почему нельзя вызывать
os.Exit в середине сервиса. Каждый раз объяснять это заново — потеря времени.Что должен содержать CLAUDE.md для Go-сервиса
Файл делится на несколько блоков. Первый — команды сборки и тестирования:
# Build & Test
build: go build ./...
test: go test -race ./... -count=1
lint: golangci-lint run ./...
vet: go vet ./...
Второй — критические ограничения. Здесь важно не просто запретить что-то, но объяснить почему. Ассистент лучше следует правилу, когда понимает его смысл:
# Critical Constraint
Never use log.Fatal or os.Exit outside of main().
Return errors. We instrument error rates via middleware
and os.Exit bypasses it entirely.
Третий блок — правила работы с Git. Мелкие, но важные детали: как формировать коммиты, что не делать автоматически:
# Git
Commit per logical change (not per file, not per session).
Format: <type>(<scope>): <summary>
Types: feat | fix | refactor | test | chore
Do not push. Do not open PRs. Stage only.
Четвёртый — критерии готовности задачи. Без этого ассистент может считать работу завершённой раньше времени:
# Definition of Done
1. go test -race ./... passes
2. golangci-lint run ./... passes
3. No new TODOs without a linked GitHub issue
4. godoc updated for any changed public API
И последний блок — ссылки на документацию проекта. Используйте
@-синтаксис, чтобы ассистент мог подтянуть файлы напрямую:# References
Architecture: @docs/architecture.md
DB schema: @docs/db-schema.sql
Deploy playbook: use /deploy skill
Почему это работает лучше, чем системный промпт
CLAUDE.md живёт в репозитории рядом с кодом. Его видят все в команде, его можно версионировать и обновлять вместе с проектом. Системный промпт — это что-то невидимое и нигде не зафиксированное. CLAUDE.md — это документ, как README или Makefile.Такой файл полезен не только для Claude. Большинство AI-ассистентов с поддержкой контекстных файлов умеют его читать. Один файл — меньше объяснений при каждом новом сеансе.
📍 Навигация: Вакансии • Задачи • Собесы
🐸 Библиотека Go-разработчика
#GoDeep