task-clarification-harness

Generate a repository-grounded implementation contract with readiness decision and validation plan.

16|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/glaucia86/skills --skill task-clarification-harness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-clarification-harness
Source: https://github.com/glaucia86/skills/tree/main/task-clarification-harness
Command: npx skills add https://github.com/glaucia86/skills --skill task-clarification-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

task-clarification-harness reduces delivery risk by preventing premature coding when a task is ambiguous, underspecified, cross-cutting, or likely to drift without explicit boundaries and validation criteria.

Core Features & Use Cases

  • Repository-grounded clarification: forces an evidence-based pass before any implementation claims, separating confirmed facts from inferences and unknowns.
  • Structured impact and risk mapping: identifies impacted areas, risks, invariants, and scope constraints to keep changes targeted.
  • Validation-ready implementation contract: produces a clarification summary artifact (based on the provided output template) including readiness decision and a concrete validation plan.
  • Use cases: broad feature work, refactors that touch multiple modules, production-hardening tasks, authentication/security changes, and updates likely to affect behavior across the system.

Quick Start

Use task-clarification-harness before implementation to inspect the repo, surface ambiguities and risks, define scope boundaries, and generate a validation-ready implementation contract.

Frequently Asked Questions about task-clarification-harness

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

FAQPage Schema
How do I prevent premature coding when a feature request is too vague to start implementation?

Use a repository-grounded pre-implementation clarification harness to restate ambiguous tasks, inspect available repository evidence, and separate confirmed facts from inferences before writing any code.

What is the best way to define scope boundaries and risks for a cross-cutting refactor?

Defining scope boundaries for a cross-cutting refactor requires structured impact mapping to identify impacted areas, enumerate risks and invariants, and generate a validation-ready implementation contract with acceptance criteria.

How do I create an implementation contract with acceptance criteria for production-readiness work?

To create an implementation contract for production-readiness work, restate the task, inspect repository evidence, enumerate ambiguities, and output a readiness decision alongside a concrete validation plan.

Can I use a human-in-the-loop validation plan for auth-sensitive changes?

Yes, a human-in-the-loop validation plan is ideal for auth-sensitive changes because it forces an evidence-based pass to surface unknowns, define invariants, and set scope constraints before implementation begins.

When do I need a repository-grounded clarification artifact before fixing multi-area bugs?

You need a repository-grounded clarification artifact for multi-area bug fixes when tasks are broad, underspecified, or likely to drift without explicit boundaries and validation criteria to keep changes targeted.

Does a pre-implementation clarification harness work for high-drift feature additions?

Yes, a pre-implementation clarification harness works for high-drift feature additions by requiring a readiness decision that blocks coding until key decisions, risks, and scope boundaries are explicitly defined.