validate-agent — субагент для Claude Code: проверка tech-выборов
Субагент validate-agent проверяет технические решения в плане против текущих best practices и прошлого опыта. Запускается перед реализацией, чтобы поймать устаревшие подходы и риски.
MIT ★ 3 951 обновлён 2026-01-26
.claude/agents/validate-agent.mdЧто делает 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 или по @-упоминанию
Вручную: положить файлы
.codex/agents/validate-agent.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/validate-agent.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты 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