sysdesign-nfr-clarification

Clarify ten non-functional requirements as numeric targets in nfrs.md.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/danilods/matilha-sysdesign-pack --skill sysdesign-nfr-clarification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sysdesign-nfr-clarification
Source: https://github.com/danilods/matilha-sysdesign-pack/tree/main/skills/sysdesign-nfr-clarification
Command: npx skills add https://github.com/danilods/matilha-sysdesign-pack --skill sysdesign-nfr-clarification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill forces explicit clarification of the ten non-functional requirements before starting any system architecture.

Core Features & Use Cases

  • Consolidates NFRs into a single, versioned nfrs.md document.
  • Guides architectural tradeoffs by recording numeric targets for scalability, availability, latency, and consistency.
  • Provides a repeatable discovery workflow to prevent architectural drift during design sessions.

Quick Start

Initialize the NFR collection by running the recommended workflow to capture ten numeric NFRs in nfrs.md.

Frequently Asked Questions about sysdesign-nfr-clarification

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

FAQPage Schema
What are non-functional requirements in system architecture design?

Non-functional requirements (NFRs) define system qualities like scalability, availability, latency, and consistency. Capturing them as numeric targets before architecture design prevents architectural drift and ensures distributed systems meet explicit operational constraints.

How do I clarify non-functional requirements for distributed systems?

To clarify non-functional requirements, run a discovery workflow that captures ten NFRs as numeric targets in a versioned nfrs.md document. This ensures explicit tradeoffs for scalability, availability, and consistency are recorded before designing system topologies.

What's the best way to document system design tradeoffs before architecture?

Documenting system design tradeoffs requires consolidating NFRs into a central, versioned nfrs.md file. By recording numeric targets for fault tolerance, cost, and latency, you create a repeatable governance workflow that guides architectural decisions.

When do I need to define NFRs during the system design process?

You need to define NFRs before starting any system architecture design. Clarifying requirements for security, privacy, accuracy, and complexity beforehand ensures your distributed system topology is built around explicit, measurable operational constraints.

Does this NFR clarification workflow work for complex distributed topologies?

Yes, this NFR clarification workflow is applicable when drafting distributed systems or topologies. It handles advanced architecture complexity by forcing explicit discovery of ten non-functional requirements, ensuring scalability and fault tolerance targets are captured.

Why define numeric targets for scalability and consistency before designing architecture?

Defining numeric targets for scalability and consistency before architecture design prevents architectural drift. It forces explicit tradeoffs across ten non-functional requirements, ensuring the resulting system topology is governed by measurable constraints rather than assumptions.