Skip to content

feat: diagram-design 스킬로 커버리지 맵 · 하네스 · 타임라인 다이어그램 3종 추가#16

Merged
doyoonear merged 5 commits intomainfrom
feat/diagram-design-integration
Apr 21, 2026
Merged

feat: diagram-design 스킬로 커버리지 맵 · 하네스 · 타임라인 다이어그램 3종 추가#16
doyoonear merged 5 commits intomainfrom
feat/diagram-design-integration

Conversation

@doyoonear
Copy link
Copy Markdown
Collaborator

@doyoonear doyoonear commented Apr 21, 2026

Summary

  • ChapterMap — 소개 페이지 "다룬 범위" 섹션에 35장 커버리지 맵을 추가했어요. 3개 테마로 다룬 20장과 남은 15장을 nested containment로 표현해요. 바로 아래의 중복 테마 표는 제거했어요.
  • HarnessPipeline — README에 새 "퍼블리싱 하네스" 섹션을 넣고 Notion → 6 에이전트 → MDX 흐름을 architecture 다이어그램으로 보여줘요.
  • ProgressTimeline — 대시보드 "진행 타임라인" 표를 가로 타임라인 다이어그램으로 대체했어요. 2~8주차 누적 곡선(4 → 8 → 11 → 13 → 16 → 20장)을 한눈에 볼 수 있어요.

배경

cathrynlavery/diagram-design 스킬의 editorial 디자인 시스템(4px 그리드, target density 4/10, 1–2 focal max, no shadows)을 따라 제작했어요. src/css/custom.css--cc2-* 토큰은 프로젝트 그린(#16A34A)을 accent로, amber(#D97706)를 피드백 루프 강조로 매핑했어요.

영향 범위

  • docs/foundations/, docs/good-code/, docs/growth/는 건드리지 않았어요 — Human-only Zone 해시 검증(scripts/verify-human-only-hash.js)에 영향 없음.
  • 인라인 SVG 컴포넌트는 Docusaurus CSS 변수를 상속해 light/dark 토글에 자동으로 반응해요.
  • static/diagrams/*.svg는 GitHub README용 독립본이에요 — `prefers-color-scheme` 쿼리로 다크 모드에 대응해요.

Test plan

  • `pnpm format:check` 통과
  • `pnpm lint` 통과 (`--max-warnings 0`)
  • `pnpm build` 통과 (Docusaurus 프로덕션 빌드)

커밋 구성

  1. `feat: 커버리지 맵 + 하네스 파이프라인 다이어그램 추가` — 컴포넌트 2종 + SVG 자산 + 토큰 추가
  2. `docs: 소개 페이지 테마 테이블 제거` — `ChapterMap`이 같은 정보를 보여주므로 중복 표 제거
  3. `feat: 대시보드 진행 타임라인 다이어그램 추가` — `ProgressTimeline`으로 표 대체
스크린샷 2026-04-21 오후 9 27 46 스크린샷 2026-04-21 오후 9 25 19 스크린샷 2026-04-21 오후 9 47 36

diagram-design 스킬(cathrynlavery/diagram-design)의 editorial 디자인 시스템을
따라 SVG 다이어그램 2종을 추가했어요.

- `ChapterMap`: 소개 페이지에서 35장 중 20장 커버리지를 3개 테마로 시각화
- `HarnessPipeline`: README에서 6-에이전트 퍼블리싱 하네스 구조를 시각화
- `static/diagrams/*.svg`: GitHub README용 독립 SVG. prefers-color-scheme
  쿼리로 다크 모드에 대응해요.
- `src/css/custom.css`: `--cc2-*` 다이어그램 토큰(light/dark) 추가.
  프로젝트 그린(#16A34A)을 accent로, amber(#D97706)를 피드백 루프 강조로
  매핑했어요.

MDX 인라인 컴포넌트는 Docusaurus CSS 변수를 상속해 light/dark 토글에
자동으로 반응해요.
`ChapterMap` 다이어그램이 같은 정보(3개 테마 × 책 챕터 × 주제)를
공간적으로 표현하므로, 바로 아래 중복되는 테이블은 제거했어요.
`ProgressTimeline` 컴포넌트로 6개 주차의 누적 학습 곡선을
시각화해서 기존 표를 대체했어요.

- 가로 타임라인에 6개 이벤트 노드(2주차 → 8주차)를 실제 주차 간격에
  비례해 배치해요 — 3~4주차는 간격이 2배 더 넓게 표현돼요.
- 각 노드에 주차·파트·챕터·테마가 모두 담겨서 기존 표의 모든 정보를
  한눈에 볼 수 있어요.
- 8주차 노드는 accent-tint로 focal 처리해서 "현재 지점"을 강조했어요.
- 누적 수치(4 → 8 → 11 → 13 → 16 → 20 / 35)는 베이스라인 옆에
  모노 폰트로 노출해요.
노드 텍스트가 박스 경계에 딱 붙어 읽기 어렵던 문제를 고쳤어요.

- `fe-content-enhancer` 128 → 160 (가장 긴 라벨)
- `notion-extractor`·`chapter-editor`·`mdx-writer`·`aggregator`·`voice-validator` 128 → 144
- `docs/*.mdx`·`dashboard` 출력 박스 64 → 88
- 나머지 x 좌표·화살표·피드백 path 모두 새 레이아웃에 맞춰 재배치
노드 이름과 흐름 방향이 이미 정보를 전달하고 있어서 화살표 위의
단계 레이블은 소음에 가까웠어요. 다음 9개 레이블과 배경 마스크를
모두 제거했어요.

- FETCH · 3-ZONE YAML · EDITED YAML · ENHANCED · WRITE
- ALL YAML · DASHBOARD · VALIDATE
- SLOP DETECTED · REWORK

피드백 루프 의미는 amber dashed 화살표 + 레전드로 유지돼요.
@jangwonyoon
Copy link
Copy Markdown
Collaborator

크으 좋네요~~

@doyoonear doyoonear merged commit bb0e459 into main Apr 21, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants