docs: AI Principles restructured + Compliance Matrix + Platform governance + RFC-001 Button
- AI_DESIGN_PRINCIPLES.md:
- Restructured into 5 parts: A. Decision Process, B. Component Selection,
C. Token Usage, D. Design Review, E. Escalation
- All rules use RFC 2119 normative words (MUST/MUST NOT/SHOULD/MAY)
- Clearer escalation path: when to create DDR, when to flag uncertainty
- COMPLIANCE_MATRIX.md:
- Tracks readiness for all 29 components (Tier 1/2/3)
- 6 dimensions: Governance, Tokens, Motion, Accessibility, AI, QA
- Foundation documents tracked separately
- Button at 82% (reference for others)
- docs/platform/README.md:
- Reserved directory for cross-cutting governance
- Future: AI Governance, Product Governance, Review Process,
Quality Gates, Release Governance, Decision Frameworks
- Separates platform governance from design system
- LANDVEX_DESIGN_SPECIFICATION.md:
- Button renamed to RFC-001: Canonical Button Component
- Structured with: Cognitive Purpose, When to Use/NOT Use,
User Expectation, Interaction Contract, Failure Behaviour,
Accessibility Contract, AI Contract
- Sets standard for all future RFC component specs
Rationale: AI rules before components (AI writes components).
Compliance matrix makes progress visible. Platform governance
separates cross-cutting concerns from design system. RFC format
for components ensures production-ready specifications.
This commit is contained in:
@@ -0,0 +1,101 @@
|
||||
# COMPLIANCE MATRIX
|
||||
|
||||
**Component Readiness Tracking**
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **Version** | 1.0 |
|
||||
| **Status** | DRAFT — Updated as components are specified |
|
||||
|
||||
---
|
||||
|
||||
## Legend
|
||||
|
||||
| Symbol | Meaning |
|
||||
|--------|---------|
|
||||
| ✅ | Complete |
|
||||
| 🟡 | Partial / In Progress |
|
||||
| ⏳ | Not Started |
|
||||
| ❌ | Not Applicable |
|
||||
|
||||
## Tier 1 — Canonical Components
|
||||
|
||||
| Component | Governance | Tokens | Motion | Accessibility | AI | QA | Overall |
|
||||
|-----------|------------|--------|--------|---------------|-----|-----|---------|
|
||||
| Button | ✅ | ✅ | ✅ | 🟡 | ✅ | ⏳ | 82% |
|
||||
| Input | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Select | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Card | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Modal | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Navigation | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Table | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Data Grid | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Search | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Map Panel | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
|
||||
## Tier 2 — Derived Components
|
||||
|
||||
| Component | Governance | Tokens | Motion | Accessibility | AI | QA | Overall |
|
||||
|-----------|------------|--------|--------|---------------|-----|-----|---------|
|
||||
| Badge | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Alert | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Toast | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Tooltip | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Accordion | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Tabs | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Breadcrumb | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Pagination | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Empty State | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Skeleton | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
|
||||
## Tier 3 — Domain Components
|
||||
|
||||
| Component | Governance | Tokens | Motion | Accessibility | AI | QA | Overall |
|
||||
|-----------|------------|--------|--------|---------------|-----|-----|---------|
|
||||
| KPI Card | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Map Overlay Panel | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Layer Selector | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Mission Status | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Dataset Card | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Geospatial Inspector | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Asset Summary | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Coordinate Picker | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
| Timeline Panel | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | 0% |
|
||||
|
||||
## Foundation Documents
|
||||
|
||||
| Document | Status | Completeness |
|
||||
|----------|--------|--------------|
|
||||
| Design Constitution | ✅ | 100% |
|
||||
| Token Philosophy | ✅ | 100% |
|
||||
| Design Specification | 🟡 | 70% |
|
||||
| Component Template | ✅ | 100% |
|
||||
| Component Decision Tree | ✅ | 100% |
|
||||
| AI Design Principles | ✅ | 100% |
|
||||
| Design Anti-Patterns | ✅ | 100% |
|
||||
| Glossary | ✅ | 100% |
|
||||
| Release Definition | 🟡 | 80% |
|
||||
|
||||
---
|
||||
|
||||
## How to Update
|
||||
|
||||
When a component is specified, update this matrix:
|
||||
|
||||
1. Mark completed sections as ✅
|
||||
2. Calculate overall percentage
|
||||
3. Update this file in same PR as component spec
|
||||
|
||||
---
|
||||
|
||||
## ÄNDRINGSHISTORIA
|
||||
|
||||
| Version | Datum | Beskrivning |
|
||||
|---------|-------|-------------|
|
||||
| 1.0 | 2026-07-02 | Initial compliance matrix with all components and foundation documents |
|
||||
|
||||
---
|
||||
|
||||
## STATUS
|
||||
|
||||
**DRAFT — Updated as work progresses**
|
||||
Reference in New Issue
Block a user