One-click install
npx skills add https://github.com/iliaal/whetstone --skill ia-document-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ia-document-review
Source: https://github.com/iliaal/whetstone/tree/main/plugins/whetstone/skills/ia-document-review
Command: npx skills add https://github.com/iliaal/whetstone --skill ia-document-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documents often miss key clarity, completeness, and organizational details, causing teams to proceed on assumptions, skip important risks, or let scope expand unexpectedly.

Core Features & Use Cases

  • Structured document assessment: Identifies unclear, unnecessary, avoided decisions, unstated assumptions, and potential scope creep before editing.
  • Review lenses activation: Dynamically applies product, design, security, scope, and adversarial lenses based on document signals.
  • Actionable evaluation and critical fix: Scores clarity, completeness, specificity, and YAGNI, then highlights the single most important improvement to address.

Quick Start

Ask an AI agent to run ia-document-review on your plan document and then choose whether to refine or complete based on the proposed critical improvement.

Frequently Asked Questions about ia-document-review

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

FAQPage Schema
How do I review a technical spec for completeness and scope creep before implementation?

Spec review for scope creep involves assessing clarity, completeness, specificity, and YAGNI to identify unstated assumptions and avoided decisions before proceeding. The review applies product, design, security, scope, and adversarial lenses to highlight the single most critical improvement needed.

What is the best way to refine an ADR to catch missing risks and assumptions?

ADR refinement requires structured assessment using product, scope, security, and adversarial lenses to expose unstated assumptions and potential risks. It scores key quality criteria, identifies critical gaps in problem framing, and applies minimal, approval-gated inline edits.

How do you score a brainstorm or plan document for readiness?

Plan readiness scoring evaluates clarity, completeness, specificity, and YAGNI criteria to measure document quality. It produces lens-informed assessments that detect unclear elements, unnecessary additions, and avoided decisions, pinpointing the most important improvement before moving forward.

Can I apply a security lens to my workflow plan without creating separate metadata files?

Applying a security lens to workflow plans uses dynamic review lenses based on document signals without adding separate metadata files. It performs minimal, approval-gated inline edits directly within the document to refine security considerations and organizational structure.

When should I use a structured document assessment for pre-implementation workflow steps?

Structured document assessment is needed for pre-implementation workflow steps when teams require disciplined problem framing and readiness validation. Use it to prevent proceeding on assumptions, skipping important risks, or allowing scope to expand unexpectedly during planning.