maister:requirements-critic

Identify gaps and CRUD-disguised domain logic in software requirements.

Updated May 11, 2026
One-click install
npx skills add https://github.com/rafalwizen/plugin-architecture-test --skill maister-requirements-critic-rafalwizen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maister:requirements-critic
Source: https://github.com/rafalwizen/plugin-architecture-test/tree/main/week8/2/requirements-critic
Command: npx skills add https://github.com/rafalwizen/plugin-architecture-test --skill maister-requirements-critic-rafalwizen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the common issue of poorly written requirements that focus on implementation details instead of business needs, or only describe database status changes without defining observable system behavior, leading to code that functions but fails to deliver actual business value.

Core Features & Use Cases

  • 4-Point Requirement Validation: Applies checks for problem-vs-solution framing, observable behavior vs CRUD status, hidden domain decisions via an extensible signal map, and rigid quantifier edge cases.
  • Interactive Requirement Rebuilding: For requirements that only describe status changes, it asks targeted probing questions to reformulate vague specs into clear, testable user stories with explicit behavior, concurrency rules, and reversibility logic.
  • Use Case: Ideal for product managers, business analysts, and engineering leads reviewing tickets, user stories, or specification documents to catch hidden gaps and assumptions before development begins.

Quick Start

Share your requirements text, user story, or ticket with the requirements-critic skill to get a detailed critique of gaps, hidden assumptions, and a reformulated version of any flawed requirements.

Frequently Asked Questions about maister:requirements-critic

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

FAQPage Schema
How do I validate user stories for hidden domain logic before development?

You can validate user stories by applying a 4-point requirement validation check to detect solution-focused language, CRUD-disguised domain logic, and rigid quantifier edge cases. This process reformulates vague tickets into actionable user stories with explicit observable behavior and concurrency rules.

What is CRUD-disguised domain logic in software requirement analysis?

CRUD-disguised domain logic in requirement analysis occurs when specifications only describe database status changes without defining observable system behavior. Targeted probing questions help rebuild these vague specs into clear, testable user stories with explicit reversibility logic.

How do I refine product tickets into actionable user stories with explicit behavior?

Refining product tickets into actionable user stories requires interactive requirement rebuilding to ask targeted probing questions. This transforms ambiguous specifications into clear, testable user stories featuring explicit observable behavior, concurrency rules, and reversibility logic for cross-functional teams.

Can I use requirement critique for specification documents and business requirement briefs?

Yes, requirement critique works with product tickets, user stories, specification documents, and business requirement briefs. It applies an extensible signal map to find hidden domain decisions and delivers actionable feedback with reformulated user stories for cross-functional software development teams.

What are the limitations of automated requirement validation for edge case handling?

Automated requirement validation focuses on identifying gaps, solution-focused language, and rigid quantifier edge cases, but it relies on the initial text provided. It cannot discover unstated business needs outside the text, requiring human collaboration to answer targeted probing questions for ambiguous requirements.

When do I need to check problem-vs-solution framing in requirement analysis?

Checking problem-vs-solution framing in requirement analysis is needed when tickets focus on implementation details instead of business needs. Applying this validation prevents non-functional implementation by ensuring the requirement defines the actual business value and observable behavior.