rd-specification · diff

git:20260807.e82ae86 to git:20261009.a01d3df

1 added, 1 removed. Audit A to A.

---

name: rd-specification

description: >-

Draft or revise national, industry, enterprise, internal, or project

standards, specifications, guidelines, and normative clauses. Use when

authority, scope, terminology, references, conformity criteria, or normative

wording must be established or changed. Route an independent verdict to

`rd-review`, and route implementation or execution to their owning workflows.

---

# rd-specification

Support **standards and specification work** with clause-level rigor, evidence discipline, and normative wording control.

## Deliverables

- Standards/specification draft outline or clause draft

- Clause-level issue and revision table

- Normative wording replacement proposals

- Terminology and reference consistency checklist

- Open issues requiring expert, legal, standards-body, or domain-owner confirmation

## Execution Steps

### 1. Scope and Authority Confirmation

- Identify the standard type: national, industry, enterprise, internal guideline, or project specification

- Confirm the document status: draft, review draft, approval draft, published baseline, or revision

- Identify the target audience and expected authority of the document

- Confirm whether the work is drafting, revision, clause analysis, comparison, or gap analysis

- Identify the governing drafting rules and normative vocabulary for the target standards body or organization; do not assume one universal shall/should convention

- Confirm jurisdiction, edition, effective date, supersession status, and applicability boundary when they affect authority

**Completion criterion:** document type, status, authority, task mode, drafting rules, jurisdiction, edition, and applicability are either verified or explicitly bounded.

### 2. Target and Authority Hierarchy

Treat the current target text and clause numbering as the object under change, not as proof of its own authority. Establish governing authority in this order:

1. Binding laws, regulations, standards, official specifications, or formally delegated authority

2. Applicable referenced standards and normative documents

3. Approved upstream project documents or organizational rules within their delegated scope

4. Expert judgment, clearly labeled as judgment rather than fact

When evidence is missing, mark "insufficient evidence, requires human verification" instead of inventing a basis.

**Completion criterion:** every material clause or revision proposal identifies its target anchor and governing authority level; conflicts between the target and a higher authority, and unavailable authority, remain visible as verification gaps.

### 3. Clause-Level Analysis

For each issue or proposal:

- Quote or identify the exact clause, table, figure, or term being discussed

- State the issue type: correctness, consistency, enforceability, ambiguity, scope, terminology, reference, or format

- Explain the evidence and reasoning

- Provide a replacement wording proposal when possible

- Distinguish mandatory requirements from recommendations and informative notes

**Completion criterion:** every reported issue identifies an exact location, issue type, evidence, impact, and bounded replacement or verification action.

### 4. Normative Wording Control

- Use clear mandatory language for requirements and avoid vague verbs such as "support", "optimize", or "improve" unless they are defined

- Avoid unverifiable adjectives such as "advanced", "secure", "fast", or "reliable" without criteria

- Keep terms consistent with the glossary and referenced standards

- Avoid adding implementation-specific details unless the standard intentionally constrains implementation

**Completion criterion:** every normative statement has unambiguous force, scope, actor, condition, and verifiable outcome without relying on undefined or promotional language.

### 5. Consistency and Traceability Checks

- Cross-check terminology, abbreviations, symbols, tables, figures, and references

- Check whether requirements conflict across clauses or with referenced documents

- Confirm that each mandatory clause is testable, inspectable, or otherwise verifiable

- Define or identify the conformity-assessment method, evidence, sampling boundary, and responsible party when the clause requires compliance demonstration

- List unresolved conflicts and required decision owners

**Completion criterion:** terminology, references, cross-clause obligations, and conformity methods are consistent, with every unresolved conflict assigned or explicitly unassigned for human decision.

## Context and Baseline Check

Pre-execution checks:

- Required standards template, numbering convention, and drafting rules

- Glossary and normative references

- Existing review comment format

- Domain-specific compliance, safety, cybersecurity, or industry requirements

## Tool Selection

- - Use `rd-research` for current standards status, regulations, official interpretations, or external technical facts

+ - Use `rd-research` only when material evidence gaps about current standards status, regulations, official interpretations, or external technical facts need focused research; reuse inspected evidence that remains current and applicable, and keep routine source checks within specification work

- Prefer standards bodies, regulators, official specifications, and inspected normative sources

- Use Context7 or an equivalent documentation retriever only when a clause depends on current software, protocol, SDK, or API behavior

- When authoritative text is inaccessible, verify metadata only and mark clause content for human confirmation

## Quality Gates

Pre-delivery checklist:

- [ ] Every clause issue or proposal references a specific clause, table, figure, or term

- [ ] Evidence level is explicit; unsupported claims are marked for human verification

- [ ] Normative wording is clear, testable, and scope-bounded

- [ ] Terminology and references are consistent

- [ ] Replacement wording is provided for major issues when possible

- [ ] Mandatory, recommended, and informative content are not mixed

- [ ] Jurisdiction, edition, applicability, and conformity method are explicit where material

- [ ] Target text is not treated as self-authorizing, and conflicts with governing authority are resolved or exposed

- [ ] No invented standard clauses, document statuses, or source claims

## Out of Scope

- Do not fabricate standards text, publication status, or legal authority

- Do not cite inaccessible or unverified standards as if their content were known

- Do not convert expert preference into a mandatory requirement without authority

- Do not perform code implementation, testing, deployment, or runtime verification