Requirement Consistency Analysis
SkillDocs & knowledgeLets your agent compare requirement documents to find where terminology, rules, or behavior disagree.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Requirement Consistency Analysis skill
About this capability
Use this skill when multiple requirement artifacts may disagree on terminology, identifiers, formats, states, rules, or behavior; triggers include requirement consistency, cross-document consistency, and consistency analysis.
What this skill tells your AI
The instructions your AI receives, as published by naodeng/awesome-qa-skills in skills/en/testing-types/requirement-consistency-analysis/SKILL.md and read by ahel’s review.
Compare supplied requirements, contracts, designs, or rule artifacts to determine whether terminology, identifiers, formats, states, rules, and behavior agree within the same applicability scope. Preserve source and version boundaries; never silently merge mutually exclusive constraints.
When to Use
- PRDs, stories, API contracts, prototypes, technical notes, or acceptance criteria use different names or states.
- You need to check whether multiple materials describe the same actor, field, flow, and outcome consistently.
- The same flow may differ by version, time, platform, or role and applicability must be established first.
Do not use it with one source when only general requirements analysis is needed, or to make a business decision for an explicit conflict.
Output Format Options
- Use Markdown by default; when a table, CSV, or JSON is requested, preserve the same evidence, status, impact, owner, and validation fields.
- Do not present a structured format or static inventory as execution, pass, approval, or release evidence.
How to Use
- Read this Skill's primary prompt and provide the objective, scope, material, environment, and available evidence.
- Follow the prompt's input audit and output contract; deliver a bounded first pass when information is incomplete.
- Retain source, evidence status, impact, owner role, close condition, and validation method for every finding.
Workflow
- Read and follow
prompts/requirement-consistency-analysis.md. - Inventory source, version, time, actor, platform, and applicability scope. State the limitation when a comparison artifact is missing.
- Compare terminology, identifiers, formats, states, rules, and behavior using stable keys; preserve evidence and relationship per item.
- Distinguish relation values
aligned,inconsistent, andconflictfrom evidence statusesassessed,missing,stale, andunassessed; never silently merge mutually exclusive rules. - When the task requests
business-rulemode, use stable rule keys andBR-##rule-level evidence for subject, trigger, applicability, precedence/override, action, outcome, and exception while retaining genericRC-##findings. - Provide impact, priority, owner role, open question, close condition, and validation method.
Core Constraints
- Use
RC-##finding IDs; each row includes source pair, comparison key, relation, status, evidence, scope/version, impact, and action. Relations arealigned,inconsistent, orconflict; statuses areassessed,missing,stale, orunassessed. - In
business-rulemode, addBR-##rule-level evidence for subject/object, trigger, applicability, precedence/override, action, outcome, and exception; never treat “stricter” as automatically higher precedence. - Status values:
assessed,missing,stale, andunassessedare evidence states, not relation values. - Do not treat similar names as synonyms and do not call one source consistent merely because a second source is absent.
- Do not compare across versions or applicability scopes as if they were one fact. Use
stale/unassessedwhen scope is unclear. - Suggest
requirement-conflict-detectionfor explicit mutually exclusive rules by Skill name only; do not link its internal files. - Do not invent state transitions, field meaning, platform support, or a final specification.
Reference Files
- Always read
prompts/requirement-consistency-analysis.mdbefore producing an analysis. - Use
evals/eval.yamlandevals/cases/to regress this Skill; structural gates do not prove cross-source semantic correctness. - To check discovery behavior, run
scripts/run_skill_trace_eval.pywithevals/trigger-prompts.csvandevals/local-rules.json; missingskill.selectionevidence isBLOCKED, not a trigger pass. - This is a repository-root development check; a standalone Skill package does not include the repository runner and does not depend on it at runtime.
- To check
business-rulemode, use thebusiness-rule-*Evals and a local trigger prompt containing the business-rule phrase; the physical directory remains this Skill and no alias directory is created.
Best Practices
- Prioritize high-impact gaps with a verifiable next action, using the smallest useful experiment or evidence request.
- Separate facts, evidence-backed inferences, recommendations, and Human decisions; never upgrade an assumption into a conclusion.
Pre-delivery Checklist
- Each comparison conclusion cites source, version/scope, and minimum evidence
- Relation values
aligned,inconsistent, andconflictare separate from statusesassessed,missing,stale, andunassessed - Explicit conflict is not silently merged or incorrectly downgraded
- P0/P1 issues have owner role, decision question, and validation method
- Names, document existence, and static tables are not presented as runtime results
Common Pitfalls
- Treating similar terms as the same object without evidence.
- Ignoring document version, publication time, platform, tenant, or region.
- Filling one source's omissions with another source's unstated defaults.
- Rewriting conflicting statements into an unapproved compromise rule.
Signals
- GitHub stars
- 217
- Forks
- 31
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
requirement-consistency-analysis- Source
- github.com/naodeng/awesome-qa-skills