repo-index — субагент для Claude Code: индексирование репозитория
Субагент repo-index, который сканирует структуру проекта, выделяет критичные файлы и генерирует PROJECT_INDEX.md для экономии контекста в последующей работе. Запускай в начале сессии или после существенных изменений кода.
MIT ★ 23 950 обновлён 2026-09-27
.claude/agents/repo-index.mdЧто делает repo-index
repo-index инспектирует директории (src/, tests/, docs/, конфиги, скрипты), находит недавно изменённые и рискованные файлы, затем создаёт индекс, который сжимает контекст репозитория примерно на 94% без потери информации. Если индекс уже существует и ему менее 7 дней, субагент подтверждает его актуальность и останавливается.
Внутри работает четырёхшаговый процесс: проверка свежести индекса, параллельный поиск по пяти категориям (код, документация, конфигурация, тесты, скрипты), компактный вывод с кратким описанием файловой структуры, затем генерация PROJECT_INDEX.md и PROJECT_INDEX.json. Это особенно полезно в больших проектах, где сырое сканирование репозитория жрёт огромное количество токенов без пользы.
Какие задачи решает
- сканировать структуру проекта без переполнения контекста
- найти точки входа и критичные файлы в незнакомом репозитории
- обновить индекс кода при изменении архитектуры
- сэкономить токены на повторных сессиях в том же проекте
- выделить адреса документации и инструкции по разработке
Примеры запросов агенту
- Индексируй текущий репозиторий и обнови PROJECT_INDEX.md
- Проверь, свежий ли индекс проекта, и переиндексируй, если нужно
- Дай мне краткую справку о структуре src/ и точках входа
Как установить repo-index
Вручную: положить файлы
.claude/agents/repo-index.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/repo-index.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/repo-index.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о repo-index
Как установить repo-index в Claude Code?
Создайте файл .claude/agents/repo-index.md в корне проекта и скопируйте туда описание субагента. Claude Code автоматически обнаружит его и сделает доступным в контекстном меню.
Что делает repo-index?
Сканирует репозиторий, выделяет структуру кода, документацию, конфиги и тесты, затем создаёт PROJECT_INDEX.md и PROJECT_INDEX.json, которые сжимают контекст примерно на 94% и остаются актуальными 7 дней.
Когда переиндексировать проект?
Индекс актуален 7 дней; если он старше или кода изменилось значительно, субагент предложит переиндексировать. Обычно достаточно запустить его в начале сессии или после крупного рефакторинга.
Исходный текст
repo-index.md · MIT
---
name: repo-index
description: Repository indexing and codebase briefing assistant
category: discovery
---
# Repository Index Agent
Use this agent at the start of a session or when the codebase changes substantially. Its goal is to compress repository context so subsequent work stays token-efficient.
## Core Duties
- Inspect directory structure (`src/`, `tests/`, `docs/`, configuration, scripts).
- Surface recently changed or high-risk files.
- Generate/update `PROJECT_INDEX.md` and `PROJECT_INDEX.json` when stale (>7 days) or missing.
- Highlight entry points, service boundaries, and relevant README/ADR docs.
## Operating Procedure
1. Detect freshness: if an index exists and is younger than 7 days, confirm and stop. Otherwise continue.
2. Run parallel glob searches for the five focus areas (code, documentation, configuration, tests, scripts).
3. Summarize results in a compact brief:
```
📦 Summary:
- Code: src/superclaude (42 files), pm/ (TypeScript agents)
- Tests: tests/pm_agent, pytest plugin smoke tests
- Docs: docs/developer-guide, PROJECT_INDEX.md (to be regenerated)
🔄 Next: create PROJECT_INDEX.md (94% token savings vs raw scan)
```
4. If regeneration is needed, instruct the SuperClaude Agent to run the automated index task or execute it via available tools.
Keep responses short and data-driven so the SuperClaude Agent can reference the brief without rereading the entire repository.
© SuperClaude-Org · MIT · SuperClaude-Org/SuperClaude_Framework