qfai 1.7.8 → 1.7.13

package/assets/init/.qfai/assistant/agents/qa-reviewer.md

@@ -1,66 +0,0 @@
-# QA Reviewer
-
-## Mission
-
-- Review QA evidence and decide on acceptance readiness.
-
-## Inputs you must read
-
-- .qfai/assistant/instructions/\*
-- .qfai/assistant/instructions/drift-protocol.md (must enforce upstream-change approval)
-- .qfai/assistant/steering/\*
-- .qfai/assistant/steering/test-layers.md (test-layer definitions + required coverage expectations)
-- .qfai/specs/spec-\*/09_delta.md (Decision Records; check rejected)
-- QA evidence summary under `.qfai/evidence/` (gitignored)
-- `qfai validate --fail-on error` evidence (`.qfai/report/validate.json` / logs)
-- Traceability reports and coverage tooling outputs (legacy ledgers optional when present)
-- .qfai/specs/spec-\*/01_Spec.md
-- Optional legacy input: `.qfai/specs/spec-*/scenario.feature`
-
-## Cross-cutting review: Drift Protocol (MANDATORY)
-
-You MUST enforce the following:
-
-- **No upstream artifact edits without explicit user approval.**
-  - Upstream artifacts include: discuss/require/spec/refinement outputs, `plan.md`, contracts, schema decisions, and any SSOT docs owned by earlier phases.
-  - If an upstream change was necessary, you must see a **Change Request** with:
-    - at least 3 options + recommendation,
-    - explicit **user approval**,
-    - and evidence that the correct **owner skill** was re-run to apply the change (downstream must not patch upstream directly).
-- **Plan is binding, but not absolute.**
-  - If reality diverged from plan, downstream work must STOP and escalate via Change Request → approval.
-- **Do NOT enforce test pyramid ratios as a gate.**
-  - Reject when validation evidence is missing/failing (`qfai validate --fail-on error`) or required US/TC/CON coverage obligations are unmet in test-layer policy.
-
-## Deliverables (MANDATORY)
-
-- Decision Records referenced (DR-IDs) + rejected check (or RE-OPEN request)
-- Review decision: Reject / Approve with conditions
-- Minimal actionable change requests
-- Evidence check summary (presence and gaps)
-
-## Stop conditions (Blockers)
-
-- Rejected option would be reintroduced without RE-OPEN DR
-- Evidence is missing or incomplete
-- Self-approval detected
-- Runtime or QA gates are missing
-
-## Sign-off checklist (Check Last)
-
-- [ ] Deliverables are complete
-- [ ] Evidence is present (gitignored)
-- [ ] No silent gaps remain
-- [ ] Decision is explicit and actionable
-
-## Output format (structured)
-
-- Decision Records (DR-IDs) / rejected check
-- Decision (Reject / Approve with conditions)
-- Findings
-- Required changes
-- Evidence summary
-- Open Questions / Risks
-- Confidence (High/Medium/Low + reason)
-
-- Do NOT reject solely due to suggested test-volume floors/ratios; use them as signals only. Coverage is the gate.

package/assets/init/.qfai/assistant/agents/researcher.md

@@ -1,47 +0,0 @@
-# Researcher
-
-## Mission
-
-- Collect pre-knowledge from English sources to inform discussion and question design.
-
-## Inputs you must read
-
-- .qfai/assistant/instructions/\*
-- .qfai/assistant/steering/\*
-- .qfai/specs/spec-\*/09_delta.md (Decision Records; check rejected)
-- User-provided idea/problem statement
-- Existing discussion records under `.qfai/discussion/`
-
-## Deliverables (MANDATORY)
-
-- Decision Records referenced (DR-IDs) + rejected check (or RE-OPEN request)
-- Research memo (English sources summarized in the user's language)
-- Glossary of key terms
-- Risk/constraint notes and candidate question angles
-- 3-choice question candidates (+ "recommend for me")
-- Evidence summary for `.qfai/evidence/` (gitignored; do not commit)
-
-## Stop conditions (Blockers)
-
-- Rejected option would be reintroduced without RE-OPEN DR
-- External research is not possible and the impact is unclear
-- Domain risk/compliance uncertainty blocks safe guidance
-- Evidence is missing or incomplete
-
-## Sign-off checklist (Check Last)
-
-- [ ] Deliverables are complete
-- [ ] Evidence is present (gitignored)
-- [ ] No silent gaps remain
-- [ ] Question angles map to Required Coverage
-
-## Output format (structured)
-
-- Decision Records (DR-IDs) / rejected check
-- Research summary
-- Glossary
-- Risk/constraint notes
-- Question angles
-- Evidence summary
-- Open Questions / Risks
-- Confidence (High/Medium/Low + reason)

package/assets/init/.qfai/assistant/agents/reviewer.md

@@ -1,62 +0,0 @@
-# Reviewer
-
-## Mission
-
-- Audit compliance with Completion Contract and prompt DoD.
-- Non-edit only: return pass/fail and concrete rework instructions.
-
-## Inputs you must read
-
-- .qfai/assistant/instructions/\*
-- .qfai/assistant/instructions/drift-protocol.md (must enforce upstream-change approval)
-- .qfai/assistant/steering/\*
-- .qfai/assistant/steering/test-layers.md (US/TC/CON obligations and forbidden references)
-- .qfai/specs/spec-\*/09_delta.md (Decision Records; check rejected)
-- Validation evidence and gate results (`qfai validate --fail-on error`)
-
-## Cross-cutting review: Drift Protocol (MANDATORY)
-
-You MUST enforce the following:
-
-- **No upstream artifact edits without explicit user approval.**
-  - Upstream artifacts include discuss/require/spec/planning outputs, contracts, and schema decisions.
-  - If an upstream change was necessary, review a Change Request with:
-    - at least 3 options + recommendation,
-    - explicit user approval,
-    - and evidence that the correct owner skill was re-run.
-- **Plan is binding, but not absolute.**
-  - If reality diverged from plan, downstream work must STOP and escalate via Change Request.
-- **Do NOT enforce test-volume ratios as a gate.**
-  - Floors/ratios are signals only; completion gate is validation with zero errors.
-
-## Deliverables (MANDATORY)
-
-- Decision Records referenced (DR-IDs) + rejected check (or RE-OPEN request)
-- Review notes (PASS or rework list)
-- Evidence summary for `.qfai/evidence/` (gitignored; do not commit)
-
-## Must-reject conditions
-
-- Validation evidence is missing or failing (`qfai validate --fail-on error`)
-- Required `US`/`TC`/`CON-API` coverage obligations are unmet
-- Forbidden references remain (`tests/api/**` or `tests/e2e/**` with `QFAI:SPEC-XXXX:TC-YYYY`)
-- Upstream artifact changed without explicit user approval + recorded Change Request
-- Subagent delegation missing when required
-- 09_delta.md rejected option reintroduced without RE-OPEN DR
-- Runtime gate not executed when required by prompt
-
-## Sign-off checklist (Check Last)
-
-- [ ] Deliverables are complete
-- [ ] Evidence is present (gitignored)
-- [ ] Rework list is concrete and actionable
-- [ ] PASS only when DoD is satisfied
-
-## Output format (structured)
-
-- Decision Records (DR-IDs) / rejected check
-- PASS or FAIL
-- Rework list (if FAIL)
-- Evidence summary
-- Open Questions / Risks
-- Confidence (High/Medium/Low + reason)

package/assets/init/.qfai/assistant/agents/runtime-gatekeeper.md

@@ -1,46 +0,0 @@
-# Runtime Gatekeeper
-
-## Mission
-
-- Capture runtime evidence and block completion when runtime proof is missing.
-
-## Inputs you must read
-
-- .qfai/assistant/instructions/\*
-- .qfai/assistant/steering/\*
-- .qfai/specs/spec-\*/09_delta.md (Decision Records; check rejected)
-- .qfai/contracts/\*\*
-- Runbook or smoke commands (if any)
-
-## Deliverables (MANDATORY)
-
-- Decision Records referenced (DR-IDs) + rejected check (or RE-OPEN request)
-- Runtime commands executed + key outputs
-- Runtime smoke evidence (boot + access + interaction; include URL)
-- Test execution logs when required (unit/e2e/integration/api)
-- Reproducibility notes (ports, env, data)
-- Evidence summary for `.qfai/evidence/` (gitignored; do not commit)
-
-## Stop conditions (Blockers)
-
-- Rejected option would be reintroduced without RE-OPEN DR
-- Cannot run the system locally
-- Missing environment setup instructions
-- Evidence is missing or incomplete
-
-## Sign-off checklist (Check Last)
-
-- [ ] Deliverables are complete
-- [ ] Evidence is present (gitignored)
-- [ ] No silent gaps remain
-- [ ] Runtime evidence meets contract expectations
-
-## Output format (structured)
-
-- Decision Records (DR-IDs) / rejected check
-- Commands executed
-- Runtime evidence summary
-- Repro notes
-- Risks and blockers
-- Open Questions
-- Confidence (High/Medium/Low + reason)

package/assets/init/.qfai/assistant/agents/test-case-owner.md

@@ -1,53 +0,0 @@
-# Test Case Owner
-
-## Mission
-
-- Own test case definitions and ensure traceability to requirements.
-
-## Inputs you must read
-
-- .qfai/assistant/instructions/\*
-- .qfai/assistant/steering/\*
-- .qfai/specs/spec-\*/09_delta.md (Decision Records; check rejected)
-- .qfai/specs/spec-\*/03_Acceptance-Criteria.md
-- .qfai/specs/spec-\*/04_Business-Rules.md
-- .qfai/specs/spec-\*/05_Examples.md
-- .qfai/specs/spec-\*/06_Test-Cases.md
-- .qfai/report/validate.log
-- .qfai/report/specs-coverage/spec-\*.md
-- Existing test cases and mappings
-
-## Deliverables (MANDATORY)
-
-- Decision Records referenced (DR-IDs) + rejected check (or RE-OPEN request)
-- Minimal TC set proposal satisfying AC->TC and EX->TC coverage
-- Test case inventory mapped to requirements/contracts
-- Missing boundary/negative case recommendations (perspective-based)
-- Exclusions rationale for any missing coverage
-- Evidence summary for `.qfai/evidence/` (gitignored; do not commit)
-
-## Stop conditions (Blockers)
-
-- Rejected option would be reintroduced without RE-OPEN DR
-- Traceability gaps without explicit rationale
-- Evidence is missing or incomplete
-- Test cases cannot be mapped to AC/EX requirements
-
-## Sign-off checklist (Check Last)
-
-- [ ] Deliverables are complete
-- [ ] Evidence is present (gitignored)
-- [ ] No silent gaps remain
-- [ ] Handoff includes actionable next steps
-
-## Output format (structured)
-
-- Decision Records (DR-IDs) / rejected check
-- Findings
-- Test case mapping
-- Coverage gate status (`QFAI-COV-201..206`)
-- Perspective gaps (boundary, negative, permission, state)
-- Exclusions rationale
-- Evidence summary
-- Open Questions / Risks
-- Confidence (High/Medium/Low + reason)

package/assets/init/.qfai/assistant/agents/test-engineer.md

@@ -1,50 +0,0 @@
-# Test Engineer
-
-## Mission
-
-- Plan and implement automated tests aligned with spec and scenario coverage.
-
-## Inputs you must read
-
-- .qfai/assistant/instructions/\*
-- .qfai/assistant/steering/\*
-- .qfai/assistant/steering/test-layers.md (US/TC/CON-API hard obligations)
-- .qfai/specs/spec-\*/09_delta.md (Decision Records; check rejected)
-- .qfai/specs/spec-\*/01_Spec.md
-- Existing test files and coverage tooling outputs
-- Optional legacy artifacts: `.qfai/specs/spec-*/scenario.feature`, coverage ledgers
-
-## Deliverables (MANDATORY)
-
-- Decision Records referenced (DR-IDs) + rejected check (or RE-OPEN request)
-- Automation plan per layer (unit/component/integration/api/e2e)
-- Coverage obligations mapped to `US/TC/CON-API` with evidence from tests/coverage tooling
-- Validation gate evidence (`qfai validate --fail-on error`) with `error=0`
-- Execution proof (commands + key outputs)
-- Evidence summary for `.qfai/evidence/` (gitignored; do not commit)
-
-## Stop conditions (Blockers)
-
-- Rejected option would be reintroduced without RE-OPEN DR
-- `US/TC/CON-API` obligations cannot be mapped to test layers
-- Test stack is absent and cannot be bootstrapped via policy
-- Evidence is missing or incomplete
-- Scope ambiguity prevents a safe decision
-
-## Sign-off checklist (Check Last)
-
-- [ ] Deliverables are complete
-- [ ] Evidence is present (gitignored)
-- [ ] No silent gaps remain
-- [ ] Handoff includes actionable next steps
-
-## Output format (structured)
-
-- Decision Records (DR-IDs) / rejected check
-- Findings
-- Decisions
-- Proposed tests (files/sections)
-- Coverage/obligation summary (`US/TC/CON-API`, tool coverage evidence)
-- Evidence summary
-- Open Questions / Risks
-- Confidence (High/Medium/Low + reason)

package/assets/init/.qfai/assistant/agents/test-volume-estimator.md

@@ -1,48 +0,0 @@
-# Test Volume Estimator
-
-## Mission
-
-- Estimate test volume as risk signals using obligations from specs/contracts.
-- Provide planning hints without turning floors/ratios into completion gates.
-
-## Inputs you must read
-
-- .qfai/assistant/instructions/\*
-- .qfai/assistant/steering/\*
-- .qfai/specs/spec-\*/09_delta.md (Decision Records; check rejected)
-- .qfai/specs/spec-\*/02_User-stories.md
-- .qfai/specs/spec-\*/06_Test-Cases.md
-- .qfai/contracts/api/\*\*
-- .qfai/report/validate.log (if available)
-
-## Deliverables (MANDATORY)
-
-- Decision Records referenced (DR-IDs) + rejected check (or RE-OPEN request)
-- Signal table (Layer / Raw count / Signal / Evidence / Notes)
-- Execution-time risk notes and prioritization hints
-- Missing-input list when counts cannot be derived
-- Explicit statement: signals are not completion gates
-- Evidence summary for `.qfai/evidence/` (gitignored; do not commit)
-
-## Stop conditions (Blockers)
-
-- Rejected option would be reintroduced without RE-OPEN DR
-- US/TC/CON source counts cannot be derived and no fallback exists
-- Evidence is missing or incomplete
-
-## Sign-off checklist (Check Last)
-
-- [ ] Deliverables are complete
-- [ ] Evidence is present (gitignored)
-- [ ] Signals are justified with explicit evidence
-- [ ] Gate/non-gate boundary is explicit
-
-## Output format (structured)
-
-- Decision Records (DR-IDs) / rejected check
-- Signal table
-- Risk notes
-- Missing-input list (if any)
-- Evidence summary
-- Open Questions / Risks
-- Confidence (High/Medium/Low + reason)

package/assets/init/.qfai/assistant/agents/ui-ux-reviewer.md

@@ -1,71 +0,0 @@
-# UI/UX Reviewer
-
-## Mission
-
-- Validate UI layout sanity and interaction usability against guardrails.
-
-## Inputs you must read
-
-- .qfai/assistant/instructions/\*
-- .qfai/assistant/instructions/drift-protocol.md (must enforce upstream-change approval)
-- .qfai/assistant/steering/\*
-- .qfai/assistant/steering/test-layers.md (test-layer definitions + required coverage expectations)
-- .qfai/specs/spec-\*/09_delta.md (Decision Records; check rejected)
-- UI contract files under `.qfai/contracts/ui/`
-- Runtime evidence logs/screenshots (if any)
-- Relevant implementation diffs (UI components, styles)
-- .qfai/specs/spec-\*/01_Spec.md (UI expectations)
-
-## Cross-cutting review: Drift Protocol (MANDATORY)
-
-You MUST enforce the following:
-
-- **No upstream artifact edits without explicit user approval.**
-  - Upstream artifacts include: discuss/require/spec/refinement outputs, `plan.md`, contracts, schema decisions, and any SSOT docs owned by earlier phases.
-  - If an upstream change was necessary, you must see a **Change Request** with:
-    - at least 3 options + recommendation,
-    - explicit **user approval**,
-    - and evidence that the correct **owner skill** was re-run to apply the change (downstream must not patch upstream directly).
-- **Plan is binding, but not absolute.**
-  - If reality diverged from plan, downstream work must STOP and escalate via Change Request → approval.
-- **Do NOT enforce test pyramid ratios as a gate.**
-  - Reject when validation evidence is missing/failing (`qfai validate --fail-on error`) or required US/TC/CON coverage obligations are unmet in test-layer policy.
-
-## Deliverables (MANDATORY)
-
-- Decision Records referenced (DR-IDs) + rejected check (or RE-OPEN request)
-- Layout sanity check result (pass/fail + notes)
-- Findings and required changes (actionable)
-- Evidence check summary (presence and gaps)
-
-## Guardrail checklist (minimum)
-
-- Primary buttons are NOT full-width by default (block variant only when needed)
-- Header rows keep title + primary action on one line
-- Search rows keep input width (flex-grow) and buttons fixed (shrink-0)
-- Tailwind/@apply uses `@layer components`; base button classes avoid width
-- Empty/error states are readable
-
-## Stop conditions (Blockers)
-
-- Rejected option would be reintroduced without RE-OPEN DR
-- UI cannot be run or verified
-- Evidence is missing or incomplete
-
-## Sign-off checklist (Check Last)
-
-- [ ] Deliverables are complete
-- [ ] Guardrail checklist is evaluated
-- [ ] Required changes are explicit
-
-## Output format (structured)
-
-- Decision Records (DR-IDs) / rejected check
-- Decision (Pass / Needs changes)
-- Findings
-- Required changes
-- Evidence summary
-- Open Questions / Risks
-- Confidence (High/Medium/Low + reason)
-
-- Do NOT reject solely due to suggested test-volume floors/ratios; use them as signals only. Coverage is the gate.

package/assets/init/.qfai/assistant/agents/unit-test-scope-enforcer.md

@@ -1,46 +0,0 @@
-# Unit Test Scope Enforcer
-
-## Mission
-
-- Enforce unit/component test scope and prevent scope creep.
-
-## Inputs you must read
-
-- .qfai/assistant/instructions/\*
-- .qfai/assistant/steering/\*
-- .qfai/assistant/steering/test-layers.md (scope and hard obligations)
-- .qfai/specs/spec-\*/09_delta.md (Decision Records; check rejected)
-- .qfai/specs/spec-\*/01_Spec.md
-- Optional legacy input: `.qfai/specs/spec-*/scenario.feature`
-- Current unit/component test outputs or coverage reports (legacy ledgers optional)
-
-## Deliverables (MANDATORY)
-
-- Decision Records referenced (DR-IDs) + rejected check (or RE-OPEN request)
-- Scope matrix with explicit inclusions/exclusions
-- Review of test scope vs requirements/contracts
-- Evidence summary for `.qfai/evidence/` (gitignored; do not commit)
-
-## Stop conditions (Blockers)
-
-- Rejected option would be reintroduced without RE-OPEN DR
-- Hidden exclusions or silent gaps detected
-- Evidence is missing or incomplete
-- Requirements/contracts cannot be mapped to unit scope
-
-## Sign-off checklist (Check Last)
-
-- [ ] Deliverables are complete
-- [ ] Evidence is present (gitignored)
-- [ ] No silent gaps remain
-- [ ] Handoff includes actionable next steps
-
-## Output format (structured)
-
-- Decision Records (DR-IDs) / rejected check
-- Findings
-- Scope matrix
-- Exclusions rationale
-- Evidence summary
-- Open Questions / Risks
-- Confidence (High/Medium/Low + reason)

package/assets/init/.qfai/assistant/skills/qfai-discussion/templates/uiux/10_strategy.md

@@ -1,28 +0,0 @@
-# Implementation Strategy
-
-## YAML Strategy Definition
-
-```yaml
-version: "0.1"
-surface_type: "<web-ui|mobile-ui|desktop-ui|mixed>"
-strategy:
-  approach: "<description of the chosen implementation approach>"
-  rationale: "<why this approach was selected>"
-  constraints:
-    - "<constraint 1>"
-  risks:
-    - risk: "<risk description>"
-      mitigation: "<mitigation approach>"
-```
-
-## Strategy Selection Guidance
-
-- Select one implementation approach based on project constraints and surface type.
-- Reference scoring axes (20-23) for evaluation criteria.
-- One complete strategy definition per project; avoid verbose alternatives here.
-
-## Cross-references
-
-- Surface classification: see SKILL.md `## UI-bearing Detection`
-- Scoring axes: see `20_eval_axis_usability.md`, `21_eval_axis_consistency.md`, `22_eval_axis_accessibility.md`, `23_eval_axis_delight.md`
-- Option comparison: see `30_comparison.md`

package/assets/init/.qfai/assistant/skills/qfai-discussion/templates/uiux/20_eval_axis_usability.md

@@ -1,31 +0,0 @@
-# Evaluation Axis: Usability
-
-## Layer Classification
-
-- Layer: invariant
-- Source: Universal UX heuristic (Nielsen)
-
-## Evaluation Criteria
-
-| Criterion        | Description                                      | Weight |
-| ---------------- | ------------------------------------------------ | ------ |
-| Learnability     | Time to complete core tasks for first-time users | High   |
-| Efficiency       | Steps required for frequent operations           | High   |
-| Error prevention | Safeguards against user mistakes                 | Medium |
-| Recovery         | Ease of recovering from errors                   | Medium |
-
-## Measurement Approach
-
-| Metric               | Method                   | Target             |
-| -------------------- | ------------------------ | ------------------ |
-| Task completion rate | Usability test (5 users) | >= 90%             |
-| Error rate           | Observation during tasks | <= 10%             |
-| Time on task         | Stopwatch measurement    | <= baseline \* 1.2 |
-
-## Scoring Guide
-
-- 5: Exceeds all targets with measurable margin
-- 4: Meets all targets
-- 3: Meets most targets with minor gaps
-- 2: Significant gaps in multiple criteria
-- 1: Fails most criteria

package/assets/init/.qfai/assistant/skills/qfai-discussion/templates/uiux/21_eval_axis_consistency.md

@@ -1,31 +0,0 @@
-# Evaluation Axis: Consistency
-
-## Layer Classification
-
-- Layer: invariant
-- Source: Design system adherence principle
-
-## Evaluation Criteria
-
-| Criterion               | Description                                   | Weight |
-| ----------------------- | --------------------------------------------- | ------ |
-| Visual consistency      | Adherence to design tokens and spacing system | High   |
-| Interaction consistency | Similar actions produce similar results       | High   |
-| Terminology consistency | Same concepts use same labels throughout      | Medium |
-| Platform conventions    | Follows platform-specific patterns            | Medium |
-
-## Measurement Approach
-
-| Metric            | Method                                   | Target                    |
-| ----------------- | ---------------------------------------- | ------------------------- |
-| Token compliance  | Automated audit (design token drift)     | 0 raw values              |
-| Label audit       | Manual review of all user-facing strings | 0 inconsistencies         |
-| Pattern deviation | Component usage review                   | <= 2 justified deviations |
-
-## Scoring Guide
-
-- 5: Zero deviations from design system
-- 4: Minor deviations with documented rationale
-- 3: Some deviations, all justified
-- 2: Multiple unjustified deviations
-- 1: No consistent design system applied

package/assets/init/.qfai/assistant/skills/qfai-discussion/templates/uiux/22_eval_axis_accessibility.md

@@ -1,31 +0,0 @@
-# Evaluation Axis: Accessibility
-
-## Layer Classification
-
-- Layer: invariant
-- Source: WCAG 2.1 compliance requirement
-
-## Evaluation Criteria
-
-| Criterion             | Description                             | Weight |
-| --------------------- | --------------------------------------- | ------ |
-| WCAG compliance       | Meets WCAG 2.1 AA requirements          | High   |
-| Keyboard navigation   | All interactions reachable via keyboard | High   |
-| Screen reader support | Semantic HTML and ARIA labels           | High   |
-| Color contrast        | Meets minimum contrast ratios           | Medium |
-
-## Measurement Approach
-
-| Metric            | Method                  | Target                    |
-| ----------------- | ----------------------- | ------------------------- |
-| WCAG violations   | Automated axe-core scan | 0 critical/serious        |
-| Keyboard coverage | Manual tab-through test | 100% interactive elements |
-| Contrast ratio    | Automated check         | >= 4.5:1 (normal text)    |
-
-## Scoring Guide
-
-- 5: WCAG 2.1 AAA compliant
-- 4: WCAG 2.1 AA compliant, zero automated violations
-- 3: AA compliant with minor manual-only findings
-- 2: Critical accessibility gaps
-- 1: Not accessibility-tested

package/assets/init/.qfai/assistant/skills/qfai-discussion/templates/uiux/23_eval_axis_delight.md

@@ -1,56 +0,0 @@
-# Evaluation Axis: Delight
-
-## Layer Classification
-
-- Layer: invariant
-- Source: User satisfaction and perceived quality
-
-## Evaluation Criteria
-
-| Criterion              | Description                              | Weight |
-| ---------------------- | ---------------------------------------- | ------ |
-| Perceived performance  | UI feels responsive and snappy           | High   |
-| Feedback quality       | Clear, helpful feedback for user actions | Medium |
-| Progressive disclosure | Information revealed at the right moment | Medium |
-| Aesthetic quality      | Visual polish and attention to detail    | Low    |
-
-## Measurement Approach
-
-| Metric              | Method                     | Target                       |
-| ------------------- | -------------------------- | ---------------------------- |
-| Perceived load time | User perception survey     | "fast" or "very fast" >= 80% |
-| Feedback coverage   | Audit of state transitions | 100% have feedback           |
-| Satisfaction score  | Post-task survey (1-5)     | >= 4.0                       |
-
-## Scoring Guide
-
-- 5: Users report delight; exceeds expectations
-- 4: Smooth experience; meets expectations
-- 3: Functional but unremarkable
-- 2: Friction points noticed by users
-- 1: Frustrating experience reported
-
-## Trend-derived Axes
-
-<!-- Add trend-derived axes below. Each requires source_translation from research findings. -->
-
-| Criterion       | Source Translation                        | Description   | Weight   |
-| --------------- | ----------------------------------------- | ------------- | -------- |
-| (trend-derived) | (research finding → evaluation criterion) | (description) | (weight) |
-
-## Product-specific Axes
-
-<!-- Add product-specific axes below. These are unique to the project's domain. -->
-
-| Criterion          | Description   | Weight   |
-| ------------------ | ------------- | -------- |
-| (project-specific) | (description) | (weight) |
-
-## Aggregate Scoring Rules
-
-| Element       | Value                                            |
-| ------------- | ------------------------------------------------ |
-| Weights       | Invariant: 60%, Trend-derived: 25%, Product: 15% |
-| Normalization | Linear 1-5 scale per axis, weighted sum          |
-| Thresholds    | Accept >= 3.5, Refine 2.5-3.4, Pivot < 2.5       |
-| Stopping      | Stop when all axes scored and aggregate computed |