requirement-convergence is agent-read markdown (skill) from shinpr/claude-code-workflows: Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from structure. Use when a requirement enters a workflow, before design begins..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns 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 structural 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.
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_i2zc6sprmuxghbty
GET https://markdownregistry.com/api/v1/resolve?ref=shinpr/claude-code-workflows/requirement-convergence
GET https://markdownregistry.com/api/v1/blob/1ef34dc5ff1fb8cd3add5c00ec1fe8ba863f51654ae3f5805b3b4c271f275c9c
Your agent 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.
shinpr/claude-code-workflows · dev-skills/skills/coding-principles/SKILL.md · Language-agnostic coding principles for maintainability, readability, and quality. Use when implementing features…
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…
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…
shinpr/claude-code-workflows · dev-skills/skills/integration-e2e-testing/SKILL.md · Integration and E2E test design principles, ROI calculation, test skeleton specification, and review criteria. Use when…
shinpr/claude-code-workflows · dev-skills/skills/requirement-convergence/SKILL.md · Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded…
shinpr/claude-code-workflows · dev-skills/skills/test-implement/SKILL.md · Implements React/TypeScript unit, integration, and browser E2E tests with the repository's configured runner, mocks…
shinpr/claude-code-workflows · dev-skills/skills/testing-principles/SKILL.md · Language-agnostic testing principles including TDD, test quality, coverage standards, and test design patterns. Use…
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…
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…
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…
shinpr/claude-code-workflows · dev-skills/skills/requirement-convergence/SKILL.md · Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded…
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…
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?'…
