assumption-review

Identify hidden assumptions, unknowns, and logical gaps in planning artifacts.

2|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/nholder88/ai-agent-workflows --skill assumption-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: assumption-review
Source: https://github.com/nholder88/ai-agent-workflows/tree/main/skills/assumption-review
Command: npx skills add https://github.com/nholder88/ai-agent-workflows --skill assumption-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews artifacts to identify hidden assumptions, unknowns, gaps, stakeholder omissions, and risk, delivering severity-tagged findings to inform early decisions.

Core Features & Use Cases

  • Six-category review framework (Hidden Assumptions, Unknowns, Logical Gaps, Overlooked Stakeholders, Risk Assessment, Completeness)
  • Produces severity-tagged findings with concrete questions
  • Suitable for artifacts: plans, specs, PBIs, ADRs, architecture docs, roadmaps, meeting notes, decision records
  • Outputs a structured "Assumption Review Report" with Summary and Verdict

Quick Start

Use the assumption-review skill to generate a structured review of your artifact.

Frequently Asked Questions about assumption-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify hidden assumptions and logical gaps in a planning artifact?▼

To identify hidden assumptions and logical gaps in a planning artifact, you can use a six-category review framework that analyzes documents for unknowns, stakeholder omissions, and risks, outputting a structured report with severity-tagged findings.

What is the best way to review technical specifications and architecture documents for risk before development?▼

Reviewing technical specifications and architecture documents for risk involves applying a structured assessment to uncover completeness issues and hidden unknowns, generating a severity-tagged Assumption Review Report to inform early decisions.

Can I use assumption review to evaluate product backlog items and roadmaps?▼

Yes, you can evaluate product backlog items and roadmaps using this review method, which scans artifacts for hidden assumptions, overlooked stakeholders, and logical gaps, delivering a structured summary and final verdict.

How do I run a completeness check on meeting notes and decision records?▼

Running a completeness check on meeting notes and decision records requires analyzing the text against six review categories to surface stakeholder omissions and unknowns, ultimately producing a structured review report with concrete questions.

Does the assumption review process require any specific dependencies or external components?▼

No, the assumption review process requires no external dependencies or components to function, allowing you to directly analyze architecture documents, specs, and plans without preliminary environment setup.