# 실험 설계 — 커맨드와 가이드

`/exp:design` 이 쓰는 문서들이 여기 모여 있다. 실험을 열 때 읽는다.

**왜 이 커맨드가 있는지**는 `docs/experiments-retrospections/` — 8일간 세션 25개·1,713턴을
실측한 회고와 프레임이 거기 있다. 이 폴더는 그 결론의 실행부다.

## 무엇이 있나

| | 무엇 | 언제 읽나 | 상태 |
|---|---|---|---|
| `figures-guide.md` | **골격 화면** — S1·S4 의 골격과 형식 규칙 | S1·S4 를 그릴 때 | ✅ 범위 축소 |
| `drilldown-checklist.md` | **컴포넌트 규칙** — 검증 화면 + **설계 화면(S2·S3)의 조각 셋** | 실행 뒤 파고드는 화면 · **S2·S3 를 그릴 때도** | ✅ |
| `samples/` | 골격의 참조 구현 | S1·S4 를 새로 짜기 전에 | ⚠ 넷 중 둘 폐기 |
| — | **S2·S3 규격** | 자유 레이아웃. 절 구성과 체크리스트가 커맨드 §S2·§S3 에 | ✅ 커맨드가 원본 |

## 화면이 둘이라는 것

이 폴더에서 가장 헷갈리는 자리다.

```
골격 화면   깔때기 · 지표 표와 3열 판 · 파일 트리 · 영향 표         S1 · S4
            값이 아직 없다. 샘플을 복사해 데이터만 바꾼다        → figures-guide.md

자유 화면   레이아웃 목업 · 구현 명세                             S2 · S3
            더미 값이 든다. 절 구성만 고정, 배치는 매번 자유      → 커맨드 §S2 · §S3

검증 화면   토큰 목록 · 토큰 상세 · 분포 차트 · 컨텐츠 카드        실행 뒤
            값이 있다. 눈으로 파고든다                          → drilldown-checklist.md
```

**셋이 된 이유** — 가운데가 원래 위쪽에 있었는데, 골격이 페이지 구조까지 일반화하는 바람에
두 실험 연속으로 버려졌다(E9). `drilldown-checklist.md` 가 이미
**「페이지 구조는 일반화하지 않는다. 일반화하는 단위는 컴포넌트다」**라고 못박아 둔 것과
정면으로 부딪히고 있었다. 그래서 가운데를 자유로 내리고, **S2 목업은 아래쪽 컴포넌트 규칙을
설계 단계에서 미리 적용한다** — 그것이 E7(설계 축이 결과 화면으로 안 이어짐)을 닫는 길이다.

## 커맨드

```
/exp:design    docs/drafts/<name>.md 를 받아 docs/experiments/<name>/design.md 를 낸다
               게이트 다섯(P0 · S1 · S2 · S3 · S4). 조건부 게이트는 없다
               승인 요청 전에 검사 루프 — 정적 0건 + 검증자 반박 0건, 고침 상한 3
               저장하면 STOP — 구현·실행은 별도 세션이 design.md 를 열고 이어받는다
```

단계마다 무엇을 논의·보여줌·확정하는지는
`docs/experiments-retrospections/exp-design-flow.html`,
대화가 턴마다 어떻게 흐르는지는 같은 폴더의 `exp-design-conversation.html`.