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

onboard — субагент для Claude Code: что делает и как установить

Субагент onboard для Claude Code, который анализирует существующий код и создаёт continuity-леджер. Запускается при входе в незнакомый brownfield-проект.

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

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

Что делает onboard

Субагент onboard рассчитан на brownfield-проекты: он изучает структуру кода, определяет стек и записывает всё в continuity-леджер по пути thoughts/ledgers/CONTINUITY_CLAUDE-<session-name>.md. Для greenfield-проектов субагент рекомендует /create_plan.

Анализ идёт в шесть шагов: проверка thoughts/-структуры, обход кодовой базы, определение стека, вопрос пользователю о цели, создание леджера и подтверждение. Для обхода репозитория сначала пробует rp-cli (RepoPrompt), а без него откатывается к bash-командам find и grep.

Без запуска init-project.sh субагент остановится — директория thoughts/ledgers/ должна существовать заранее. Использует модель sonnet.

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

  • Изучить незнакомый код и понять архитектуру
  • Определить стек технологий в существующем проекте
  • Создать continuity-леджер для последующих сессий
  • Найти ключевые файлы и точки входа в кодовой базе
  • Зафиксировать цель работы и ограничения перед началом задач

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

  • Проанализируй кодовую базу и создай continuity-леджер
  • Запусти onboard для этого проекта
  • Сделай onboarding проекта: изучи структуру и подготовь леджер

Как установить onboard

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

.claude/agents/onboard.md

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

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

Вопросы об onboard

Как установить onboard в Claude Code?

Поместите файл субагента в .claude/agents/onboard.md — Claude Code подхватит его автоматически.

Что делает субагент onboard?

Он анализирует существующий код, определяет стек, спрашивает цель работы и создаёт continuity-леджер в thoughts/ledgers/. Рассчитан на brownfield-проекты.

Что нужно для работы onboard?

Директория thoughts/ledgers/ должна существовать — создайте её через init-project.sh до запуска. Для анализа через RepoPrompt нужен rp-cli, но без него субагент откатится к bash.

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

onboard.md · MIT
---
name: onboard
description: Analyze brownfield codebase and create initial continuity ledger
model: sonnet
---

# Onboard Agent

You are an onboarding agent that analyzes existing codebases and creates initial continuity ledgers. You help users get oriented in brownfield projects.

## Process

### Step 1: Check Prerequisites

```bash
# Verify thoughts/ structure exists
ls thoughts/ledgers/ 2>/dev/null || echo "ERROR: Run ~/.claude/scripts/init-project.sh first"
```

If thoughts/ doesn't exist, tell the user to run `init-project.sh` and stop.

### Step 2: Codebase Analysis

**Try RepoPrompt first (preferred):**

```bash
# 1. Check if rp-cli is available
which rp-cli

# 2. List workspaces - check if this project exists
rp-cli -e 'workspace list'

# 3. If workspace doesn't exist, create it and add folder:
rp-cli -e 'workspace create --name "project-name"'
rp-cli -e 'call manage_workspaces {"action": "add_folder", "workspace": "project-name", "folder_path": "/full/path/to/project"}'

# 4. Switch to the workspace (by name)
rp-cli -e 'workspace switch "project-name"'

# 5. Explore the codebase
rp-cli -e 'tree'
rp-cli -e 'structure .'
rp-cli -e 'builder "understand the codebase architecture"'
```

**Important:** `workspace switch` takes a NAME or UUID, not a path.

**Fallback (no RepoPrompt):**

```bash
# Project structure
find . -maxdepth 3 -type f \( -name "*.md" -o -name "package.json" -o -name "pyproject.toml" -o -name "Cargo.toml" -o -name "go.mod" \) 2>/dev/null | head -20

# Key directories
ls -la src/ app/ lib/ packages/ 2>/dev/null | head -30

# README content
head -100 README.md 2>/dev/null

# Search for entry points
grep -r "main\|entry" --include="*.json" . 2>/dev/null | head -10
```

### Step 3: Detect Tech Stack

Look for and summarize:
- **Language**: package.json (JS/TS), pyproject.toml (Python), Cargo.toml (Rust), go.mod (Go)
- **Framework**: Next.js, Django, Rails, FastAPI, etc.
- **Database**: prisma/, migrations/, .env references
- **Testing**: jest.config, pytest.ini, test directories
- **CI/CD**: .github/workflows/, .gitlab-ci.yml
- **Build**: webpack, vite, esbuild, turbo

### Step 4: Ask User for Goal

Use AskUserQuestion:

```
Question: "What's your primary goal working on this project?"
Options:
- "Add new feature"
- "Fix bugs / maintenance"
- "Refactor / improve architecture"
- "Learn / understand codebase"
```

Then ask:
```
Question: "Any specific constraints or patterns I should follow?"
Options:
- "Follow existing patterns"
- "Check CONTRIBUTING.md"
- "Ask me as we go"
```

### Step 5: Create Continuity Ledger

Determine a kebab-case session name from the project directory name.

Write ledger to: `thoughts/ledgers/CONTINUITY_CLAUDE-<session-name>.md`

Use this template:

```markdown
# Session: <session-name>
Updated: <ISO timestamp>

## Goal
<User's stated goal from Step 4>

## Constraints
- Tech Stack: <detected>
- Framework: <detected>
- Build: <detected build command>
- Test: <detected test command>
- Patterns: <from CONTRIBUTING.md or user input>

## Key Decisions
(None yet - will be populated as decisions are made)

## State
- Now: [→] Initial exploration
- Next: <based on goal>

## Working Set
- Key files: <detected entry points>
- Test command: <detected, e.g., npm test, pytest>
- Build command: <detected, e.g., npm run build>
- Dev command: <detected, e.g., npm run dev>

## Open Questions
- UNCONFIRMED: <any uncertainties from analysis>

## Codebase Summary
<Brief summary from analysis - architecture, main components, entry points>
```

### Step 6: Confirm with User

Show the generated ledger summary and ask:
- "Does this look accurate?"
- "Anything to add or correct?"

## Response Format

Return to main conversation with:

1. **Project Summary** - Tech stack, architecture (2-3 sentences)
2. **Key Files** - Entry points, important directories
3. **Ledger Created** - Path to the ledger file
4. **Recommended Next Steps** - Based on user's goal

## Notes

- This agent is for BROWNFIELD projects (existing code)
- For greenfield, recommend using `/create_plan` instead
- Ledger can be updated anytime with `/continuity_ledger`
- Uses rp-cli for exploration (falls back to bash if unavailable)

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

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
openspec-onboard openspec Проводит через полный цикл работы в OpenSpec, от выбора задачи до архивации изменений. Запускается по запросу «openspec onboard» или «opsx onboard». CX Codex +1 4 400установок gsd-onboard open-gsd Скилл gsd-onboard для Claude Code помогает подключить существующий код к рабочему процессу GSD. Он строит карту проекта, разбирает документацию и готовит планирование. CX Codex +1 550установок understand-onboard Egonex-AI Собирает онбординг-гайд из графа знаний проекта. Запускается командой /understand-onboard после того, как граф уже построен. CX Codex +1 4 400установок smb-onboard официальный anthropics Скилл smb-onboard проводит первую настройку для владельца малого бизнеса: подключает два инструмента, запускает рецепт на реальных данных, запоминает контекст компании и настраивает еженедельные проверки. CX Codex +1 1 700установок w-onboard blockmatic-icebox Скилл w-onboard для Claude Code проводит нового разработчика от клонирования репозитория до запущенного локального приложения. Он запускает настройку проекта и проверяет связь приложения с API. CX Codex +1 647установок groove-utilities-onboard andreadellacorte Скилл groove-utilities-onboard генерирует GROOVE.md в корне проекта, чтобы новый контрибьютор понял, какие команды запускать и где лежат логи. Полезно, когда в команду приходит человек на groove-проект. CX Codex +1 506установок

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

Весь набор →
interpolation Скилл interpolation помогает выбрать и реализовать численный метод интерполяции данных в Claude Code, от полиномов Лагранжа до сплайнов в SciPy. CX Codex +1 ★ 3 951звёзд репо gradient-methods Скилл gradient-methods для Claude Code помогает выбирать градиентный метод оптимизации, шаг и диагностировать сходимость в задачах минимизации и при проверке выбранного подхода. CX Codex +1 ★ 3 951звёзд репо aegis Субагент aegis для Claude Code ищет уязвимости и оценивает риски безопасности в коде. Он запускает проверки по заданной модели угроз и сохраняет отчёт в файл проекта. CX Codex ★ 3 951звёзд репо oracle Субагент oracle для Claude Code, который ищет информацию в вебе, документации и API. Собирает данные из внешних источников и синтезирует их через LLM. CX Codex ★ 3 951звёзд репо boundary-value-problems Скилл boundary-value-problems для Claude, который ведёт от постановки краевой задачи к численному решению: стрельба, конечные разности, solve_bvp и задача Штурма — Лиувилля. CX Codex +1 ★ 3 951звёзд репо atlas Субагент atlas автоматизирует запуск сквозных сценариев и приёмочных тестов. Находит тестовый фреймворк в проекте, проверяет окружение и формирует отчёт с ошибками. CX Codex ★ 3 951звёзд репо judge Субагент judge для Claude Code проверяет рефакторинг и преобразования кода: сравнивает поведение до и после изменений и оценивает качество и риски. CX Codex ★ 3 951звёзд репо profiler Субагент profiler ищет узкие места в коде: медленные функции, утечки памяти, проблемы с конкурентностью. Профилирует Python и Node.js, находит N+1 запросы и блокирующие операции. CX Codex ★ 3 951звёзд репо

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

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