dev-clarify

Ask targeted questions to clarify integration points and edge cases.

19|5|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/edwinhu/workflows --skill dev-clarify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-clarify
Source: https://github.com/edwinhu/workflows/tree/main/lib/skills/dev-clarify
Command: npx skills add https://github.com/edwinhu/workflows --skill dev-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents costly rework by ensuring all ambiguities in requirements and edge cases are resolved through targeted questions before any design or implementation begins.

Core Features & Use Cases

  • Targeted Questioning: Asks specific questions based on code exploration findings.
  • Ambiguity Resolution: Clarifies integration points, edge cases, and behavior choices.
  • TDD Enforcement: Mandates the definition of an automated testing strategy.
  • Use Case: After exploring a codebase for a new feature, you're unsure how to handle an edge case or integrate with an existing authentication system. This Skill prompts you to ask the user for precise answers, documenting them in SPEC.md.

Quick Start

Use the dev-clarify skill to ask targeted questions about the codebase exploration findings.

Frequently Asked Questions about dev-clarify

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

FAQPage Schema
How do I resolve requirements ambiguity before starting software design?

To resolve requirements ambiguity before design, you ask targeted questions about codebase exploration findings to clarify integration points and edge cases, documenting the precise answers to prevent rework.

What is the best way to enforce a TDD testing strategy during requirement clarification?

The best way to enforce a TDD testing strategy during requirement clarification is to mandate the definition of an automated testing strategy before design begins to ensure test-driven development principles are applied.

How do I ask targeted questions about codebase exploration findings for a new feature?

You ask targeted questions about codebase exploration findings by focusing on resolving specific ambiguities in integration points, edge cases, and behavior choices to establish a clear specification before implementation.

When do I need ambiguity resolution in the software development workflow?

You need ambiguity resolution in the software development workflow after exploring a codebase for a new feature but before design begins, specifically when you are unsure how to handle edge cases or integrate with existing systems.

Does requirement clarification help prevent costly rework in TDD?

Requirement clarification prevents costly rework in TDD by resolving all ambiguities in edge cases through targeted questions before design begins, while mandating an automated testing strategy to enforce test-driven principles.

How do I document integration points and behavior choices before coding?

You document integration points and behavior choices by asking targeted questions to resolve ambiguities found during codebase exploration, capturing the clarified specification before moving into the design phase.