business-analysis

Clarify business requirements through a forced four-step workflow with spec quality review.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/truongnat/Restly --skill business-analysis-truongnat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: business-analysis
Source: https://github.com/truongnat/Restly/tree/main/.agents/skills/business-analysis
Command: npx skills add https://github.com/truongnat/Restly --skill business-analysis-truongnat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump into design and implementation with vague, unchallenged requirements, leading to rework and missed capabilities. This Skill enforces a structured business analysis workflow that seeds a BUSINESS_ANALYSIS.md template, challenges feasibility and correctness, and produces testable stories, rules, and acceptance criteria before any design or planning begins. ## Core Features & Use Cases - Forced Step Sequence: Four mandatory steps (template seed, frame + spec quality review, stories/rules/AC, self-check) tracked in a step ledger that blocks skipping ahead. - Spec Quality Review: Challenges every request on three axes — feasibility, correctness, and missing capability gaps (e.g., upload without max size or overwrite policy) — with a mandatory stop gate on blocking findings. - Traceable Outputs: Generates user stories, business rules with IDs and confidence levels, and Given/When/Then acceptance criteria mapped back to rules. - Use Case: A stakeholder asks for a file upload feature. The Skill seeds the analysis artifact, flags missing capabilities like MIME allowlist and retry policy as blocking questions, and only after answers writes BR-001 rules and AC-001 criteria, then hands off to basic-design. ## Quick Start Ask the agent to run a business analysis on your feature request, for example: analyze the requirements for adding bulk teacher account import before we start design.

Frequently Asked Questions about business-analysis

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

FAQPage Schema
How do I clarify vague requirements before starting design?▼

Run a structured business analysis that seeds a template, frames the problem and stakeholders, then challenges the spec on feasibility, correctness, and missing capabilities. Only after that review passes do you write user stories, business rules, and acceptance criteria.

What is a spec quality review in requirements analysis?▼

It is a mandatory challenge of the request on three axes: feasibility (can process, systems, data, and timeline support it), correctness (do specs match current reality), and capability gaps (what a feature of this type should normally include but the request omitted).

How do I write testable acceptance criteria?▼

Use the Given/When/Then format and map each criterion to a business rule or user story ID. Avoid vague statements like "works well" or "per spec" — each criterion must describe a concrete precondition, action, and observable result.

When should business analysis stop and ask stakeholders?▼

Stop when feasibility or correctness verdicts are Fail or Unknown and blocking, when any capability gap is marked Blocking=Yes and still open, or when stakeholder authority for a critical rule is unknown. Ask at most three focused questions at a time.

Does business analysis produce technical architecture?▼

No. This workflow explicitly does not produce technical architecture, plans, or task lists. When technical work follows, it hands off to a basic-design skill with a readiness verdict and a list of remaining blockers.