maister:requirements-critic

Analyze requirements with four structured validation checks and interactive reformulation.

40|39|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/Architekt-Jutra/architekt-jutra-code --skill maister-requirements-critic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maister:requirements-critic
Source: https://github.com/Architekt-Jutra/architekt-jutra-code/tree/main/week8/2/requirements-critic
Command: npx skills add https://github.com/Architekt-Jutra/architekt-jutra-code --skill maister-requirements-critic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Poorly written, ambiguous, or incomplete requirements lead to wasted development effort, misaligned deliverables, and code that fails to meet actual business needs. This skill eliminates that risk by systematically identifying flaws in requirements before implementation begins.

Core Features & Use Cases

  • 4-Structured Validation Checks: Applies problem-vs-solution framing analysis, CRUD-disguised-as-domain-logic detection, hidden domain decision signal mapping, and rigid quantifier probing to catch common requirement flaws.
  • Interactive Reformulation: Turns vague status-change-only requirements into clear, testable requirements with explicit observable behavior, concurrency rules, and reversibility logic.
  • Use Case: A product manager can use this skill to review a ticket that says "User clicks Reserve to set status to Reserved" and get a reformulated requirement that specifies the reservation blocks availability for other users, handles concurrent requests, and supports cancellation.

Quick Start

Share your requirements, ticket, or spec with the skill and request a critique to receive identified issues, clarifying questions, and suggested rewrites for each requirement.

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 ambiguous user stories for software development?

To validate ambiguous user stories, you can apply structured checks like problem-vs-solution framing analysis and CRUD-disguised-as-domain-logic detection to identify incomplete requirements and reformulate them into clear, testable specs with explicit observable behavior.

What is CRUD disguised as domain logic in requirements?

CRUD disguised as domain logic occurs when a requirement merely describes a status change, like setting a status to Reserved, without defining observable behavior, concurrency rules, or reversibility, which requires interactive reformulation to clarify the actual domain logic.

How do I reframe vague ticket requirements into testable specs?

You reframe vague ticket requirements by applying interactive reformulation techniques that probe quantifier boundaries and map hidden domain decisions, transforming simple status-change requests into specs detailing concurrency, availability blocking, and cancellation logic.

Can I use requirements critique for business analysis workflows?

Yes, you can use requirements critique for business analysis workflows to ensure business alignment, verify observable behavior, and uncover hidden domain decisions, preventing misaligned development outputs and wasted rework before implementation begins.

What are the limitations of automated ticket review for spec validation?

Automated ticket review for spec validation requires interactive input to map hidden domain decisions and probe rigid quantifier boundaries, meaning it cannot autonomously resolve all ambiguities without human context regarding business alignment and edge case coverage.