requirement-convergence SKILL.md skillA

This file is byte-identical to the first copy the registry indexed, one of 5 indexed copies. Same content hash, so the same checks give both the same grade.

requirement-convergence from shinpr/claude-code-workflows is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add shinpr/claude-code-workflows/requirement-convergence@git:20261029.29a1f7c

Pins git:20261029.29a1f7c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
shinpr/claude-code-workflows
Path
dev-skills/skills/requirement-convergence/SKILL.md
Versions recorded
10
Latest version
git:20261029.29a1f7c, committed Oct 29, 2026
First version recorded
Jul 31, 2026
Size
6,168 bytes
Repository stars
707
License
MIT

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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, are settled after the what is.

## 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.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add shinpr/claude-code-workflows/requirement-convergence@sha256:d42240830c66f6a7

The line at the top of this page pins the label git:20261029.29a1f7c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_j3kx5lmd354j7hlw.svg)](https://markdownregistry.com/a/art_j3kx5lmd354j7hlw)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 10 versions of this file, between Jul 31, 2026 and Oct 29, 2026, about one every 10 days.

versioncommittedcommitsizeaudit
git:20261029.29a1f7c latest2026-10-29 29a1f7c 6,168 BA view · diff
git:20261019.e544b5c2026-10-19 e544b5c 6,146 BA view · diff
git:20260917.c5b7fa62026-09-17 c5b7fa6 6,104 BA view · diff
git:20260917.bbe09882026-09-17 bbe0988 6,113 BA view · diff
git:20260917.103ec842026-09-17 103ec84 4,880 BA view · diff
git:20260915.b4b56112026-09-15 b4b5611 4,793 BA view · diff
git:20260823.056772e2026-08-23 056772e 4,764 BA view · diff
git:20260809.61302722026-08-09 6130272 4,425 BA view · diff
git:20260803.b3500492026-08-03 b350049 4,421 BA view · diff
git:20260731.d086ac82026-07-31 d086ac8 4,350 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6168 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

shinpr/claude-code-workflows · 707 stars · license MIT · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_j3kx5lmd354j7hlw
GET https://markdownregistry.com/api/v1/resolve?ref=shinpr/claude-code-workflows/requirement-convergence
GET https://markdownregistry.com/api/v1/blob/d42240830c66f6a7045a5c2e988aae911f62368160ff5d6ceffb5e2b3ad9a0d7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from shinpr/claude-code-workflows

ai-development-guide SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/ai-development-guide/SKILL.md · Applies language-agnostic and backend technical decision criteria, anti-pattern detection, debugging, and quality…
git:20261019.e544b5c · audit A · 707 stars
coding-principles SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/coding-principles/SKILL.md · Language-agnostic coding principles for maintainability, readability, and quality. Use when implementing features…
git:20261019.e544b5c · audit A · 707 stars
documentation-criteria SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/documentation-criteria/SKILL.md · Determines which of PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires, and where each is stored. Use when…
git:20261029.3d4a3cd · audit A · 707 stars
external-resource-context SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/external-resource-context/SKILL.md · Records where resources outside the repository live (design source, design system, API schema, IaC source, secret…
git:20261019.e544b5c · audit A · 707 stars
frontend-ai-guide SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/frontend-ai-guide/SKILL.md · Applies React/TypeScript-specific technical decision criteria, anti-pattern detection, debugging, and frontend quality…
git:20261013.5482041 · audit A · 707 stars
implementation-approach SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/implementation-approach/SKILL.md · Implementation strategy selection framework. Use when planning implementation strategy, selecting development approach…
git:20261013.5482041 · audit A · 707 stars
integration-e2e-testing SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/integration-e2e-testing/SKILL.md · Defines integration/E2E skeleton annotations, lane and file contracts, and route-parity review criteria. Use when…
git:20261019.4d66b0c · audit A · 707 stars
llm-friendly-context SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/llm-friendly-context/SKILL.md · Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream consumers can execute…
git:20261019.de01f9e · audit A · 707 stars
testing-principles SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/testing-principles/SKILL.md · Language-agnostic testing principles for choosing which tests a change needs, test quality, and proof ownership, with…
git:20261019.4d66b0c · audit A · 707 stars
typescript-rules SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/typescript-rules/SKILL.md · React/TypeScript frontend development rules including type safety, component design, state management, and error…
git:20260728.e9e235b · audit A · 707 stars
ai-development-guide SKILL.md skill
shinpr/claude-code-workflows · dev-workflows-frontend/skills/ai-development-guide/SKILL.md · Applies language-agnostic and backend technical decision criteria, anti-pattern detection, debugging, and quality…
git:20261019.e544b5c · audit A · 707 stars
coding-principles SKILL.md skill
shinpr/claude-code-workflows · dev-workflows-frontend/skills/coding-principles/SKILL.md · Language-agnostic coding principles for maintainability, readability, and quality. Use when implementing features…
git:20261019.e544b5c · audit A · 707 stars

Every file in shinpr/claude-code-workflows

Other files named requirement-convergence

requirement-convergence SKILL.md skill
shinpr/claude-code-workflows · skills/requirement-convergence/SKILL.md · Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded…
git:20261029.29a1f7c · audit A · 707 stars
requirement-convergence SKILL.md skill
shinpr/claude-code-workflows · dev-workflows-fullstack/skills/requirement-convergence/SKILL.md · Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded…
git:20261029.29a1f7c · audit A · 707 stars
requirement-convergence SKILL.md skill
shinpr/claude-code-workflows · dev-workflows/skills/requirement-convergence/SKILL.md · Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded…
git:20261029.29a1f7c · audit A · 707 stars
requirement-convergence SKILL.md skill
shinpr/claude-code-workflows · dev-workflows-frontend/skills/requirement-convergence/SKILL.md · Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded…
git:20261029.29a1f7c · audit A · 707 stars
requirement-convergence SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/requirement-convergence/SKILL.md · Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded…
git:20260923.558b381 · audit A · 236 stars
requirement-convergence SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-zh-CN/requirement-convergence/SKILL.md · 将变更必须产生的结果与为达成该结果而提出的需求区分开来,记录用户明确排除的内容,并根据结构对成本进行分级评估。当需求进入某个工作流时、设计开始之前,或提到“做到什么程度/范围外是什么/是否值得做”时使用。
git:20260923.558b381 · audit A · 236 stars
requirement-convergence SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-ja/requirement-convergence/SKILL.md · 変更が生むべき成果と、そこへ至るために提案された要件を切り分け、ユーザーが除外したものを記録し、構造からコストをおおまかな区分で見積もる。要件がワークフローに入った時点、設計を始める前、または「どこまでやるか/スコープ外は何か/やる価値があ…
git:20260923.558b381 · audit A · 236 stars
requirement-convergence SKILL.md skill
shinpr/codex-workflows · .agents/skills/requirement-convergence/SKILL.md · Converges future-state requirements around outcome, exclusions, and rough cost. Use when users ask 'do we need this?'…
git:20261102.2a1d2f6 · audit A · 38 stars

Browse by kind, by grade A, or by owner.