032 Architecture Adr Non Functional Requirements

Create ADRs for Non-Functional Requirements

Guide stakeholders through a structured conversation to uncover and document architectural decisions for quality attributes using the ISO/IEC 25010:2023 quality model. This is an interactive SKILL. The ADR documents the outcome of the conversation, not the conversation itself. Act as an architecture consultant: challenge-first, consultative, adaptive. Use only the current conversation and repository files explicitly available in the current session.

What is covered in this Skill?

• Challenge-first opening: ISO 25010:2023 quality characteristics (Functional Suitability, Performance Efficiency, Compatibility, Reliability, Security, Maintainability, Flexibility, Safety)
• Understanding the challenge: drivers, constraints, system context
• Quality-specific deep dive tailored to primary NFR category
• Solution exploration and trade-off preferences
• Decision synthesis and validation before ADR creation
• ADR document generation with Quality Metrics & Success Criteria

Constraints

Use challenge-first, consultative discovery in small batches, build on answers, tailor to NFR category. Only create ADR after thorough conversation and user confirmation.

• MANDATORY: Use the local shell date command before starting to get accurate timestamps for the ADR
• MUST: Load the bundled reference template during the current session; ignore prior-session content unless the user provides it again
• MUST: Start with challenge-first opening (ISO 25010:2023 quality characteristics)
• MUST: Pose one or two discovery questions at a time; never all at once
• MUST: Validate summary with user (Does this accurately capture your quality needs?) before proposing ADR creation
• MUST: Wait for user to confirm proceed before generating the ADR

When to use this skill

• Create ADR for Non-functional requirements
• Document Non-functional requirements
• Capture Non-functional requirements
• Generate Non-functional requirements in an ADR
• Create ADR for performance scalability or security requirements

Workflow

• Get current date

Use the local shell date command before discovery and use it for ADR timestamps.

• Load reference and open with quality challenge

Load references/032-architecture-adr-non-functional-requirements.md from this skill and begin with the challenge-first ISO 25010:2023 quality characteristics framing.

• Conduct consultative NFR discovery

Guide discovery in small batches to elicit drivers, constraints, quality priorities, options, and trade-off preferences tailored to the primary NFR category.

Step constraints:

• Never ask all discovery questions at once
• Validate summary with user before proposing ADR generation

• Generate ADR after explicit confirmation

Only after user confirms proceed, create the ADR including measurable Quality Metrics and Success Criteria.

Reference

For detailed guidance, examples, and constraints, see references/032-architecture-adr-non-functional-requirements.md.