ilandahan/AID / skills/atomic-design
atomic-design
VerifiedBuild an Atomic Design system from design spec style guides - extract tokens, create atoms/molecules/organisms/templates/pages as reusable component libraries. Use when building or extending a design system or component library.
| File | Kind | Size |
|---|---|---|
| SKILL.extended.md | markdown | 14.6 KB |
| SKILL.md | skill md | 6.0 KB |
| references/atomic-hierarchy.extended.md | markdown | 15.5 KB |
| references/atomic-hierarchy.md | markdown | 4.2 KB |
| references/component-templates.extended.md | markdown | 23.0 KB |
| references/component-templates.md | markdown | 7.8 KB |
| references/design-deviation-rules.extended.md | markdown | 12.1 KB |
| references/design-deviation-rules.md | markdown | 3.5 KB |
| references/responsive-patterns.extended.md | markdown | 14.3 KB |
| references/responsive-patterns.md | markdown | 4.6 KB |
| tokens/breakpoints.json | config | 659 B |
| tokens/colors.json | config | 1.6 KB |
| tokens/components.json | config | 3.1 KB |
| tokens/spacing.json | config | 1.4 KB |
| tokens/typography.json | config | 1.8 KB |
references/design-deviation-rules.extended.md
View on GitHub# Design Deviation Rules - Zero Tolerance Policy
## ๐ซ ืืืื ืืืช ืืคืก ืกืืืืช
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
โ โ NO CREATIVE FREEDOM IN IMPLEMENTATION โ
โ โ
โ ืืืคืชื ืืื ืื ืืขืฆื. โ
โ ืชืคืงืื ืืืคืชื ืืื ืืชืจืื ืืช ืืขืืฆืื ืืงืื - ืื ืืฉืคืจ ืืืชื. โ
โ โ
โ "ืื ื ืืืฉื ืฉืื ืืืจืื ืืืชืจ ืืื ืืื" = โ FORBIDDEN โ
โ "design spec ืืจืื X, ืื ืืงืื ืืืื X" = โ
CORRECT โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
---
## ืกืืื ืกืืืืช ืืกืืจืืช
### 1. ืกืืืืช "ืืกืชืืืืช"
| ืคืขืืื ืืกืืจื | ืืืืื | ืืื ืืกืืจ |
|-------------|-------|----------|
| ืฉืื ืื ืฆืืขืื | `#3B82F6` โ `#3F85F7` | ืืืขืฆื ืืืจ ืืฆืืข ืกืคืฆืืคื ืืกืืื |
| ืขืืืื ืขืจืืื | `13px` โ `12px` | "ื ืื ืืืชืจ" ืื ืจืืืื ืื |
| ืืืกืคืช ืืคืงืืื | ืืืกืคืช shadow ืฉืื ืงืืื | ืื ืืืืื ืขืืฆืืืืช |
| ืฉืื ืื fonts | Inter โ System fonts | ืคืืืข ืืืืืช ืืืืชื |
| ืฉืื ืื spacing | `24px` โ `20px` | ืืฉืืฉ ืืช ืืจืืชืืืก ืืืืืืืื |
### 2. ืกืืืืช "ืืื ืืืช"
| ืคืขืืื ืืกืืจื | ืืืืื | ืืคืชืจืื ืื ืืื |
|-------------|-------|--------------|
| "ืืืคืืืืืืฆืื" ืฉื ืขืจืืื | ืฉืืืืฉ ื-rem ืืืงืื px ืืฉืืืขืฆื ืฆืืื px | ืฉืื ืืช ืืืขืฆื ืืืื ืืืืื ืืืขืืคืช |
| "ืกืื ืืจืืืืฆืื" | ืฉืื ืื font-weight 450 ื-500 | ืืืืง ืื ืืคืื ื ืชืืื ื-450 |
| "ืชืืงืื" inconsistencies | ืืืฉืืจ padding ืื ืืืื | ืืืื ืืืขืฆื - ืื ืชืชืงื ืืื |
### 3. ืกืืืืช "responsive"
| ืคืขืืื ืืกืืจื | ืืืืื | ืืคืชืจืื ืื ืืื |
|-------------|-------|--------------|
| ืืืฆืืช breakpoints | ืืืกืคืช breakpoint ื-480px | ืืืืง ืืืื breakpoints ืืืืืจืื ื-design spec |
| "ืืชืืืืช ืืืืื ืืืช" | ืืงืื ืช padding ืืืืืืื | ืืืฅ ืขืจืืื ื-design spec Mobile frame |
| ืฉืื ืื layout | ืฉืื ืื ื-grid ื-flex | ืืืฉ ืืช ื-layout ืืคื ืฉื ืจืื ื-design spec |
---
## ืชืืืื ืขืืืื: ืืืฉืจ ืืฉืื "ืื ื ืจืื ื ืืื"
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ WORKFLOW: ืืืฉืจ ื ืจืื ืื ืฉืืฉืื "ืฉืืื" ื-design spec โ
โ โ
โ 1. STOP - ืื ืชืฉื ื ืฉืื ืืืจ โ
โ โ โ
โ โผ โ
โ 2. DOCUMENT - ืฆืื ืืช ืื ืฉื ืจืื ืื ืืขืืืชื โ
โ โ โ
โ โผ โ
โ 3. ASK - ืฉืื ืืช ืืืขืฆื โ
โ โ "ืฉืืชื ืื ืฉื-[frame] ื-padding ืืื 13px. โ
โ โ ืื ืืืืื ืื ืฆืจืื ืืืืืช 12px?" โ
โ โ โ
โ โผ โ
โ 4. WAIT - ืืืชื ืืชืฉืืื ืืคื ื ืฉืืืฉืื โ
โ โ โ
โ โผ โ
โ 5. IMPLEMENT - ืืืฉ ืืคื ืืื ืืื ืฉื ืืืขืฆื โ
โ โ โ
โ โผ โ
โ 6. DOCUMENT - ืชืขื ืืช ืืืืืื ืืงืื ืืืืขืจืืช โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
### ืชืื ืืช ืฉืืื ืืืขืฆื
```markdown
## Design Clarification Request
**Component:** [Button/Primary]
**design spec Frame:** [link]
**Property:** padding-top
**Current Value:** 13px
**Expected Value (Grid-aligned):** 12px
**Question:**
ืืื ื-13px ืืืืื ืื ืฉืืืืืจ ืืืขืืช?
ืื ืืืืื - ืืืืื ืฉืืืืงื ืืืื 13px.
ืื ืืขืืช - ืืขืืื ืืช ืืงืื ืืืจื ืฉืชืชืงื ื-design spec.
**Screenshot:** [attached]
```
---
## Exception Handling - ืืชื ืืืชืจ ืืืจืื?
### ืืชืฉืืื ืืงืฆืจื: ืืืขื ืืฃ ืคืขื
### ืืืจืืืื ืืืืืืื ืืืืชืจืื:
#### 1. Bug ืืื ื ืืคืืืคืืจืื
```css
/* design spec shows: backdrop-filter: blur(10px) */
/* Safari bug: requires -webkit- prefix */
/* โ
ALLOWED - ืชืืกืคืช ืืื ืืช ืื ืืืืืืืืช */
.modal {
backdrop-filter: blur(10px);
-webkit-backdrop-filter: blur(10px); /* Safari support */
}
```
#### 2. Accessibility Override (ื ืืืจ ืืืื)
```css
/* design spec shows: color contrast 3.5:1 */
/* WCAG AA requires: 4.5:1 minimum */
/* โ WRONG - ืืฉื ืืช ืืื */
color: #000; /* "Fixed" contrast */
/* โ
CORRECT - ืืืืื ืืืขืฆื */
/*
* ACCESSIBILITY ISSUE REPORTED
* design spec contrast: 3.5:1
* Required: 4.5:1
* Awaiting designer update
* Jira: DESIGN-123
*/
color: var(--color-text-secondary); /* Current design spec value */
```
#### 3. Missing State ื-design spec
```tsx
/* design spec shows: Button without focus state */
/* โ WRONG - ืืืืฆืื focus state */
&:focus {
outline: 2px solid blue; /* Invented */
}
/* โ
CORRECT - ืืงืฉ ืืืืขืฆื ืืืืกืืฃ */
/*
* TODO: Focus state not defined in design spec
* Requested from designer - Jira: DESIGN-124
* Using browser default until designed
*/
```
---
## Documentation Requirements - ืชืืขืื ืืืื
### ืื ืงืืืคืื ื ืื ืืืืืช ืืืืื:
```tsx
/**
* Button Component
*
* @design-source ./design-spec.md
* @extracted 2024-01-15
* @designer Sarah Cohen
*
* Design Specs:
* - Height: 48px (fixed)
* - Padding: 12px 24px
* - Border-radius: 8px
* - Font: Inter 16px/500
*
* All values extracted from design spec - DO NOT MODIFY without designer approval.
*/
```
### ืืื CSS Module:
```css
/**
* Button Styles
*
* Source: design spec Design System v2.1
* Frame: Components/Button/Primary
* Last synced: 2024-01-15
*
* โ ๏ธ WARNING: All values are from design spec.
* Do not modify without updating design spec first.
*/
.button {
/* From design spec: padding */
padding: 12px 24px; /* design spec: paddingTop/Bottom: 12, paddingLeft/Right: 24 */
/* From design spec: background */
background: var(--color-primary); /* design spec: fill #3B82F6 */
/* From design spec: border-radius */
border-radius: 8px; /* design spec: cornerRadius: 8 */
}
```
---
## Code Review Checklist - ืืืืงื ืืงืื ืจืืื
### ืื ืืืืืง:
```markdown
## Design Fidelity Review
### Pre-merge Checklist:
1. **design spec Link Verification**
- [ ] design spec link exists in component documentation
- [ ] Link is accessible and correct
2. **Value Extraction**
- [ ] All CSS values have design spec source comment
- [ ] No "magic numbers" without source
3. **Token Usage**
- [ ] Uses design tokens (not hardcoded values)
- [ ] Token values match current design spec
4. **Visual Comparison**
- [ ] Screenshot comparison shows match
- [ ] All states verified (hover, active, disabled, focus)
- [ ] Responsive breakpoints verified
5. **No Unauthorized Changes**
- [ ] No "improved" colors
- [ ] No "rounded" values
- [ ] No added effects not in design spec
- [ ] No removed properties from design spec
### Red Flags to Block PR:
โ Hardcoded color: `color: #3B82F6;` instead of `var(--color-primary)`
โ Rounded value: `padding: 12px` when design spec shows `13px`
โ Missing design spec reference
โ "Looks better this way" in commit message
โ Unexplained deviation from design system
```
---
## Consequences of Deviation - ืืฉืืืืช
### ืืื ืืฉืื ืืฉืืืจ ืขื ื ืืื ืืช?
```
1. CONSISTENCY
โโโบ ืื ืกืืืื ืงืื ื ร ืืกืคืจ ืืคืชืืื ร ืืื = ืงืืืก ืืืืืืื
2. TRUST
โโโบ ืืืขืฆื ืฆืจืื ืืกืืื ืฉืื ืฉืืื ืืขืฆื - ืืืคืืข ืืคืจืืืงืฉื
3. MAINTENANCE
โโโบ ืืืฉืจ ืืืื ืืืืฉืื ืืืืืง ื-design spec, ืงื ืืขืืื
4. SCALABILITY
โโโบ ืืขืจืืช ืขืืฆืื ืขืืืืช ืจืง ืืฉืืืื ืืงืคืืืื ืขืืื
```
### ืื ืงืืจื ืืฉืืฉ ืกืืืืช:
```
Developer A: ืฉืื ื padding ื-12px ื-10px ืื "ื ืจืื ืฆืคืืฃ"
Developer B: ืฉืื ื ืืช ืืืชื ืืคืชืืจ ื-14px ืื "ืฆืจืื ืืืชืจ ืืจืืื"
Developer C: ืืฉืืืจ 12px ืืื ื-design spec
ืชืืฆืื: 3 ืืจืกืืืช ืฉืื ืืช ืฉื ืืืชื ืืคืชืืจ ืืืคืืืงืฆืื
```
---
## Summary: The Rules
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
โ THE DEVIATION RULES โ
โ โ
โ 1. ืื ืชืฉื ื - ืืืฉ ืืืืืง ืื ืฉ-design spec ืืจืื โ
โ โ
โ 2. ืื ืชืฉืคืจ - "ืฉืืคืืจืื" ืื ืกืืืืช โ
โ โ
โ 3. ืื ืชื ืืฉ - ืื ืื ืืจืืจ, ืฉืื โ
โ โ
โ 4. ืื ืชืขืื - 13px ืื 13px, ืื 12px โ
โ โ
โ 5. ืื ืชืืกืืฃ - ืื ืื ืื ื-design spec, ืื ืื ืืงืื โ
โ โ
โ 6. ืชืขื - ืื ืขืจื ืฆืจืื ืืงืืจ ื-design spec โ
โ โ
โ 7. ืืืช - ืืืืง ืืืืืืืืช ืืคื ื delivery โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
---
## Quick Reference: What To Do
| ืืฆื | ืคืขืืื |
|-----|-------|
| "ืืขืจื ื ืจืื ืื ืืืืจ" | ืฉืื ืืช ืืืขืฆื |
| "ืื ื ืืืฉื ืฉืื ืืืจืื ืืืชืจ ืืื" | ืื ืจืืืื ืื - ืืืฉ ื-design spec |
| "ืืืขืฆื ืืขื" | ืืืื - ืื ืชืชืงื ืืื |
| "ืืกืจ state ื-design spec" | ืืงืฉ ืืืืขืฆื ืืืืกืืฃ |
| "ืื ืืืื ืืืื ืขืจื ืืงืืช" | ืฉืื ืืช ืืืขืฆื |
| "ืจืืฆื ืืฉื ืืช ืืฉืื" | ืคืชื ืืงืฉื ืืืขืฆื ืืขืืื ื-design spec ืงืืื |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |