assumption-scan

Identify and assess hidden assumptions in technical designs and plans.

3|Updated Nov 19, 2025
One-click install
npx skills add https://github.com/meaganewaller/.dotfiles --skill assumption-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: assumption-scan
Source: https://github.com/meaganewaller/.dotfiles/tree/main/home/.claude/skills/common/assumption-scan
Command: npx skills add https://github.com/meaganewaller/.dotfiles --skill assumption-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps identify and mitigate risks by systematically uncovering the unstated assumptions and hidden dependencies within a design, plan, or implementation.

Core Features & Use Cases

  • Assumption Identification: Categorizes assumptions into explicit, implicit, environmental, performance, team knowledge, temporal, and dependency types.
  • Fragility Assessment: Quantifies the risk of each assumption based on likelihood and impact.
  • Mitigation Planning: Recommends strategies like validation, fallback, or redesign to address high-risk assumptions.
  • Use Case: Before deploying a new microservice, use this skill to review the design document and identify all assumptions about network latency, downstream service availability, and data consistency, ensuring potential failure points are addressed proactively.

Quick Start

Run the assumption scan skill on the attached design document to identify potential risks.

Frequently Asked Questions about assumption-scan

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

FAQPage Schema
How do I identify hidden assumptions in a technical design document?

To identify hidden assumptions in a technical design, systematically categorize them into explicit, implicit, environmental, performance, team knowledge, temporal, and dependency types to uncover untested beliefs before production incidents occur.

What is the best way to assess technical debt and fragility in a system design?

Assess technical debt and fragility by quantifying the risk of each assumption based on its likelihood and impact, which helps surface fragile dependencies and untested beliefs before they cause production incidents.

How do I mitigate high-risk assumptions before deploying a new microservice?

Mitigate high-risk assumptions before deploying a new microservice by applying recommended strategies like validation, fallback, or redesign to address potential failure points such as network latency and data consistency proactively.

Can I use an assumption scan for dependency risk assessment on downstream services?

Yes, you can use an assumption scan for dependency risk assessment to review downstream service availability and data consistency, ensuring potential failure points are addressed proactively during design review.

When should I perform a risk assessment on technical proposals and plans?

Perform a risk assessment on technical proposals and plans before deployment to facilitate proactive risk management, ensuring robust system design by uncovering untested beliefs and fragile dependencies early.