Automated cross-document validation for data models, routes, RBAC, and terminology. Use after parallel document creation or before milestone reviews to catch contradictions.
<skill_info> <name>nmblr:check-consistency</name>
<summary>Cross-document consistency validation — catches contradictions in data models, APIs, RBAC, and terminology.</summary> <agent>consistency-checker</agent> <config_file>.claude/nmblr/config.yaml</config_file> </skill_info> <usage> <syntax>nmblr:check-consistency</syntax> <syntax>nmblr:check-consistency --scope all</syntax> <syntax>nmblr:check-consistency --scope milestone M1</syntax> <syntax>nmblr:check-consistency --focus data-models</syntax> <syntax>nmblr:check-consistency PRD-0001 RFC-0003</syntax> </usage> <arguments> <argument name="doc-ids" required="false"> <description>Optional specific document pair to check (e.g., PRD-0001 RFC-0003)</description> </argument> </arguments> <options> <option name="--scope" value_type="scope">Scope of check: "all" for all documents, "milestone M1" for milestone-scoped docs (default: all non-archived)</option> <option name="--focus" value_type="area">Focus area: data-models, routes, rbac, terminology, status, all (default: all)</option> </options><execution_instructions> When this skill is invoked:
Determine scope
list-documents.sh for each type to gather documents:
bash .claude/nmblr/scripts/docs/list-documents.sh --type PD
bash .claude/nmblr/scripts/docs/list-documents.sh --type RFC
bash .claude/nmblr/scripts/docs/list-documents.sh --type PRD
bash .claude/nmblr/scripts/docs/list-documents.sh --type ADR
bash .claude/nmblr/scripts/docs/list-documents.sh --type AD
Delegate to consistency-checker agent
consistency-checker agent with document paths and focus areaThe consistency-checker will:
</execution_instructions>
<focus_areas> <area name="data-models"> Compare entity definitions across PRDs (data models section), RFCs (implementation), and AD (architecture). Flag when fields are added/removed/renamed without being noted across documents. </area> <area name="routes"> Compare API endpoint definitions in PRDs vs RFC implementation plans vs AD. Flag mismatched paths, methods, request/response schemas. </area> <area name="rbac"> Compare role definitions and permission matrices across documents. Flag when a role exists in one document but not another, or permissions differ. </area> <area name="terminology"> Flag when the same concept uses different names across documents (e.g., "user" vs "account" vs "member" for the same entity). </area> <area name="status"> Flag documents referencing other documents whose status has changed (e.g., PRD referencing superseded ADR, RFC referencing completed PD). </area> </focus_areas>