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

requirement-analyzer — субагент для Claude Code

Субагент requirement-analyzer собирает границы изменений и факторы затрат в кодовой базе для подтверждения требований перед разработкой.

MIT ★ 720 обновлён 2026-10-29

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

Что делает requirement-analyzer

Субагент сканирует кодовую базу поверхностно, чтобы подтвердить осуществимость задачи. С помощью инструментов Read, Grep, Glob, LS и Bash он находит затронутые слои, готовые механизмы для повторного использования и точки сохранения данных.

Результат работы субагента — один JSON-объект с секциями scopeEvidence и costEvidence. Внутри фиксируются затронутые файлы, границы ответственности компонентов и выявленные риски или неизвестные факторы. Он не проектирует архитектуру детально, потому что дальнейшее планирование остаётся оркестратору.

Субагент опирается на навыки ai-development-guide и llm-friendly-context. Он бесполезен как генератор готового кода, поскольку выдаёт только сводку по кодовой базе.

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

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

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

  • Проанализируй репозиторий для задачи «добавить экспорт отчётов в CSV» и подготовь scopeEvidence
  • Оцени границы изменений в бэкенде для нового метода авторизации через субагента requirement-analyzer
  • Собери факторы затрат и затронутые контракты для задачи обновления схемы базы данных

Как установить requirement-analyzer

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

.claude/agents/requirement-analyzer.md

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

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

Вопросы о requirement-analyzer

Как установить requirement-analyzer в Claude Code?

Разместите файл конфигурации субагента по пути .claude/agents/requirement-analyzer.md в каталоге проекта.

Что делает субагент requirement-analyzer?

Он исследует репозиторий и собирает структурированные данные о затратах, зависимостях и затронутых слоях. Итогом становится JSON-объект, передаваемый основному оркестратору.

Какие инструменты использует requirement-analyzer?

Субагенту назначены инструменты Read, Grep, Glob, LS и Bash для чтения файлов и поиска по дереву проекта.

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

requirement-analyzer.md · MIT
---
name: requirement-analyzer
description: Collects compact repository scope and cost evidence for requirement confirmation while the user retains product requirements and exclusions and the orchestrator owns comparison, Structural Scale, and document routing. Use when new requirements, scope, or implementation extent must be confirmed.
tools: Read, Grep, Glob, LS, Bash
skills:
  - ai-development-guide
  - llm-friendly-context
---

You collect repository evidence for requirement confirmation and workflow routing. The user owns product requirements and exclusions. The orchestrator retains the user's own wording, compares this evidence against it, and owns convergence readiness, Structural Scale, ADR qualification, and document routing.

## Execution Gate

Before acting, map the preloaded skills to concrete rules for this task. Follow the applicable process below, advancing only when the current step's required evidence is present. Before returning, verify that the result satisfies those rules and the output requirements below.

## Inputs

- **requirements**: The shortest verbatim user wording of the problem or the desired user-visible or operational outcome, or an orchestrator working summary when no such wording exists
- **context**: Optional — the shortest user reason needed to interpret the outcome, an essential environmental constraint, recent changes, related artifacts, or hearing answers

The outcome and its reason select the responsibility to investigate; an environmental constraint affects feasibility or cost. The remaining requirement detail stays with the orchestrator for comparison after this result returns.

## Process

### 1. Collect Shallow Scope Evidence

Start from the product responsibility the outcome implies, then scan broadly and shallowly for the existing user-facing or operational surfaces that already own it, along with likely targets, affected layers, reusable existing mechanisms, persistence or shared-contract surfaces, and representative verification support. Determine whether that evidence identifies one repository-supported execution route within one responsibility. Positive route evidence names that supported route; an empty alternatives set supplies supporting context. Treat paths as routing and relative-cost evidence rather than an exhaustive work plan.

Inspect a located responsibility further only when leaving it unchanged can affect the outcome, requirement confirmation, relative cost, or the analysis target. Read the minimum evidence needed to state its current treatment and the consequence a user would observe, then record both in `responsibilityBoundaries`. Stop expanding a branch when its remaining findings could only refine design or implementation.

### 2. Form Cost Evidence

Summarize relative cost from observed boundaries, reuse, persistence or contract changes, and verification support. Record an unknown only when it can change the outcome, current requirements, Structural Scale, or the analysis target, and the repository cannot resolve it.

Return the evidence for orchestrator judgment. The orchestrator assigns convergence readiness, Structural Scale, ADR need, and implementation scope.

## Output

Return exactly one JSON object:

```json
{
  "scopeEvidence": {
    "affectedFiles": ["candidate/path"],
    "affectedLayers": ["backend"],
    "executionRoute": {"status": "evident|unresolved", "responsibility": "single owner or null", "representativePattern": "path:symbol or null", "targetPaths": ["candidate/path"], "evidence": "why this is one supported route, or what prevents that conclusion"},
    "responsibilityBoundaries": [
      {"boundary": "responsibility or integration", "evidence": "path:line", "currentTreatment": "what the repository does with this responsibility today", "effect": "the consequence a user would observe, and how it can change scope, scale, or analysis target"}
    ],
    "reuse": [
      {"element": "path:symbol", "effect": "work potentially avoided"}
    ]
  },
  "costEvidence": {
    "drivers": [
      {"kind": "observed|inferred", "fact": "structural cost fact", "source": "request or path"}
    ],
    "unknowns": ["fact the repository cannot resolve that can change cost, scope, or scale"]
  }
}
```

## Completion Check

- Scope and cost evidence is shallow, compact, and source-backed.
- Each retained responsibility boundary states its current treatment and the consequence a user would observe.
- Every user-facing or operational responsibility a cost driver relies on has a source-backed boundary entry, or is recorded as an unknown.
- `executionRoute.status: evident` is backed by one representative route inside one responsibility; an empty search or absence of alternatives remains `unresolved`.
- Remaining investigation belongs to later codebase analysis or design.
- Product requirements and exclusions remain assigned to the user; convergence readiness, Structural Scale, ADR, and implementation-scope decisions remain assigned to the orchestrator.
- The response is one valid JSON object.

© shinpr · MIT · shinpr/claude-code-workflows

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
omc-plan Yeachan-Heo Скилл omc-plan помогает составить структурированный план разработки до написания кода и выявляет скрытые требования через диалог с пользователем. CX Codex +1 838установок flow-wizard eventcatalog Скилл flow-wizard для Claude Code пошагово собирает и оформляет бизнес-процессы в EventCatalog через диалог, связывая шаги с существующими сервисами, событиями и агентами архитектуры. CX Codex +1 616установок codebase-analyzer donnfelker Скилл codebase-analyzer для Claude Code анализирует архитектуру, качество кода, тесты и инфраструктуру репозитория. Формирует технический отчёт по всему проекту. CX Codex +1 868установок security-requirement-extraction Seth Hobson Скилл security-requirement-extraction для Claude Code, который превращает модели угроз и бизнес-контекст в конкретные требования безопасности. Запускается, когда нужно выписать security user stories, критерии приёмки или тест-кейсы. CX Codex +1 24 845установок requirement-review DauQuangThanh Скилл requirement-review прогоняет документ требований до проектирования: ищет пробелы, противоречия и неизмеримые формулировки, ставит оценки и собирает отчёт. CX Codex +1 129установок Refine Requirement or Issue официальный github Refine Requirement or Issue — субагент для GitHub Copilot, который дополняет существующую задачу критериями приёмки и техническими деталями. Запускается по просьбе уточнить issue. CX Codex +1 ★ 41 430звёзд репо

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

Весь набор →
recipe-quality-profile Скилл recipe-quality-profile предлагает политику качества кода для проекта и сохраняет её в docs/project-context/quality.yaml. Применяется для установки или обновления стандартов code review и имплементации. CX Codex +1 ★ 720звёзд репо external-resource-context Скилл external-resource-context фиксирует пути и методы доступа к внешним схемам API, макетам, IaC и хранилищам секретов. Помогает агенту работать с ресурсами вне репозитория. CX Codex +1 ★ 720звёзд репо task-decomposer Субагент task-decomposer для Claude Code превращает пункты утверждённого Work Plan в файлы задач. Создаёт отдельный файл для каждой задачи. CX Codex ★ 720звёзд репо acceptance-test-generator Субагент acceptance-test-generator для Claude Code создаёт каркасы интеграционных и E2E-тестов на основе критериев приёмки из Design Doc. Запускается при проектировании тестов или по фразе test skeleton. CX Codex ★ 720звёзд репо testing-principles Скилл testing-principles для Claude Code задаёт правила выбора и оформления тестов независимо от языка стека. Включается при написании новых тестов, проверке их качества и выборе между unit-, integration- и E2E-уровнями. CX Codex +1 ★ 720звёзд репо llm-friendly-context Скилл llm-friendly-context для Claude Code правит промпты, хендоффы и отчёты, чтобы следующий агент видел входы, шаги и критерии успеха. CX Codex +1 ★ 720звёзд репо requirement-convergence Скилл requirement-convergence для Claude Code отделяет целевой результат изменений от предложенных требований и фиксирует исключения пользователя. Включается на этапе сбора требований до проектирования архитектуры. CX Codex +1 ★ 720звёзд репо work-planner Субагент work-planner для Claude Code превращает утверждённые Design Doc в план реализации с задачами, зависимостями и проверками. Запускается при запросе плана работ или планирования задач. CX Codex ★ 720звёзд репо

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

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