- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24) - apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004) - apps/web: React 19 + Vite 8 (ESM) - libs/shared/api-interface: Zod contract base - Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit - WDS artifacts: - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs) - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact) - Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md - AGENTS.md + README.md como entrada para devs/agentes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3.3 KiB
name, description, nextStepFile, outputFile
| name | description | nextStepFile | outputFile |
|---|---|---|---|
| step-02-define-thresholds | Identify NFR categories and thresholds | {skill-root}/steps-c/step-03-gather-evidence.md | {test_artifacts}/nfr-assessment.md |
Step 2: Define NFR Categories & Thresholds
STEP GOAL
Establish the NFR categories to assess and the thresholds used for validation.
MANDATORY EXECUTION RULES
- 📖 Read the entire step file before acting
- ✅ Speak in
{communication_language} - 🚫 Never guess thresholds
EXECUTION PROTOCOLS:
- 🎯 Follow the MANDATORY SEQUENCE exactly
- 💾 Record outputs before proceeding
- 📖 Load the next step only when instructed
CONTEXT BOUNDARIES:
- Available context: config, loaded artifacts, and knowledge fragments
- Focus: this step's goal only
- Limits: do not execute future steps
- Dependencies: prior steps' outputs (if any)
MANDATORY SEQUENCE
CRITICAL: Follow this sequence exactly. Do not skip, reorder, or improvise.
0. Check for Existing Test-Design NFR Plan
Before deriving thresholds from raw documents, check if a test-design output exists with NFR planning:
- Look for
test-design-architecture.md,test-design-qa.md, or any test-design output in{test_artifacts}/that contains an NFR section. - If found, load it as the primary source of NFR categories and thresholds. Use those values directly; do not re-derive them from scratch.
- Only fall back to raw documents (tech-spec, PRD, story) for categories or thresholds that are still missing or marked UNKNOWN in the test-design output.
- If no test-design NFR plan exists, proceed with step 1 using raw documents.
1. Select Categories
Use the ADR Quality Readiness Checklist (8 categories):
- Testability & Automation
- Test Data Strategy
- Scalability & Availability
- Disaster Recovery
- Security
- Monitorability/Debuggability/Manageability
- QoS/QoE
- Deployability
Add any custom_nfr_categories if provided.
2. Define Thresholds
For each category, use thresholds from the test-design NFR plan (step 0) where available. For any remaining UNKNOWN or missing thresholds, extract from:
- tech-spec (primary)
- PRD (secondary)
- story (feature-specific)
If a threshold is still unknown after checking all sources, mark it UNKNOWN and plan to report CONCERNS.
3. Confirm NFR Matrix
List each NFR category with its threshold or UNKNOWN status.
4. Save Progress
Save this step's accumulated work to {outputFile}.
-
If
{outputFile}does not exist (first save), create it using the workflow template (if available) with YAML frontmatter:--- stepsCompleted: ['step-02-define-thresholds'] lastStep: 'step-02-define-thresholds' lastSaved: '{date}' ---Then write this step's output below the frontmatter.
-
If
{outputFile}already exists, update:- Add
'step-02-define-thresholds'tostepsCompletedarray (only if not already present) - Set
lastStep: 'step-02-define-thresholds' - Set
lastSaved: '{date}' - Append this step's output to the appropriate section of the document.
- Add
Load next step: {nextStepFile}
🚨 SYSTEM SUCCESS/FAILURE METRICS:
✅ SUCCESS:
- Step completed in full with required outputs
❌ SYSTEM FAILURE:
- Skipped sequence steps or missing outputs Master Rule: Skipping steps is FORBIDDEN.