sweep-ambiguities

Detect linguistic ambiguities and hidden requirements in banking briefs using eight detectors and ten frames.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/Jin9/skillify-foundation --skill sweep-ambiguities-jin9
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sweep-ambiguities
Source: https://github.com/Jin9/skillify-foundation/tree/main/treasury/sweep-ambiguities
Command: npx skills add https://github.com/Jin9/skillify-foundation --skill sweep-ambiguities-jin9

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Structured banking briefs often contain vague wording, unresolved decisions, and missing requirement classes that surface too late in delivery. This Skill systematically scans extraction and compliance results to expose ambiguities and hidden requirements before TL handoff, converting them into tracked open questions or documented assumptions. ## Core Features & Use Cases - Eight Linguistic Detectors: Scans titles, descriptions, evidence, and customer-facing strings for lexical, syntactic, pragmatic, pronominal, quantifier, modal, commitment, and phase-boundary ambiguities, plus placeholder tokens like TBD. - Ten Hidden-Requirement Frames: Applies frames covering scale, timing, money, regulatory, operational, failure, integration, localization, lifecycle, and customer experience, with mandatory coverage accounting for all ten frames. - Severity-Floored Findings: Assigns P1/P2/P3 severities using documented floors, emitting open questions when human decisions are needed and assumptions only when a defensible default with a revisit trigger exists. - Use Case: Given a pipeline state JSON with completed story extraction and compliance results for a wire-transfer feature, produce a strict JSON report listing a P1 open question about Legal-approved customer status wording, a modal-hedge finding, and full frame-coverage metadata. ## Quick Start Scan this banking brief's pipeline state JSON for hidden requirements and linguistic ambiguities, then return the stage3 ambiguity JSON report.

Frequently Asked Questions about sweep-ambiguities

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

FAQPage Schema
How do I find hidden requirements in a banking requirements brief?▼

Run an ambiguity sweep that applies ten hidden-requirement frames covering scale, timing, money, regulatory, operational, failure, integration, localization, lifecycle, and customer experience. Each frame is applied or skipped with a reason, and gaps become open questions or documented assumptions.

What types of linguistic ambiguity can be detected in requirement documents?▼

Eight detector types cover lexical vagueness, syntactic ambiguity, pragmatic references, pronominal antecedents, quantifiers without denominators, modal hedges, commitment conditionality, and phase-boundary drift. Placeholder tokens like TBD or anonymous numeric values also produce findings.

How are ambiguity severity levels P1, P2, and P3 assigned?▼

Severity follows documented floors: P1 for handoff blockers like unresolved regulator citations or tipping-off violations, P2 for decisions needed before sprint planning such as conflicting acceptance criteria, and P3 for assumptions that can proceed with review.

When should an ambiguity become an open question versus an assumption?▼

Emit an open question when a human decision is required, with severity, rationale, and a suggested resolver. Emit an assumption only when a defensible default exists, and always include a revisit trigger such as a Legal sign-off meeting.

When should I not use an ambiguity sweep on requirements?▼

Do not use it for strict PII or Legal audits, story extraction, or Gherkin writing. It is designed specifically for detecting ambiguities and hidden requirement gaps in already-extracted and compliance-checked pipeline state.