Repository navigation
Commit 9b9ce37
chore(storybook): Ladle 카탈로그를 Storybook 10으로 교체 (#17)
* refactor(distribution): @wonik/web peer-only token contract — trial 7 dogfood로 ADR-018 #4 supersede (ADR-019)
- packages/web/package.json: dependencies."@wonik/tokens" 제거 → peerDependencies + devDependencies 조합으로 정상화 (토스/MUI/Radix 패턴)
- ppt 0.0.0 → 0.1.0 마이그레이션 trial 7에서 ERR_PNPM_FETCH_404 발견 후 정상화. host install 통과 + Vite HMR 통과 검증
- ADR-019 신설(packaging) + dogfood-trial-7.md 신설(사이클 기록) + .gitignore에 *.tgz 추가
- monorepo dev: web → tokens link는 devDependencies로 보존. sandbox 무영향.
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
* docs: ADR-019 후속 정리 — supersede 마커 + INSTALL/QUICKSTART 갱신
- ADR.md: ADR-018 항목 #4(peer contract)에 ADR-019 supersede 인용박스 추가, "dependency도 유지" 부분 strikethrough
- INSTALL.md: 두 패키지 host 직접 install 필수 강조 박스 (peer-only contract — 토스 TDS / MUI / Radix 표준)
- QUICKSTART.md: 1번 점검에 vendor tarball / published / workspace 3가지 시나리오 분리 명시 + 옵시디언 노트 경로 갱신 (Frontend/ → Design-System/, 노트 3개 모두 명시)
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
* docs: ROADMAP.md 신설 — 단기 액션 + 보류 결정 + 의존성 한 페이지
- 매 turn마다 '다음 뭐 할지' ad-hoc 결정하던 패턴 → ROADMAP을 reference하는 패턴으로 전환
- 5섹션 구조: 현재 위치 / 즉시 액션 / 사용자 결정 보류 / 큰 milestones / 의존성 매트릭스
- PRD.md '1단계 진행 현황' 섹션은 phase history만 남기고 단기 액션은 ROADMAP에 위임. stale "병행 가능" 줄 제거
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
* docs(trial-8): Home.tsx에 Textarea + Button 3개 적용 + ROADMAP에서 Layer B 격하
- dogfood-trial-8.md: ppt Home.tsx GenerationForm의 4 element(Textarea 1 + Button 3, verbosity chip 5 포함) substitution 검증
- 발견 F5: 라인 절감(-18%)보다 결정 절감(색·border·hover·상태 ternary 사라짐)이 본질
- 발견 F6: chip selector는 Button variant 토글로 충분, ToggleGroup atom 보류 (evidence 2/3)
- 발견 F7: host 측 inline px(margin) 잔존 — 후속 cycle로 분리
- ROADMAP: Layer B(사내 registry/Changesets/publish/dual-direction)를 layer A 사이클 마무리 후 마지막 phase로 격하. 사용자 결정 보류 4개→3개, 의존성 매트릭스 9행→5행.
* docs(roadmap): 시각 가독성 + 세부 정보 보강
- 위치 표에 "다음 action" 컬럼 추가
- Layer A atom 14개를 분류 표로 시각화 (레이아웃/액션/입력/상태/로딩/표시)
- 결정 보류 표에 "추천 (왜)" 컬럼 추가
- M1 시각 통일을 step별 시간 견적 표로 (1+5+15+5+5 = 31분)
- M2 evidence 표에 출처 trial 명시
- M3 dogfood 후보에 추정 시간 추가
- cleanup 거리 4개 → 2개로 압축 (Dockerfile은 trial 8에 흡수, PORTFOLIO는 사용자 파일이라 제외)
- trial 1~8 + recapture 누적 history 표 신설
- reference에 핵심 ADR(010, 011, 019) 강조
* docs(trial-9): 시각 정체성 통일 — ppt data-theme="dark" 활성화 + ROADMAP M1 마감
- dogfood-trial-9.md 신설: phase A(1줄 minimal) → contrast 1.7:1 fail → phase B(theme 활성화 + 5 vars 정리)로 격상
- 발견 F9: light/dark dual에서 "변수 N개"가 단위가 아니라 "theme 활성화 + 책임 vars 일괄"이 단위
- 발견 F10: ppt hand-rolled dark vars 5/6 우리 dark tokens과 ~95% 동일 (disposable 손작업)
- 발견 F11: :root vs [data-theme="dark"] specificity 동일 — host overrides 제거 필수
- 발견 F12: --color-primary-hover를 var(--color-primary-selected) alias로 위임 — 마이그레이션 패턴
- 발견 F13: ADR-009 dual mode 약속이 host 활성화로 첫 실증
- ROADMAP: M1 ✅ 마감, 결정 보류 ① 종결, trial history 9건으로 갱신
* docs(trial-10): Outline 재dogfood — Alert/Badge/Card 첫 적용 + evidence-driven cycle 한 바퀴 closure
- dogfood-trial-10.md 신설: trial 4(branch-only, 미머지) 후속 + Outline에 새 atoms 첫 적용
- Outline.tsx 10 element + OutlineCard.tsx 6 element 교체
- Card 4회 적용 (loading/generating/generation/empty wrapper) — trial 4 H3 evidence "Card 4+ 반복" 정확 입증
- Alert 3 instance (Outline 2 + Home 1, 누적 -34줄) — 두 번째 host 페이지에서도 가치 동일
- Badge 첫 외부 적용 (layout indicator) — Phase 14 Badge atom 추가가 trial 10 적용으로 사이클 closure
- 발견 F14: branch dogfood는 main 자동 머지 안 됨 — 패턴 재정의
- 발견 F15-F17: trial 4 H3 예측이 trial 10 적용으로 정확히 매칭, evidence-driven 사이클 첫 입증
- 발견 F18: dashed border / hover-border-highlight polish 손실 — atom 후보 evidence 누적
- ROADMAP: trial 10 history 추가, evidence 표 갱신 (dashed/hover-Card 신규 등록 2/3, 1/3)
* docs(trial-11): Presentation 재dogfood — Alert/Input/Textarea + 보라 anti-pattern 제거 + Layer A 사이클 마감 직전
- dogfood-trial-11.md 신설: trial 6 미완 영역 12 element 일괄 청소
- 발견 F19: AI 수정 button의 hardcoded 보라 #8b5cf6은 host가 우리 status-processed-text 토큰을 모름에서 발생 — token vocabulary 공유 패턴
- 발견 F20: dashed Add Slide evidence 3/3 trigger 도달, 그러나 본질 needs 약함 — 격하 reaffirm
- 발견 F21: EditableField sub-component 1회 substitution × 4 instance — page-level dogfood보다 4배 coverage
- 발견 F22: Spinner child + Button parent 패턴이 raw inline svg 5줄 청소
- 발견 F23: host 측 inline px 누적 4회 — Stack gap 권장 가이드 후보
- ROADMAP: trial 11 history 추가, host page dogfood 컬럼 ✅ 마감, evidence 표 갱신, dashed 격하 reaffirm 표시
* docs: 🏁 Layer A 1차 사이클 마감 선언
- ROADMAP.md:
- 헤더: '🏁 Layer A 1차 사이클 마감 선언 — 11 trial 누적'
- 현재 위치: Layer A 모든 영역 ✅, 다음 큰 단계 = Layer B(회사 PC + IT 협의 대기)
- 새 섹션 '🏁 Layer A 마감 — 얻은 것': 정량(14 atoms × 3 host pages × 11 trials × anti-pattern 2종 제거) + 정성(evidence cycle closure / trigger ≠ atom 추가 / dual mode host 활성화 / token vocabulary 흐름) + 검증된 ADR 6종
- 다음 호흡 simplified: cleanup 3종 + doc 갱신 2종 + (선택) sub-component dogfood
- 새 섹션 '▷ Layer B 진입 준비': ADR-018 6단계 흐름, 진입 신호 대기 명시
- milestone 섹션을 history reference로 격하
- PRD.md:
- 진행 현황 헤더에 'Trial 7~11 closure — 2026-05-15' 추가
- Phase 17 후속 dogfood 사이클 (Trial 7~11) 5줄 요약 추가
- Layer A 1차 사이클 마감 + Layer B 진입 의존 명시
- ppt 측 변경 없음 (선언만)
* feat(trial-12): Layer B publish & adopt 사이클 — 집 시뮬레이션 한 바퀴 (Verdaccio + Changesets)
사용자 통찰("집에 구성을 회사에서 할 수 있는 것처럼 할 수 있잖아? 나 컴퓨터 안 꺼")에서 출발. ADR-018 옵션 A(사내 npm registry) 흐름을 집에서 100% dry run.
8 step 한 바퀴:
1. Verdaccio @ 127.0.0.1:14873 (Windows excluded port range 4866-4965 회피)
2. Changesets 누적 8개 적용 → tokens 0.1.0→0.2.0, web 0.1.0→1.0.0
3. publishConfig.registry → 14873
4. 첫 publish 성공 (peer-only contract 자동 caret 갱신 ^0.2.0)
5. ppt vendor tarball → registry install (3.7초)
6. dual-direction patch: tokens 0.2.0→0.2.1 → ppt pnpm update (1.5초)
7. ADR-018 + ROADMAP + dogfood-trial-12.md
8. (현재) commit
핵심 발견:
- F25 changeset publish 자동 skip (변동 없는 web 1.0.0 자동 제외)
- F26 caret semver가 dual-direction 메커니즘 (1.5초 자동 흐름)
- F27 peer-only contract publish 시도 정합 (ADR-019 입증)
- F28 누적 5 minor → 0.1.0 → 1.0.0 (first stable cut, 받아들임)
결정:
- ADR-018 옵션 A 1순위 reaffirm — 사내 진입 시 URL 2 곳만 교체로 끝
- web 1.0.0 stable cut 받아들임 (14 atoms × 11 trials evidence 정당화)
- web-sandbox 0.0.2 자동 patch (changesets internal dep 추적)
ROADMAP "회사 PC + IT 협의 대기" → "URL만 교체 대기" 갱신.
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
* chore(trial-12 cleanup): .npmrc untrack + F28 changesets bug 추적 보강
token이 commit history에 들어가지 않도록 untrack:
- .npmrc → .gitignore의 기존 패턴이 신규 파일만 ignore했으므로 git rm --cached로 명시 untrack
- .npmrc.example은 이미 존재 (Phase 17 산출물). 사내 진입 시 사용.
- 1 parent d29d10f commit 9b9ce37
38 files changed
Lines changed: 1160 additions & 2103 deletions
File tree
- apps
- ladle
- .ladle
- storybook
- .storybook
- src/stories
- docs
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
11 | | - | |
12 | | - | |
| 11 | + | |
| 12 | + | |
13 | 13 | | |
14 | 14 | | |
15 | 15 | | |
| |||
This file was deleted.
This file was deleted.
This file was deleted.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | | - | |
| 1 | + | |
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | | - | |
| 2 | + | |
3 | 3 | | |
4 | | - | |
| 4 | + | |
5 | 5 | | |
6 | 6 | | |
7 | | - | |
8 | | - | |
| 7 | + | |
| 8 | + | |
9 | 9 | | |
10 | 10 | | |
11 | 11 | | |
| |||
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
17 | | - | |
| 17 | + | |
| 18 | + | |
18 | 19 | | |
19 | 20 | | |
20 | | - | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
21 | 24 | | |
22 | 25 | | |
File renamed without changes.
File renamed without changes.
0 commit comments