--- id: FE-ARCH-ATOMIC-001 category: "10_Wiki/๐Ÿ’ก Topics/AI" confidence_score: 1.0 tags: [atomic-design, design-system, architecture, react, component-driven, modularity, scalability] last_reinforced: 2026-04-26 --- # Atomic Design System Architecture (์•„ํ† ๋ฏน ๋””์ž์ธ ์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜) ## ๐Ÿ“Œ ํ•œ ์ค„ ํ†ต์ฐฐ (The Karpathy Summary) > "์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ์ชผ๊ฐค ์ˆ˜ ์—†๋Š” ์ตœ์†Œ ๋‹จ์œ„(Atoms)๋ถ€ํ„ฐ ๊ฑฐ๋Œ€ํ•œ ์œ ๊ธฐ์ฒด(Organisms)๊นŒ์ง€ ๋‹จ๊ณ„๋ณ„๋กœ ์กฐ๋ฆฝํ•˜์—ฌ, ์ผ๊ด€์„ฑ๊ณผ ์žฌ์‚ฌ์šฉ์„ฑ์ด๋ผ๋Š” ๋‘ ๊ฐœ์˜ ๊ธฐ๋‘ฅ ์œ„์— ๋ฌดํ•œํžˆ ํ™•์žฅ ๊ฐ€๋Šฅํ•œ UI ์ƒํƒœ๊ณ„๋ฅผ ๊ตฌ์ถ•ํ•˜๋ผ" โ€” ๋ธŒ๋ž˜๋“œ ํ”„๋กœ์ŠคํŠธ์˜ ์•„ํ† ๋ฏน ๋””์ž์ธ์„ ํ˜„๋Œ€์  ํ”„๋ŸฐํŠธ์—”๋“œ ํ™˜๊ฒฝ์œผ๋กœ ์žฌํ•ด์„ํ•œ ์„ค๊ณ„๋ก . ## ๐Ÿ“– ๊ตฌ์กฐํ™”๋œ ์ง€์‹ (Synthesized Content) - **์ถ”์ถœ๋œ ํŒจํ„ด:** "Hierarchical Component Composition" โ€” UI ์š”์†Œ๋ฅผ ๋ณต์žก๋„์— ๋”ฐ๋ผ 5๊ฐ€์ง€ ๊ณ„์ธต(Atoms, Molecules, Organisms, Templates, Pages)์œผ๋กœ ๋ถ„๋ฅ˜ํ•˜๊ณ , ํ•˜์œ„ ๊ณ„์ธต์„ ์กฐํ•ฉํ•˜์—ฌ ์ƒ์œ„ ๊ณ„์ธต์„ ๋งŒ๋“œ๋Š” ํŒจํ„ด. - **๊ณ„์ธต๋ณ„ ์ •์˜:** - **Atoms (์›์ž):** ๋” ์ด์ƒ ์ชผ๊ฐค ์ˆ˜ ์—†๋Š” ๊ธฐ๋ณธ ํƒœ๊ทธ (Button, Input, Label ๋“ฑ). - **Molecules (๋ถ„์ž):** ์›์ž๋“ค์˜ ๊ฒฐํ•ฉ์ฒด๋กœ, ํ•˜๋‚˜์˜ ๊ธฐ๋Šฅ์„ ์ˆ˜ํ–‰ (SearchForm, FieldGroup ๋“ฑ). - **Organisms (์œ ๊ธฐ์ฒด):** ๋ถ„์ž์™€ ์›์ž, ํ˜น์€ ๋‹ค๋ฅธ ์œ ๊ธฐ์ฒด์˜ ๊ฒฐํ•ฉ์œผ๋กœ ๊ตฌ์„ฑ๋œ ๋ณต์žกํ•œ ์„น์…˜ (Header, Sidebar, ProductGrid ๋“ฑ). - **Templates (ํ…œํ”Œ๋ฆฟ):** ๋ฐ์ดํ„ฐ๊ฐ€ ์—†๋Š” ๋ ˆ์ด์•„์›ƒ ์ˆ˜์ค€์˜ ๊ณจ๊ฒฉ. - **Pages (ํŽ˜์ด์ง€):** ์‹ค์ œ ๋ฐ์ดํ„ฐ๊ฐ€ ์ฃผ์ž…๋˜์–ด ์‚ฌ์šฉ์ž์—๊ฒŒ ๋ณด์—ฌ์ง€๋Š” ์ตœ์ข… ๊ฒฐ๊ณผ๋ฌผ. - **์˜์˜:** UI์˜ ํŒŒํŽธํ™”๋ฅผ ๋ฐฉ์ง€ํ•˜๊ณ , ๋””์ž์ธ๊ณผ ์—”์ง€๋‹ˆ์–ด๋ง ๊ฐ„์˜ ๊ณต์šฉ ์–ธ์–ด๋ฅผ ๊ตฌ์ถ•ํ•˜์—ฌ ๊ฐœ๋ฐœ ์†๋„๋ฅผ ํš๊ธฐ์ ์œผ๋กœ ํ–ฅ์ƒ์‹œํ‚ด. ## โš ๏ธ ๋ชจ์ˆœ ๋ฐ ์—…๋ฐ์ดํŠธ (Contradictions & RL Update) - **๊ณผ๊ฑฐ ๋ฐ์ดํ„ฐ์™€์˜ ์ถฉ๋Œ:** ๊ณผ๊ฑฐ์—๋Š” ๋‹จ์ˆœํžˆ ๊ธฐ๋Šฅ๋ณ„๋กœ ์ปดํฌ๋„ŒํŠธ๋ฅผ ๋‚˜๋ˆด์œผ๋‚˜(Shared vs Feature), ํ˜„๋Œ€ ์ •์ฑ…์€ ์•„ํ† ๋ฏน ๋””์ž์ธ์˜ ๊ณ„์ธต ๊ตฌ์กฐ๋ฅผ ํ†ตํ•ด '์ปดํฌ๋„ŒํŠธ์˜ ์ฑ…์ž„ ๋ฒ”์œ„ ์ •์ฑ…'์„ ๋ช…ํ™•ํžˆ ์ •์˜ํ•จ. - **์ •์ฑ… ๋ณ€ํ™”:** Antigravity ํ”„๋กœ์ ํŠธ๋Š” ์•„ํ† ๋ฏน ๋””์ž์ธ์˜ 5๊ณ„์ธต ์ค‘ Atoms์™€ Molecules๋ฅผ ๊ณต์šฉ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋กœ ๋ถ„๋ฆฌํ•˜๊ณ , Organisms ์ด์ƒ์€ ์„œ๋น„์Šค๋ณ„ ๋น„์ฆˆ๋‹ˆ์Šค ๋กœ์ง์„ ํฌํ•จํ•˜๋„๋ก ๊ฒฉ๋ฆฌํ•˜๋Š” 'Atomic-Logic Separation' ์ •์ฑ…์„ ์‹œํ–‰ํ•จ. ## ๐Ÿ”— ์ง€์‹ ์—ฐ๊ฒฐ (Graph) - Design-System-Governance, [[Frontend-Architecture-and-Folder-Structure]], Component-Composition-Patterns, [[Uber-Base-Web-Design-System]] - **Raw Source:** 00_Raw/Atomic Design.md