SuperAPI AI Directory

requirements-from-brief

Frontend & websites

View repository

Updated 10-16 00:21

About this skill

Requirements From Brief

Use this skill to translate product intent into requirements before interface solutions are chosen. Requirements describe what the user and system need, not which component to use.

Process

  1. Extract user goals, business goals, constraints, and data/API/auth dependencies.
  2. Write functional requirements as FR-XX: The system shall [action] when [condition] so that [outcome].
  3. Write non-functional requirements for performance, accessibility, responsiveness, browser support, security/privacy, reliability, and internationalization when relevant.
  4. Identify explicit out-of-scope items for v1.
  5. Identify assumptions and open questions.
  6. Recommend acceptance criteria, sitemap, or user-flow mapping as the next step.

Output format

## Requirements

Functional requirements

FR-01: The system shall ... when ... so that ...

Non-functional requirements

NFR-01: ...

Dependencies

  • Data/API:
  • Auth/permissions:
  • Design system:

Out of scope for v1

  • [item]

Assumptions

  • [item]

Open questions

  • [item]

Recommended next step:


## Worked example

## Requirements

### Functional requirements
FR-01: The system shall display the user's last 30 days of activity when the user opens the dashboard so that recent work is reviewable without navigation.
FR-02: The system shall preserve the selected date-range filter in the URL so that the view can be shared and bookmarked.

### Non-functional requirements
NFR-01: Dashboard initial load shall reach LCP under 2.5s on 4G mobile.
NFR-02: All dashboard controls shall be keyboard-reachable and pass WCAG 2.2 AA contrast.

### Dependencies
- Data/API: activity API exists; rate limits undocumented
- Auth/permissions: role-based — admins see all teams
- Design system: none yet

### Out of scope for v1
- Custom report builder, CSV scheduling, mobile push notifications

### Assumptions
- Activity data is stored server-side and queryable by date range

### Open questions
- What happens past 30 days — paginate or summary view?

**Recommended next step:** Sitemap planning for the app shell and dashboard routes.

## Common mistakes to prevent

- Do not write requirements as UI solutions. "Compare 20 items" is a requirement; "show a table" is a possible solution.
- Do not skip NFRs because the user only described features.
- Do not hide auth, permission, or API dependencies inside vague wording.

## Boundaries

- Do not use when the idea is still vague — run `$product-intent-clarifier` first.
- Do not use when requirements exist and the open question is IA — use `$sitemap-planner`.
- Do not write requirements as UI solutions — a table is a solution; comparing items is a requirement.

## Validate before final

- Every FR is testable.
- At least accessibility and responsiveness are considered as NFRs unless clearly irrelevant.
- Unknowns are visible as assumptions or open questions.

## See also

- [Design Engineering guide: Design Requirements](https://frontendguide.dev/docs/design-requirements)