ada-requirements-authoring

Write and review individual SRS requirements while enforcing the boundary between requirements and design.

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/wubing7755/Ada --skill ada-requirements-authoring-wubing7755
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ada-requirements-authoring
Source: https://github.com/wubing7755/Ada/tree/main/skills/software-development/ada-requirements-authoring
Command: npx skills add https://github.com/wubing7755/Ada --skill ada-requirements-authoring-wubing7755

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Requirements documents often leak design-level details — framework names, data structures, CSS mechanisms — making them fragile and hard to verify. This Skill keeps individual requirements at the correct abstraction level by enforcing the WHAT (behavior) versus HOW (implementation) boundary. ## Core Features & Use Cases - Design-Leak Detection: Three self-check questions and a dangerous-vocabulary table flag framework APIs, data structures, DOM terms, and design patterns that signal design content in requirements. - Safe Sentence Patterns: Before/after rewrite examples show how to express behavior, timing, conditions, and observable quality without implementation details. - Legitimate SRS Content Guidance: Clarifies that quantitative thresholds, algorithm-as-behavior rules, external interface contracts (ARIA, JSON export), and standards like BCP 47 belong in an SRS. - Use Case: While drafting a requirement like "system passes a tabId prop via React", apply the up-one-level technique to rewrite it as "the content component shall be able to obtain its tab's identifier and activation state". ## Quick Start Ask the assistant to review this requirement for design-level leakage and rewrite it at the correct abstraction level.

Frequently Asked Questions about ada-requirements-authoring

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

FAQPage Schema
How do I write software requirements without design details?

Describe externally observable behavior rather than internal mechanisms. Apply three self-check questions: does the sentence survive removing framework names, does it hold across frameworks, and does it describe what is observable rather than how it is achieved.

How to review an SRS for design-level leakage?

Scan for framework or library names, CSS mechanisms, browser APIs like localStorage, DOM terminology, data structure annotations like Map<K,V>, and design pattern names. Replace them with natural-language descriptions of behavior and observable outcomes.

Are pixel values and timing thresholds allowed in requirements?

Yes. Quantitative thresholds like a 4px drag threshold, 300ms delay, or 60fps frame rate define user-observable behavior and are legitimate SRS content. They serve as measurable acceptance criteria, not implementation choices.

When should I not use this requirements authoring approach?

Do not use it for full multi-section SRS document authoring, systematic SRS reviews, or large-scale terminology revision. Those scenarios require document-level authoring workflows, structured review methodology, or dedicated revision workflows instead.

Is mentioning ARIA or JSON considered design in an SRS?

No. ARIA roles and JSON export formats are external interface contracts, analogous to REST API definitions, so they belong in requirements. JSON is only problematic when describing internal processing rather than external interfaces.