initref — команда для Claude Code: справочник по проекту в /ref
Собирает справочные документы о внутреннем устройстве проекта в каталог /ref и прописывает ссылки на них в CLAUDE.md.
npx claude-code-templates@latest --command utilities/initrefЧто делает initref
Команда проходит по файлам проекта и собирает по ним сводки через summarize tool, а не читает всё подряд. Так задумано специально: если тянуть содержимое каждого файла в контекст, легко упереться в лимиты. Важные файлы всё же читаются целиком — на них и держится справочник.
На выходе — markdown-файлы в каталоге /ref. После сборки команда дописывает в CLAUDE.md указатели на получившиеся документы, чтобы агент в следующих сессиях знал, куда смотреть за деталями реализации.
Ставить стоит на проектах, где вы уже устали объяснять агенту, как всё устроено. На маленькой кодовой базе выигрыш небольшой, потому что сводки и так помещаются в контекст.
Какие задачи решает
- собрать справочник по устройству проекта без ручного чтения каждого файла
- дать агенту карту важных файлов на будущие сессии
- зафиксировать детали реализации в markdown рядом с кодом
- не выйти за лимиты контекста при разборе крупного репозитория
Примеры запросов агенту
- /initref
- Собери справочник по проекту в /ref и обнови CLAUDE.md
- Прогони initref и покажи, какие файлы попали в справочник
Как установить initref
1Через claude-code-templates
npx claude-code-templates@latest --command utilities/initref2Вручную: положить файлы
.claude/commands/initref.mdВызов — /initref. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/initref.mdВызов — /prompts:initref. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/initref.prompt.mdВручную: положить файлы
.gemini/commands/initref.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Из того же набора205
Весь набор →Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →Вопросы о initref
Как установить initref в Claude?
Через шаблоны: npx claude-code-templates@latest --command utilities/initref. Команда окажется в .claude/commands/initref.md.
Что делает initref?
Собирает сводки по файлам проекта, пишет по ним markdown-документы в /ref и добавляет ссылки на них в CLAUDE.md.
Почему команда не читает все файлы подряд?
Из-за лимитов на использование. Основной объём берётся из сводок summarize tool, а целиком читаются только важные файлы.
Исходный текст
initref.md · MIT
--- description: "Build reference docs in /ref summarizing the implementation details of this project" --- Build a reference for the implementation details of this project. Use provided summarize tool to get summary of the files. Avoid reading the content of many files yourself, as we might hit usage limits. Do read the content of important files though. Use the returned summaries to create reference files in /ref directory. Use markdown format for writing the documentation files. Update CLAUDE.md file with the pointers to important documentation files.
© davila7 · MIT · davila7/claude-code-templates
