clarify

Resolve ambiguous content in a single DAE artifact through an interview loop.

134|9|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/swingerman/disciplined-agentic-engineering --skill clarify-swingerman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/swingerman/disciplined-agentic-engineering/tree/main/engineer/skills/clarify
Command: npx skills add https://github.com/swingerman/disciplined-agentic-engineering --skill clarify-swingerman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Clarify removes uncertainty inside a single DAE artifact by turning vague or underspecified requirements into explicit, agreed-upon decisions you can encode and verify.

Core Features & Use Cases

  • Single-artifact ambiguity resolution: Identifies ambiguous lines (two-way interpretation, undefined terms, unclear scope, internal contradictions) and resolves them without touching other artifacts.
  • Iterative question-and-edit workflow: Asks one focused question per ambiguity (bounded multiple-choice when appropriate, open-ended otherwise) until the ambiguity is resolved.
  • In-place, traceable updates with handoff: Records old→new edits in the target artifact and flags any downstream staleness, recommending the appropriate next skill to propagate changes.

Quick Start

Use the /engineer.clarify command with a path to a single artifact, such as /engineer.clarify path/to/spec.md, to resolve ambiguities and update that file in place.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I resolve ambiguous requirements in a single specification document?

You can resolve ambiguous requirements in a single specification document by running an iterative interview loop that asks one focused question per ambiguity and applies in-place edits to eliminate uncertainty without cascading changes across other artifacts.

What is the best way to fix undefined domain terms in feature or spec markdown files?

Fixing undefined domain terms in feature or spec markdown files involves identifying interpretable lines, grounding them with the parent contract, and asking targeted questions to turn vague requirements into explicit decisions encoded directly in the document.

Can I clarify contradictions in my acceptance criteria without altering other project artifacts?

Yes, you can clarify contradictions in acceptance criteria without altering other project artifacts by performing single-artifact ambiguity resolution, which isolates edits to the target file and flags downstream staleness for separate handling.

How do I handle unclear scope boundaries in a DAE methodology plan.md file?

To handle unclear scope boundaries in a DAE methodology plan.md file, load the methodology root and manifest, ground the content with the relevant parent contract, and resolve the boundary ambiguity through bounded multiple-choice or open-ended questions.

Does the clarification process edit multiple files simultaneously when resolving internal contradictions?

No, the clarification process does not edit multiple files simultaneously; it resolves internal contradictions in a single artifact in-place, avoids cross-artifact contradiction handling, and recommends the appropriate next skill to propagate any necessary downstream changes.

Why does resolving a vague requirement in CHARTER.md flag downstream staleness instead of updating all related files?

Resolving a vague requirement in CHARTER.md flags downstream staleness instead of updating all related files to prevent cascading edits, ensuring traceability by isolating changes to one artifact and recommending the correct next skill for propagation.