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.