К основному содержанию
скилл CX Codex

requirement-convergence — скилл для Claude Code: установка

Скилл requirement-convergence для Claude Code отделяет целевой результат изменений от предложенных требований и фиксирует исключения пользователя. Включается на этапе сбора требований до проектирования архитектуры.

MIT ★ 720 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add shinpr/claude-code-workflows --skill requirement-convergence -a claude-code
Открыть на GitHub

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

Скилл фиксирует, что именно предстоит собрать, до выбора архитектуры и написания кода. Он разбивает задачу на четыре поля: единый наблюдаемый результат outcome, список требований requirements[] со статусами текущего и целевого состояния, явные исключения nonGoals[] и ориентировочный диапазон затрат cost на базе структуры репозитория.

Перед проектированием агент проводит процедуру подтверждения скоупа. Вопросы задаются только по полям со статусом ниже ready, а ответы сохраняются строго в формулировках пользователя, без подмены кандидатами от модели. Если требование остаётся нерешённым после повторного вопроса, с согласия пользователя ему присваивается статус weak-but-explicit.

Итоговая запись передаётся в разделы PRD, документ дизайна или контекст рабочего процесса. Спекулятивные идеи, предварительные механизмы и неподтверждённые предложения агента отсекаются и не создают обязательств для дальнейшей разработки.

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

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

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

  • Проведи согласование требований для новой фичи экспорта отчётов перед тем, как переходить к архитектуре
  • Зафиксируй outcome и nonGoals для задачи рефакторинга авторизации
  • Проверь скоуп изменений в репозитории и заполни поля convergence

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

1Через Skills CLI (Vercel)

npx skills add shinpr/claude-code-workflows --skill requirement-convergence -a claude-code

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

~/.claude/skills/requirement-convergence/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/requirement-convergence/

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

Вопросы о requirement-convergence

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

Выполните команду npx skills add shinpr/claude-code-workflows --skill requirement-convergence -a claude-code или добавьте файл по пути ~/.claude/skills/requirement-convergence/SKILL.md.

Что делает requirement-convergence?

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

Когда скилл считает требования согласованными?

Требования считаются сошедшимися, когда каждое применимое поле получило статус ready либо отмечено пользователем как weak-but-explicit.

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

SKILL.md · MIT
---
name: requirement-convergence
description: Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from decision-relevant repository evidence. Use when a requirement enters a workflow, before design begins.
---

# Requirement Convergence

## Purpose

Requirements arrive bloated, ambiguous, or aimed at the wrong outcome. A capable model reconciles all three into a coherent plan and builds it faithfully — delivering exactly what was asked for when what was asked for was wrong.

This skill converges **what to build**. How to build it, and which documents the change requires, come after the what.

## Convergence Fields

| Field | Pass condition |
|-------|----------------|
| `outcome` | One observable result. A requirement that does not serve it is excess. |
| `requirements[]` | Every build-relevant item labeled `current-state` or `desired-future`. |
| `nonGoals[]` | Authored by the user, or the user stated there are none. |
| `cost` | A band with the repository and lifecycle evidence that places it, plus the unknowns that remain. |

`cost` is a rough band, not the effort estimate a work plan schedules against; requirements cannot support person-days. Its unknowns carry more decision weight than its size.

Classify from the user's own retained wording, not from an analyzer's restatement of it: wording that asks for an evaluation, describes a speculative idea, or suggests a mechanism stays in active convergence context as a judgment-only candidate. `requirements[]` and durable documents receive a candidate only after explicit user confirmation.

Each field carries a readiness label: `ready`, `weak`, or `weak-but-explicit` (weak, and the user agreed to leave it unresolved). Only the user sets `weak-but-explicit`. Requirements are converged when every applicable field is `ready` or `weak-but-explicit`.

Judgment rules per field: [references/criteria.md](references/criteria.md).

## Hearing Protocol

Run the hearing after scope analysis has produced the facts needed to judge the convergence fields. The workflow using this skill owns the interaction method and routing; this skill defines the hearing content and pass conditions.

Register these steps before starting and record each step's evidence as it completes:

| Step | Action | Completion evidence |
|------|--------|---------------------|
| 1 | Render the Scope Confirmation below, asking only about the fields below `ready` | Each fact cites the analysis output it came from, and **User decisions** holds one question per field below `ready` |
| 2 | Record each answer as that field's value | The value uses wording the user supplied, not wording the hearing offered |
| 3 | Re-ask once when a recorded value still fails its pass condition, then mark the field `weak-but-explicit` when the user agrees to leave the second answer as it stands | Two recorded answers, or the user's agreement to stop |
| 4 | Hand the record to the step that judges the fields | An updated record returned from that step |

Step 2's evidence is what keeps the hearing reviewable: a value restating the hearing's own candidates fails it, so the user's judgment survives however the question was put.

## Scope Confirmation

Render this shape at every requirements confirmation stop, whether or not the hearing ran, using only what can change the user's requirement decision or the workflow route.

| Section | Contents |
|---------|----------|
| **User-selected scope** | The requirements and exclusions the user has already selected, in the user's wording |
| **Decision evidence** | Each material observed fact with its source, followed by what that fact can change about scope, outcome, or cost |
| **User decisions** | One question per convergence field below `ready` (Hearing Protocol Step 1), followed by the scope, outcome, or cost effects of its materially different answers |
| **Workflow** | Rough cost band with the unknowns that remain, Structural Scale, and the selected document and workflow route |

Keeping the first three sections separate is what makes the decision informable: merged, the reader cannot tell which line is the user's own selection, which is a repository observation, and which is still open.

Only an explicit user answer moves an item from **User decisions** into **User-selected scope**. Because Step 2 records the user's own wording, pose each open decision as a question and let the user supply its answer. The orchestrator owns **Workflow** and presents it as a selected route.

## Storage Protocol

| Carrier | Holds | Written by |
|---------|-------|------------|
| The convergence record in the judging step's output | Every field with its readiness label | The judging step |
| PRD `Success Criteria` and `Future / Out of Scope` | `outcome`; user-authored `nonGoals` | The PRD production step |
| Design Doc `Requirement Convergence` | The same when no PRD exists, and the fields left `weak-but-explicit` in every case | The Design Doc production step |

A flow that produces neither document carries the record in its own context to the next step.

## Reference Protocol (For Downstream Consumers)

1. Read the convergence record from the prompt.
2. Treat `nonGoals` as excluded from the current change and `desired-future` requirements as buildable scope. Evaluation requests, speculative ideas, prescribed mechanisms, and agent-proposed capabilities that were not promoted create no downstream obligation; an accepted ADR may retain evaluated options as decision history.
3. Treat a `weak-but-explicit` field as a recorded open question rather than a settled decision. When work depends on it, return the missing decision and its effect to the owning workflow.

## Quality Checklist

- [ ] Scope facts were presented before questions were asked
- [ ] `nonGoals` came from the user, or the user stated there are none
- [ ] Every applicable field is `ready`, or `weak-but-explicit` by the user's agreement

## References

- [references/criteria.md](references/criteria.md) — judgment rules per field, cost inputs, challenge intensity, solution-in-disguise test

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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
prd snarktank Скилл опрашивает разработчика и формирует структурированный PRD для новой фичи в файле tasks/prd-[feature-name].md. Помогает зафиксировать требования до написания кода. CX Codex +1 1 500установок feature-spec pproenca Скилл feature-spec для Claude Code задаёт 42 правила для PRD, фиксации скоупа и приоритизации задач. Помогает спланировать функционал до написания кода. CX Codex +1 438установок interview-me addyosmani Скилл interview-me для Claude Code опрашивает разработчика вопросами по одному, пока не прояснит скрытую цель задачи до 95% уверенности. Запускается до создания ТЗ и кода при неполных требованиях. CX Codex +1 73 400установок prd-writing agent-skills Скилл prd-writing для Claude Code помогает составить продуктовые требования: проводит агента через 6 этапов сбора контекста до кодинга и использует шаблон на 12 разделов. CX Codex +1 722установок write-prd OrchestKit Скилл write-prd формирует 8-секционные продуктовые спецификации с историями пользователей INVEST, критериями приёмки и гейтом go/no-go. Сохраняет готовый документ в файл PRD-[product-name].md. CX Codex +1 336установок notion-spec-to-implementation makenotion Скилл notion-spec-to-implementation для Claude Code превращает спецификацию Notion в план работ и задачи. Он сверяет реализацию с требованиями и фиксирует прогресс. CX Codex +1 389установок

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

Весь набор →
acceptance-test-generator Субагент acceptance-test-generator для Claude Code создаёт каркасы интеграционных и E2E-тестов на основе критериев приёмки из Design Doc. Запускается при проектировании тестов или по фразе test skeleton. CX Codex ★ 720звёзд репо requirement-analyzer Субагент requirement-analyzer собирает границы изменений и факторы затрат в кодовой базе для подтверждения требований перед разработкой. 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звёзд репо work-planner Субагент work-planner для Claude Code превращает утверждённые Design Doc в план реализации с задачами, зависимостями и проверками. Запускается при запросе плана работ или планирования задач. CX Codex ★ 720звёзд репо typescript-rules Набор правил для фронтенд-разработки на React и TypeScript: типобезопасность, устройство компонентов, владение состоянием и обработка ошибок. CX Codex +1 ★ 720звёзд репо documentation-criteria Скилл documentation-criteria для Claude Code определяет, какие документы нужны изменению и где их хранить. Агент подключает его при выборе объёма документации или создании и проверке технического документа. CX Codex +1 ★ 720звёзд репо codebase-analyzer Субагент codebase-analyzer для Claude Code собирает факты о кодовой базе перед составлением Design Doc. Запускается по утверждённому PRD или списку требований для оценки повторного использования и рисков. CX Codex ★ 720звёзд репо

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

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