release: v0.11.0

packages/skill/references/presets/dark-instrument.md

@@ -16,7 +16,7 @@
 ## 결정
 
 ### 타이포그래피
-- 산세 + **모노스페이스 병용**. 수치·ID·코드는 반드시 모노
+- 산세를 본문 출발점으로 두고, 정렬이 중요한 수치·ID·코드에는 tabular figure 또는 모노를 검토한다. 모든 수치·ID에 모노가 필수인 것은 아니다.
 - 비율 1.200~1.250. 정보 밀도가 높으므로 위계 차이를 작게
 - 숫자는 **tabular-nums** 를 켜라 (`font-variant-numeric: tabular-nums`). 수치가 흔들리면 계기판이 아니다
 
@@ -26,8 +26,7 @@
 | 수치·코드 | JetBrains Mono, IBM Plex Mono | + Pretendard |
 
 ### 색
-- **순수 검정을 쓰지 마라.** `#0d0d0f`~`#14130f` 대역. 순흑은 대비가 과해 눈이 아프다
-- 텍스트도 순백 금지. `#e8e4dc`~`#e6e6e9`
+- 순수 검정/흰색과 근접색을 모두 후보로 두고, 실제 기기·주변광·장시간 읽기에서 대비와 눈부심을 확인한다. `#0d0d0f`~`#14130f`, `#e8e4dc`~`#e6e6e9`는 출발값 예시다.
 - 표면 단계를 3개로: `--surface`(가장 어두움) / `--surface-raised` / `--line`
 - 강조색은 **밝고 채도 높게, 아주 좁게.** 어두운 배경에서는 작은 면적으로도 충분히 강하다
 - 상태색(성공/경고/오류)을 강조색과 구분해서 정의해라. 여기서는 기능이 우선이다
@@ -49,9 +48,9 @@
 
 ## 흔한 실패
 
-1. **순수 검정 + 순수 흰색** → 눈이 아프고 아마추어
+1. **배경·텍스트 대비를 기기에서 확인하지 않음** → 순수색과 근접색 모두 조건에 따라 눈부심·번짐·브랜드 인상을 만들 수 있다
 2. **네온 보라/파랑 강조** → 슬롭 지문. 어두운 배경일수록 이 함정에 빠지기 쉽다
-3. **다크만 만들고 라이트를 안 만듦** → 토큰으로 짰으면 라이트도 나온다. 다크 전용은 사용자 선택권을 뺏는 것
+3. **테마 결정을 설명하지 않음** → 다크 전용일 수 있지만 대상 환경·브랜드·접근성·운영 이유를 기록하고, 지원하는 테마는 역할 토큰과 실제 상태를 완성한다
 4. **수치에 가변폭 폰트** → 숫자가 흔들려 읽기 어렵다
 5. **대비 미달** → 어두운 배경에서 `--ink-muted` 가 4.5:1 아래로 떨어지기 쉽다. 반드시 측정해라