spike(aidd-ui): link the UI system to code and to external design tools
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ó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 35/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ệ
- typescript
- Lĩnh vực
- developer-experience
Hướng nghiên cứu
Start with PR #708, especially 01-system actions 02-map and 08-reconcile, references/authority.md, and aidd-dev:01-plan; also review closed issue #222. Run the proposed approaches against at least one real project and gather evidence for each scope question. Done means a written decision for every question, example mappings for a component and token, scoped follow-up issues, and explicit handling of projects without external design tools or existing code.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Problem
aidd-ui keeps its UI system as agnostic Markdown contracts. Two links are missing, and PR #708 lists them as limitations ("No Figma integration"; the Dev wireframe fallback stays until UI capability can be assumed).
- Design to code. Nothing says which implementation file realises which contract entry.
01-systemrecords canonical source paths per surface, but there is no index a skill can follow from a component or token in the contract to the code that implements it, nor back. Without it, drift between design and code is found by reading, not by checking. - Design tools. Teams already hold their design elsewhere (Claude Design, Figma, Impeccable's own documents) or only in code (legacy projects with no design system). The plugin treats external documents as supporting evidence only (
authority.md), which is sound, but gives no way to bring them in, nor to know that the external source moved since the contract was last aligned.
The constraint: a participant reported that Claude Design talks to Claude Code through an MCP and that this link does not extend to other coding agents (to be verified by the spike). A plugin that depends on it would break AIDD's host-agnostic position.
This came out of a community lab on the plugin: the design-to-code mapping and the external-tool interface were the two points the presenter had no answer to.
Scope
A spike, not an implementation. Answer, with evidence from at least one real project:
- What minimal mapping from a contract entry to its implementation survives any stack? Compare one file per component against a single index file, and what each means for per-component versioning.
- Which part belongs to
aidd-uiand which toaidd-dev(the implementation side owns the code; the contract is agnostic). - What strict input contract does
01-systemneed so that any source (existing code, an external design export, nothing) produces the same contract shape? - How does a contract record where an entry came from and at which version of that source, so a later session can tell it is stale?
- At planning time, when the external source changed, how does the user choose between syncing first and planning against the current contract?
01-system/actions/08-reconcile.mdalready classifies the differences; the question is the trigger and the choice. - Which of the host-agnostic options cost least to keep working across Claude Code, Codex and the other supported hosts.
Acceptance criteria
- A written decision for each scope question, each one backed by a run on a real project, not by reasoning alone.
- A recommended minimal mapping format, with one example for a component and one for a token.
- A list of follow-up implementation issues, each scoped to one skill, with the ones that are not worth doing named as such.
- The decision states what happens for a project with no external design tool, and for one with no existing code.
- No dependency on a single host's native design-to-code link.
Prior art in this repo
- PR #708 (draft):
01-systemactions02-mapand08-reconcile,references/authority.md, "Known limitations". aidd-dev:01-planin PR #708: revalidates UI-system revisions before implementation and stops on drift.- #222 (closed): "ui: design to code" placeholder, never scoped.
Out of scope
- Importing from a specific design tool or shipping its connector: the spike decides whether one is worth building.
- Versioning the whole system per component: noted by the spike, decided only if the mapping format needs it.
- A gate on changes to widely reused surfaces: a separate increment once the mapping gives a reuse count.
- 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