problem-spec

Define problem statements with boundaries and success criteria.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/rolopez23/agent-harness --skill problem-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: problem-spec
Source: https://github.com/rolopez23/agent-harness/tree/main/.claude/skills/problem-spec
Command: npx skills add https://github.com/rolopez23/agent-harness --skill problem-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams articulate the problem upfront, ensuring everyone aligns on the goal, scope, and success criteria before designing a solution.

Core Features & Use Cases

  • Define problem statements with constraints and boundaries.
  • Identify interfaces, actors, triggers, and success metrics for a project.
  • Use Case: When a user presents a vague requirement, the Skill clarifies what needs to be solved.

Quick Start

Provide a concise problem statement for a given feature or task, including boundaries and success metrics.

Frequently Asked Questions about problem-spec

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

FAQPage Schema
How do I define a clear problem statement when requirements are vague?

To define a clear problem statement for vague requirements, articulate the project scope, identify boundaries, and establish concrete acceptance criteria before any design work begins.

What is the best way to align stakeholders on project scope and success metrics?

Aligning stakeholders on project scope requires producing a structured problem definition that explicitly identifies interfaces, actors, triggers, and concrete success metrics.

How do I write acceptance criteria for complex tasks with unclear success boundaries?

Writing acceptance criteria for unclear success boundaries involves defining problem constraints and boundary definitions upfront to ensure the solution scope is measurable and agreed upon.

When should I clarify problem definitions before starting software design?

You should clarify problem definitions before starting software design whenever stakeholders disagree, requirements lack specificity, or success criteria remain ambiguous to prevent misaligned solutions.

Can I use problem specification to identify project actors and triggers?

Yes, problem specification identifies interfaces, actors, and triggers within a project to ensure all participants align on the goal and scope before the design phase starts.

Does problem specification work for complex tasks with conflicting stakeholder requirements?

Problem specification works for conflicting stakeholder requirements by structuring the problem statement with explicit constraints and boundaries, ensuring everyone aligns on the goal before designing a solution.