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

research-codebase — субагент для Claude Code

Субагент research-codebase для автоматического описания кодовой базы. Запускает несколько специализированных агентов параллельно, чтобы найти файлы, разобрать логику и собрать примеры использования в единый документ.

MIT ★ 3 951 обновлён 2026-01-26

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

Что делает research-codebase

research-codebase создаёт техническую документацию существующего кода без оценок и рекомендаций. Он разбивает задачу на четыре направления: codebase-locator ищет, где живут файлы и компоненты; codebase-analyzer разбирает, как работает конкретный код; codebase-pattern-finder находит примеры паттернов в проекте; research-agent подтягивает внешнюю документацию, если её попросить.

Субагент выполняет эти задачи параллельно и синтезирует результаты в единый отчёт с ссылками на строки кода и GitHub-перссылки. Документ сохраняется в thoughts/shared/research/YYYY-MM-DD-topic.md. Ключевое ограничение: агент только описывает, что есть; улучшения, критика и рекомендации — за скобками, если их специально не просят.

Какие задачи решает

  • собрать техническую документацию по существующему коду без ручного разбора файлов
  • понять архитектуру сервиса, не читая весь репозиторий подряд
  • найти примеры существующих паттернов для новых компонентов
  • отследить поток данных через несколько модулей с конкретными ссылками на код

Примеры запросов агенту

  • Как устроен сервис памяти в нашем проекте?
  • Найди все файлы, связанные с аутентификацией, и объясни, как они взаимодействуют
  • Покажи примеры использования класса DatabaseConnection в кодовой базе

Как установить research-codebase

Вручную: положить файлы

.claude/agents/research-codebase.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о research-codebase

Как установить research-codebase в Claude Code?

Добавь файл .claude/agents/research-codebase.md в корень проекта. Claude Code автоматически обнаружит субагент и сделает его доступным.

Что делает research-codebase?

Создаёт полное описание кодовой базы, запуская несколько агентов параллельно. Каждый отвечает за свой аспект: поиск файлов, анализ логики, поиск примеров. Результаты собираются в единый документ с ссылками на конкретные строки кода.

Даёт ли субагент рекомендации по улучшению кода?

Нет. research-codebase только описывает существующий код как есть. Оценок, предложений по рефакторингу и рекомендаций в документе не будет, если их специально не попросить.

Исходный текст

research-codebase.md · MIT
---
name: research-codebase
description: Document the codebase comprehensively
model: sonnet
---

# Research Codebase Agent

Document the codebase as-is without evaluation or recommendations.

## Purpose

Create comprehensive technical documentation of existing code by spawning specialized sub-agents in parallel and synthesizing their findings.

## Sub-Agents to Use

| Agent | Purpose |
|-------|---------|
| codebase-locator | Find WHERE files and components live |
| codebase-analyzer | Understand HOW specific code works |
| codebase-pattern-finder | Find examples of existing patterns |
| research-agent | External docs (only if explicitly asked) |

## Core Principles

1. **Document, Don't Evaluate**
   - Describe what exists
   - Don't suggest improvements
   - Don't critique implementation
   - No recommendations unless asked

2. **Parallel Execution**
   - Spawn multiple agents concurrently
   - Each agent handles one aspect
   - Synthesize results at the end

3. **Concrete References**
   - Always include `file:line` references
   - GitHub permalinks when possible
   - Self-contained documentation

## Workflow

```
1. Read mentioned files FIRST (before spawning)
2. Decompose question into research areas
3. Spawn parallel agents (Task tool)
4. Wait for ALL to complete
5. Synthesize findings
6. Write to thoughts/shared/research/
7. Present concise summary
```

## Output Location

`thoughts/shared/research/YYYY-MM-DD-topic.md`

## Example Usage

```
User: "How does the memory service work?"

Agent spawns:
- codebase-locator: "Find all files related to memory service"
- codebase-analyzer: "Trace data flow in memory_service.py"
- codebase-pattern-finder: "Find usage examples of MemoryService"

Synthesizes and writes research document.
```

## What NOT To Do

- Don't suggest improvements
- Don't identify "problems"
- Don't recommend refactoring
- Don't propose future enhancements
- Don't evaluate code quality

© parcadei · MIT · parcadei/Continuous-Claude-v3

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
10x-research przeprogramowani Команда 10x-research запускает параллельных субагентов для комплексного анализа проекта. Находит архитектурные паттерны, связи между компонентами и сохраняет результаты в markdown-отчёт. CX Codex +1 ★ 267звёзд репо codebase-onboarding Alireza Rezvani Скилл codebase-onboarding для Claude Code анализирует репозиторий и собирает материалы для знакомства с проектом. Запускается при адаптации нового инженера и подготовке архитектурного обзора. CX Codex +1 698установок analyze-codebase Anand Tyagi Плагин analyze-codebase разбирает всю кодовую базу проекта и готовит по ней техническую документацию. Помогает составить план доработок и сориентироваться в незнакомой структуре файлов. ★ 1 013звёзд репо codebase-analyzer donnfelker Скилл codebase-analyzer для Claude Code анализирует архитектуру, качество кода, тесты и инфраструктуру репозитория. Формирует технический отчёт по всему проекту. CX Codex +1 868установок codebase-analysis solatis Скилл codebase-analysis для быстрого знакомства с незнакомым репозиторием: запускает Python-скрипт, который сам обходит проект и собирает картину структуры, потоков и решений. CX Codex +1 587установок codebase-comprehension-algorithms pproenca Скилл codebase-comprehension-algorithms раскладывает незнакомый репозиторий на функциональные домены: какие файлы стоят за фичей и где проходит архитектурный каркас. CX Codex +1 148установок

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

Весь набор →
natural-transformations Скилл natural-transformations помогает разбирать естественные преобразования и связанные конструкции в теории категорий. В нём есть ориентиры для доказательств в Lean 4. CX Codex +1 ★ 3 951звёзд репо categories-functors Скилл categories-functors помогает решать задачи по функторам и категориям в теории категорий. Проверяет аксиомы, свойства функторов и верифицирует доказательства на Lean 4 через компилятор. CX Codex +1 ★ 3 951звёзд репо limits-colimits Скилл limits-colimits для Claude Code предлагает пошаговые стратегии решения задач на пределы и копределы в теории категорий, включая формализацию в Lean 4 и расчёты через SymPy. CX Codex +1 ★ 3 951звёзд репо llm-tuning-patterns Скилл llm-tuning-patterns для Claude Code подсказывает параметры LLM — температуру и лимит токенов — под формальные доказательства, генерацию кода и творческие задачи. CX Codex +1 ★ 3 951звёзд репо search-tools Скилл search-tools для Claude Code направляет поиск по коду в LEANN, AST-grep, Morph или Grep в зависимости от задачи. CX Codex +1 ★ 3 951звёзд репо modular-arithmetic Скилл modular-arithmetic для Claude Code решает задачи модульной арифметики и теории графов, включая расширенный алгоритм Евклида, китайскую теорему об остатках и квадратичные вычеты. CX Codex +1 ★ 3 951звёзд репо agentica-spawn Скилл agentica-spawn запускает многоагентные паттерны Agentica: рой для исследований, иерархию для реализации, генератор-критика для итераций, присяжных для валидации. CX Codex +1 ★ 3 951звёзд репо parallel-agent-contracts Скилл parallel-agent-contracts задаёт строгие правила для параллельных агентов в TypeScript: проверку типов через tsc и поиск дубликатов интерфейсов через grep перед созданием новых типов. CX Codex +1 ★ 3 951звёзд репо

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

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