aios-core 2.1.5 → 2.2.0

package/.aios-core/product/checklists/migration-readiness-checklist.md

@@ -0,0 +1,75 @@
+# Migration Readiness Checklist
+
+**Purpose:** Validate system ready for production migration
+**Agent:** Brad (Design System Architect)
+**Phase:** Before migration rollout
+
+---
+
+## FOUNDATION (Phase 1 Ready)
+
+- [ ] Tokens generated (core/semantic/component) and validated
+- [ ] DTCG export created + validator passes
+- [ ] Token coverage >95% with dark mode parity recorded
+- [ ] Tailwind v4 (`@theme`, Oxide benchmarks) configured
+- [ ] Build pipeline configured (CI + lint + visual regression)
+- [ ] No visual regressions in test environment
+
+---
+
+## COMPONENTS (Phase 2 Ready)
+
+- [ ] High-impact components built (Button, Input, Card minimum)
+- [ ] Components adhere to Tailwind+cva patterns, pass quality checklist
+- [ ] Component tests passing (≥85% coverage + jest-axe)
+- [ ] Documentation + Storybook 8 (if using) updated
+- [ ] Shadcn/Radix library bootstrap completed (if adopted)
+
+---
+
+## MIGRATION PLAN
+
+- [ ] 4-phase migration strategy documented
+- [ ] Component mapping created (old → new)
+- [ ] Rollback procedures defined
+- [ ] Timeline realistic for team velocity
+- [ ] Stakeholder approval obtained
+- [ ] Tailwind upgrade + token rollout sequencing communicated
+
+---
+
+## TEAM READINESS
+
+- [ ] Team trained on design system usage
+- [ ] Tailwind v4 + Shadcn guidelines shared (.cursorrules updated)
+- [ ] Migration guide distributed
+- [ ] Support channel established
+- [ ] Code review process updated
+
+---
+
+## RISK MITIGATION
+
+- [ ] Backups created
+- [ ] Feature flags enabled (if using)
+- [ ] Monitoring in place
+- [ ] Rollback tested
+- [ ] Emergency contacts defined
+
+---
+
+## METRICS TRACKING
+
+- [ ] Baseline metrics captured
+- [ ] ROI tracking dashboard ready
+- [ ] Pattern usage monitoring enabled
+- [ ] Velocity metrics defined
+- [ ] Oxide build metrics + CSS bundle size monitored (CI dashboards)
+
+---
+
+**Go/No-Go Decision:**
+[ ] GO - All critical items checked
+[ ] NO-GO - Blockers:_________________
+
+**Approved By:** ________ **Date:** ________

package/.aios-core/product/checklists/pattern-audit-checklist.md

@@ -0,0 +1,88 @@
+# Pattern Audit Checklist
+
+**Purpose:** Validate audit results before consolidation
+**Agent:** Brad (Design System Architect)
+**References:** audit-codebase.md task
+
+---
+
+## SCAN COMPLETENESS
+
+- [ ] All UI file types detected (React, Vue, HTML, CSS)
+- [ ] Scan completed without critical errors
+- [ ] Total file count matches expectations
+- [ ] No permission errors blocking scan
+
+---
+
+## PATTERN DETECTION
+
+### Buttons
+- [ ] Button instances counted accurately
+- [ ] Unique button patterns identified
+- [ ] Redundancy factor calculated (instances / unique)
+- [ ] Most-used buttons captured
+
+### Colors
+- [ ] Hex colors extracted (#RGB, #RRGGBB)
+- [ ] RGB/RGBA colors extracted
+- [ ] Total unique colors counted
+- [ ] Top 10 most-used colors identified
+- [ ] Redundancy factor calculated
+
+### Spacing
+- [ ] Padding values extracted
+- [ ] Margin values extracted
+- [ ] Unique spacing values counted
+
+### Typography
+- [ ] Font families identified
+- [ ] Font sizes extracted
+- [ ] Font weights counted
+
+### Forms
+- [ ] Input elements counted
+- [ ] Form elements counted
+- [ ] Unique patterns identified
+
+---
+
+## OUTPUT VALIDATION
+
+- [ ] pattern-inventory.json generated
+- [ ] JSON is valid and parseable
+- [ ] All pattern types included
+- [ ] Metadata complete (timestamp, scan path, file counts)
+- [ ] .state.yaml created
+- [ ] State file has valid YAML syntax
+- [ ] Phase set to "audit_complete"
+- [ ] Tailwind version/config path captured (if applicable)
+
+---
+
+## METRICS VALIDATION
+
+- [ ] Redundancy factors >1 (indicates duplication)
+- [ ] Pattern counts seem reasonable (not artificially inflated)
+- [ ] No zero counts for major pattern types (unless truly zero)
+
+---
+
+## NEXT STEPS DECISION
+
+**If redundancy factors >3x:**
+- ✅ Proceed to *consolidate
+- Significant pattern reduction opportunity
+
+**If redundancy factors <2x:**
+- ⚠️ Codebase is relatively clean
+- Consider if design system is worth investment
+
+**If colors >50 or buttons >20:**
+- 🚨 Major technical debt
+- Strong candidate for consolidation
+
+---
+
+**Reviewer:** ________ **Date:** ________
+**Audit Quality:** [ ] Excellent [ ] Good [ ] Needs Review