Files
boc/docs/design/RFC_DEFINITION_OF_DONE.md
T
Bernt 54255eeae9 docs: RFC-002 Input + Definition of Done + Compliance Matrix update
- RFC_DEFINITION_OF_DONE.md (v1.0, LOCKED):
  - 12 criteria for every RFC component
  - Sign-off roles: Author, Reviewer, Automated, QA
  - Exit criteria: all 12 must pass

- RFC-002: Canonical Input Component:
  - Cognitive Purpose: captures free-form text/numeric data
  - When to Use/NOT Use: clear boundaries vs Select, Switch, Date Picker
  - Interaction Contract: click, type, tab, blur, enter, escape
  - Failure Behaviour: invalid, network, max length, required, disabled
  - Accessibility Contract: label, focus, error, required, screen reader
  - AI Contract: when to choose Input vs alternatives
  - Token Dependencies: 13 tokens (bg, border, text, padding, radius, sizes, states)
  - Layout, Sizes (sm/md/lg), Variants (default/ghost/filled), States (8 states)
  - Keyboard, Touch, Motion (with reduced motion)
  - Anti-Patterns: placeholder as label, validation only on submit, etc.
  - Related Components: Select, Textarea, Search, Form, Label
  - DDR References: DDR-001, DDR-002, DDR-003
  - Acceptance Criteria: 10 checklist items

- COMPLIANCE_MATRIX.md: Input updated to 33% (Governance 🟡, Tokens 🟡,
  Motion 🟡, Accessibility 🟡, AI , QA )

Rationale: Validate RFC-001 template works for different component types.
Definition of Done ensures consistent quality. Compliance Matrix tracks
progress visibly.
2026-07-02 10:38:23 +00:00

2.1 KiB
Raw Blame History

RFC DEFINITION OF DONE

Quality Gate for Every RFC Component

Version 1.0
Status LOCKED
Scope All Tier 1, 2, 3 components

Checklist

# Criterion Requirement Verified By
1 RFC Structure 100% complete per COMPONENT_TEMPLATE.md Self-check + Review
2 Cognitive Purpose Documented — what problem does this solve? Self-check + Review
3 User Expectation Documented — what does the user expect? Self-check + Review
4 Interaction Contract Documented — events, responses, state machine Self-check + Review
5 Failure Behaviour Documented — every failure mode handled Self-check + Review
6 Accessibility Contract Documented — WCAG 2.1 AA compliance Self-check + Review
7 AI Contract Documented — when AI chooses this component Self-check + Review
8 Token Dependencies All tokens listed, no hardcoded values Automated lint
9 Motion Follows Motion System v1, reduced motion included Self-check + Review
10 Anti-Patterns Relevant anti-patterns listed and avoided Self-check + Review
11 Compliance Matrix Updated in same PR Self-check
12 Reference Example Working implementation or Storybook story Implementation

Sign-Off

Role Responsibility
Author Self-check all criteria before requesting review
Reviewer Verify criteria 17, 910
Automated Verify criteria 8 (lint)
QA Verify criterion 12

Exit Criteria

MUST pass all 12 criteria before component is marked "Complete" in Compliance Matrix.

MAY merge with criteria 12 pending if implementation is in separate PR.


ÄNDRINGSHISTORIA

Version Datum Beskrivning
1.0 2026-07-02 Initial Definition of Done for RFC components

STATUS

LOCKED

  • Mindre revideringar: 1.x-serien
  • Brytande ändringar: Kräver Architecture Review, ny major-version (2.0+)