feat(aidd-ui): give the UI contract a brand section and agnostic accessibility and adaptation baselines
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 55/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- markdown, typescript
- Lĩnh vực
- design, documentation
Hướng nghiên cứu
Start with plugins/aidd-ui/skills/01-system/assets/system-contract.md, 04-accessibility/references/fragments.md, and 05-adapt/references/fragments.md; read 01-system/references/authority.md for existing ownership guidance. Define the brand ownership decision and technology-agnostic accessibility and adaptation baselines, then update the template and skills so their outputs reflect those requirements. Done means all acceptance criteria pass, including the strict plugin validation and Markdown link check.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Problem
The UI system contract template in PR #708 (plugins/aidd-ui/skills/01-system/assets/system-contract.md) covers foundations (color, type, spacing, shape, depth, motion), surfaces, adaptation, accessibility, assets and deprecations. It has no place for brand identity: logo usage, voice and tone, and the rules that tell a model what the product must sound and look like beyond its tokens. A model generating a screen from the contract can follow every token and still ship an off-brand result.
The two provider skills have the same gap. 04-accessibility and 05-adapt define the shape of their outputs (references/fragments.md: provider, target, scope, evidence, acceptance), but state no baseline to evaluate against. The skill never says which accessibility standard it measures, nor which adaptation conventions it assumes (mobile-first, relative units, breakpoint rules, touch input without hover). Each project would have to reinvent them, and two projects will not get the same verdict on the same screen.
This was raised during a community lab on the plugin: brand is missing from the design contract, and the accessibility and adaptation skills should carry technology-agnostic good practice.
Scope
- Add a brand section to the UI system contract template: logo usage, voice and tone, and where the canonical brand sources live. Optional, removed when empty like the other sections.
- Decide and document who owns brand:
aidd-uithrough the contract, or project memory throughaidd-context.aidd-uitreats memory as read-only, so the default is the contract; state the reason if memory wins. - In
04-accessibility, name the reference standard the skill evaluates against (a recognised one, for example WCAG 2.2 level AA) and the minimum requirement families it checks. - In
05-adapt, state the technology-agnostic baseline: mobile-first, relative units over fixed pixels, breakpoint and layout-primitive conventions, input modality (no hover on touch), content pressure. - Keep both skills free of technology-specific rules (no framework, CSS or toolkit names).
Acceptance criteria
- The contract template has a brand section, and the skill that fills it is named.
- The ownership decision for brand (contract vs project memory) is written in the plugin, with its reason.
-
04-accessibilitystates the standard and level it measures, and a finding cites it. -
05-adaptstates its baseline conventions, and a requirement that follows the baseline reports no system impact. - Neither skill mentions a specific framework, library or design tool.
-
claude plugin validate plugins/aidd-ui --strictandnode scripts/check-markdown-links.jspass.
Prior art in this repo
- PR #708 (draft):
01-system/assets/system-contract.mdhas no brand section;04-accessibility/references/fragments.mdand05-adapt/references/fragments.mddefine output fields only. 01-system/references/authority.md(PR #708): evidence priority between contract, code, memory and external documents.- #192 and #218 to #222 (closed): original plugin scoping and placeholders, no brand or baseline decision.
Out of scope
- Generating logos or other binary brand assets: the plugin contracts asset roles and does not produce binaries (PR #708, "Known limitations").
- Visual identity work for the AI-Driven Dev trainers: a separate task, not a framework change.
- UX methodology (interviews, flows, heuristics): a later increment.
- Ngôn ngữ chính
- TypeScript
- Star
- 481
- Fork
- 45
- Merge trung bình
- 1 ngày 13 giờ
- Pull request đã merge (30 ngày)
- 91
Chuẩn bị môi trường
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của ai-driven-dev/framework
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 86/100
ai-driven-dev/framework#1311 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 79/100
ai-driven-dev/framework#1244 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
ai-driven-dev/framework#1197 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
refactor(aidd-context): apply the new skill template to learnCó thể đã có người làm @blafourcade đã nhận 3 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
ai-driven-dev/framework#1186 · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 83/100
ai-driven-dev/framework#1163 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của ai-driven-dev/framework
Issue tương tự
-
db-d1-sqlite: upsert is aliased to updateOne, so payload.kv.set never inserts new keysCó thể đã có người làm @pcbeingused333 đã nhận hôm nay. Đang mởBug db: d1-sqlite Payload OSS
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
payloadcms/payload#19766 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
device-management-toolkit/sample-web-ui#3711 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug impact:low Team: SecuritySolution Team:Defend Workflows v9.6.0
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
elastic/kibana#306401 · 3 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
agentes-chat/agentes-chat#927 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Closing a pinned tab jumps to the Tabs section instead of the next open pinned tabCó thể đã có người làm @seenimohamed đã nhận hôm nay. Đang mởbug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
ardia-browser/ardia#2769 ·
Maintainer thường phản hồi trong vòng 1 ngày