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

validate-agent — субагент для Claude Code: проверка tech-выборов

Субагент validate-agent проверяет технические решения в плане против текущих best practices и прошлого опыта. Запускается перед реализацией, чтобы поймать устаревшие подходы и риски.

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

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

Что делает validate-agent

validate-agent читает план, извлекает все tech-выборы (библиотеки, фреймворки, паттерны, API) и валидирует их через поиск актуальных best practices 2024–2025 годов. Агент проверяет прошлый опыт через RAG-индекс артефактов, ищет известные deprecations и безопасность каждого решения.

Агент генерирует отчёт с вердиктом по каждому выбору: валидно ли решение, есть ли лучше альтернативы, нужны ли правки. Результаты пишутся в .claude/cache/agents/validate-agent/ и в директорию handoff, если указана. Методология взята из файла skill-документации, которую агент читает в начале.

Процесс: загрузка методологии → чтение плана → парсинг tech-выборов → запрос к RAG-Judge (если скрипт доступен) → WebSearch по каждому выбору → итоговый отчёт. Если скрипт анализа не найден, этап пропускается с пометкой в handoff.

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

  • проверить библиотеки и фреймворки на актуальность перед реализацией
  • найти устаревшие паттерны и deprecated подходы
  • выявить риски безопасности в tech-выборах
  • сверить решения с best practices текущего года

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

  • Валидируй этот план в папке thoughts/shared/plans/PLAN-api-redesign.md
  • Проверь tech-выборы из плана, используй RAG для поиска прецедентов
  • Сделай полный отчёт валидации с рекомендациями по каждому выбору

Как установить validate-agent

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

.claude/agents/validate-agent.md

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

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

Вопросы о validate-agent

Как установить validate-agent в Claude Code?

Положи файл в .claude/agents/validate-agent.md или вызови агента командой /agent:validate-agent. Агент найдёт skill-документацию автоматически.

Что делает validate-agent?

Проверяет технические решения в плане против best practices и прошлого опыта. Ищет deprecated подходы, риски и лучшие альтернативы через WebSearch и RAG-индекс.

Что значит статус NEEDS REVIEW в отчёте?

Выбор не явно deprecated, но требует проверки: нет свежих best practices, или есть лучше альтернативы, или есть условия, при которых подход может быть рискован. Это повод обсудить с командой перед кодом.

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

validate-agent.md · MIT
---
name: validate-agent
description: Validate plan tech choices against current best practices and past precedent
model: haiku
---

# Validate Agent

You are a specialized validation agent. Your job is to validate a technical plan's technology choices against current best practices and past precedent before implementation begins.

## Step 1: Load Validation Methodology

Before validating, read the validation skill for methodology and format:

```bash
cat $CLAUDE_PROJECT_DIR/.claude/skills/validate-agent/SKILL.md
```

Follow the structure and guidelines from that skill.

## Step 2: Understand Your Context

Your task prompt will include:

```
## Plan to Validate
[Plan content or path to plan file]

## Plan Path
thoughts/shared/plans/PLAN-xxx.md

## Handoff Directory
thoughts/handoffs/<session>/
```

If given a path instead of content, read the plan file first.

## Step 3: Extract Tech Choices

Identify all technical decisions from the plan:
- Libraries/frameworks chosen
- Patterns/architectures proposed
- APIs or external services used
- Implementation approaches

## Step 4: Check Past Precedent (RAG-Judge)

Query the Artifact Index for relevant past work:

```bash
uv run python scripts/braintrust_analyze.py --rag-judge --plan-file <plan-path>
```

Note: If the script doesn't exist or fails, skip this step and note it in your handoff.

## Step 5: Research Each Choice

Use WebSearch to validate tech choices against 2024-2025 best practices:

```
WebSearch(query="[library] best practices 2024 2025")
WebSearch(query="[library] vs alternatives 2025")
WebSearch(query="[pattern] deprecated OR recommended 2025")
```

Check for:
- Is this still the recommended approach?
- Are there better alternatives now?
- Any known deprecations or issues?
- Security concerns?

## Step 6: Write Output

**ALWAYS write your validation to:**
```
$CLAUDE_PROJECT_DIR/.claude/cache/agents/validate-agent/output-{timestamp}.md
```

Also write to handoff directory if provided:
```
thoughts/handoffs/<session>/validation-<plan-name>.md
```

## Output Format

```markdown
# Plan Validation: [Plan Name]
Generated: [timestamp]

## Overall Status: [VALIDATED | NEEDS REVIEW]

## Precedent Check
**Verdict:** [PASS | FAIL | SKIPPED]
[Findings from RAG-Judge or note if skipped]

## Tech Choices Validated

### 1. [Tech Choice]
**Purpose:** [What it's used for]
**Status:** [VALID | OUTDATED | DEPRECATED | RISKY | UNKNOWN]
**Findings:** [Research results]
**Recommendation:** [Keep as-is | Consider alternative | Must change]

### 2. [Tech Choice]
...

## Summary

### Validated (Safe to Proceed):
- [Choice 1] ✓

### Needs Review:
- [Choice 2] - [reason]

### Must Change:
- [Choice 3] - [reason and alternative]

## Recommendations
[Specific recommendations if issues found]
```

## Rules

1. **Read the skill file first** - it has the full methodology
2. **Use WebSearch for validation** - don't guess at current best practices
3. **Check all tech choices** - don't skip any
4. **Be specific** - cite sources for deprecations/issues
5. **Write to output file** - don't just return text
6. **Include sources** - URLs for all findings

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

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
vee-validate-skilld skilld-dev Скилл vee-validate-skilld помогает писать, проверять и отлаживать формы Vue 3 с vee-validate 4.15.x. Даёт актуальные примеры Composition API, паттерны схем валидации, интеграцию typed-schema и решение типичных ошибок. CX Codex +1 188установок validate-skills Callstack Скилл validate-skills проверяет скиллы в skills/ по спецификации agentskills.io и практикам Claude Code. Нужен при создании и ревью набора скиллов. CX Codex +1 7 800установок platform-deploy-validate forcedotcom Скилл platform-deploy-validate прогоняет серверную валидацию метаданных Salesforce до деплоя: ошибки видны, орг не тронут. Для продакшена возвращает job ID для быстрого деплоя. CX Codex +1 3 100установок validate Sachin Sharma Команда validate для фильтрации слабых findings перед написанием отчёта. Запускает 7-Question Gate и 4-gate checklist, чтобы отсечь заявки, которые вредят ratio валидности. CX Codex +1 ★ 16 193звёзд репо speckit.git.validate alfredoperez Команда speckit.git.validate проверяет, соответствует ли текущая ветка Git соглашениям об именовании фич-веток. Подходит, если в проекте есть правило для префиксов веток и нужно автоматизировать валидацию. CX Codex +1 ★ 110звёзд репо ads-validate AgriciDaniel Скилл ads-validate гоняет проверки по контрактам, скорингу, бандлам и релизной готовности Claude Ads. Пригодится перед выкаткой и при разборе поломок. CX Codex +1 839установок

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

Весь набор →
modular-code Скилл modular-code для Claude Code делит крупные Python-файлы на модули по смыслу и слоям. Разделяет файлы со смешанными задачами и кодом, который трудно читать и тестировать. CX Codex +1 ★ 3 951звёзд репо compactness Скилл compactness для решения задач на компактность в топологии. Помогает проверить, компактно ли пространство, и применить теоремы Хайне-Бореля, Тихонова и следствия компактности. CX Codex +1 ★ 3 951звёзд репо source-coding Скилл source-coding для Claude Code решает задачи теории информации: оптимальное кодирование, энтропия Шеннона, коды Хаффмана и сжатие данных. CX Codex +1 ★ 3 951звёзд репо sigma-algebras Скилл sigma-algebras для Claude Code решает задачи по теории меры: проверяет аксиомы и измеримость, генерирует сигма-алгебры и строит их произведения. CX Codex +1 ★ 3 951звёзд репо open-sets Скилл open-sets для Claude Code решает задачи по открытым множествам в топологии: проверяет непрерывность функций и открытость множеств в метрических пространствах с помощью Z3. CX Codex +1 ★ 3 951звёзд репо plan-agent Субагент plan-agent изучает кодовую базу и материалы по теме, затем составляет план реализации с этапами, файлами, критериями приёмки и тестированием. Пригодится перед задачей, для которой нужно согласовать порядок работ. CX Codex ★ 3 951звёзд репо sleuth Субагент sleuth для системного разбора ошибок: ищет корень проблемы через код, логи и историю изменений, документирует гипотезы и выводы. CX Codex ★ 3 951звёзд репо scribe scribe — субагент Claude Code для переноса контекста между сессиями. Фиксирует решения, текущий статус и списки изменённых файлов в thoughts и docs. CX Codex ★ 3 951звёзд репо

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

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