К основному содержанию
субагент CX Codex

repo-index — субагент для Claude Code: индексирование репозитория

Субагент repo-index, который сканирует структуру проекта, выделяет критичные файлы и генерирует PROJECT_INDEX.md для экономии контекста в последующей работе. Запускай в начале сессии или после существенных изменений кода.

MIT ★ 23 950 обновлён 2026-09-27

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/repo-index.md
Открыть на GitHub

Что делает 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 или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты 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

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
auto-repo-setup daymade Скилл auto-repo-setup проверяет окружение репозитория, чинит настройку и защищает Git-операции. Пригодится перед работой, онбордингом или изменением хуков. CX Codex +1 534установок repo-standardizer официальный github Скилл repo-standardizer для GitHub Copilot приводит в порядок настройки GitHub-репозитория: шаблоны, метки, CI и документацию. Запускается по просьбе подготовить новый репозиторий или привести в порядок существующий. CX Codex +1 33установок repo-skillopt objectivlabs Скилл repo-skillopt для Claude Code разбирает устройство репозитория и собирает спецификацию с опорой на файлы, конфиги и тесты. Активируется при просьбах объяснить кодовую базу, описать архитектуру, внести изменения или оценить риски. CX Codex +1 598установок audit-repo-docs FlorianBruniaux Команда audit-repo-docs проверяет документацию репозитория по 30 критериям и выдаёт отчёт с оценкой и списком улучшений. Пригодится, чтобы найти пробелы в README, структуре docs и автоматизации. CX Codex +1 ★ 6 529звёзд репо explorer mralexivy Субагент explorer для Claude Code собирает технические факты о проекте для планировщика. Он находит зависимости, команды сборки и тесты до начала планирования задач. CX Codex ★ 80звёзд репо ctx-index mksglu Скилл ctx-index индексирует файлы проекта в локальную базу FTS5 для context-mode. Это избавляет ассистента от повторного чтения сырых файлов при поиске фрагментов. CX Codex +1 1 200установок

Из того же набора56

Весь набор →
deep-research Субагент deep-research для Claude Code находит внешнюю информацию за пределами репозитория и собирает выжимку с таблицей источников. CX Codex ★ 23 950звёзд репо self-review Субагент self-review проверяет результат после этапа реализации: тесты, крайние случаи, требования и оставшиеся риски. Подходит для финальной проверки перед ответом пользователю. CX Codex ★ 23 950звёзд репо backend-architect Субагент backend-architect для Claude Code проектирует серверную архитектуру и API. Он подключается к задачам по схемам баз данных, безопасности и надёжности систем. CX Codex ★ 23 950звёзд репо frontend-architect Субагент frontend-architect для создания доступных, быстрых интерфейсов. Помогает реализовать WCAG 2.1 AA, оптимизировать Core Web Vitals и строить отзывчивые дизайны на современных фреймворках. CX Codex ★ 23 950звёзд репо git Команда для управления Git-репозиторием прямо из Claude Code. Генерирует сообщения коммитов по Conventional Commits, помогает с конфликтами слияния и предлагает оптимальный workflow. CX Codex +1 ★ 23 950звёзд репо devops-architect Субагент devops-architect автоматизирует инфраструктуру и пайплайны CI/CD. Помогает подготовить конфигурации для деплоя без простоя и настроить мониторинг. CX Codex ★ 23 950звёзд репо system-architect Субагент system-architect для Claude Code анализирует архитектуру системы, границы компонентов и решения для роста. Сравнивает паттерны и планирует миграции. CX Codex ★ 23 950звёзд репо sc Команда /sc запускает все функции фреймворка SuperClaude: поиск, анализ репозитория, специализированных агентов и рекомендации прямо из Claude Code. CX Codex +1 ★ 23 950звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой