From 810fa211a542e4baa5b9b5073783398ad03a9bb1 Mon Sep 17 00:00:00 2001 From: art Date: Wed, 1 Jul 2026 12:05:32 +0900 Subject: [PATCH] =?UTF-8?q?docs(dev):=20=EB=8B=A4=EC=A4=91=20UI=20?= =?UTF-8?q?=EC=95=88=20Artifact=20=EC=8B=9C=EA=B0=81=EB=B9=84=EA=B5=90=20?= =?UTF-8?q?=E2=86=92=20AskUserQuestion=20=EC=84=A0=ED=83=9D=20=EC=88=98?= =?UTF-8?q?=EB=A0=B4=20=ED=8C=A8=ED=84=B4=20=EB=93=B1=EC=9E=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit game-detail.jsp 리뷰 레이아웃 세션(20260701-113509)에서 검증된 워크플로우 — 실제 CSS 토큰을 이식한 Artifact 로 후보 N안을 한 화면 비교 제시 → AskUserQuestion 으로 확정 → 그 후에만 소스 반영 — 를 재사용 가능한 긍정 패턴으로 verification-strategies.md 에 기록하고 index.md 목록에 반영. Co-Authored-By: Claude Sonnet 5 Claude-Session: https://claude.ai/code/session_011h6etRXJLx1xdfxmVcHjBg --- docs/development/index.md | 2 +- docs/development/verification-strategies.md | 13 +++++++++++++ 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/development/index.md b/docs/development/index.md index f22c0de..2967e70 100644 --- a/docs/development/index.md +++ b/docs/development/index.md @@ -4,7 +4,7 @@ ## 목록 -- [verification-strategies.md](./verification-strategies.md) — `verification-advisor` 가 읽는 검증 전략 레지스트리 (프로젝트별 `cmd` 를 채워 사용). 설계·테스트 단계 구조적 교훈(SSR 영향맵, fixture 전수 감사, freeze 분류 근거 확인, frontend-design fork 패턴) 포함. +- [verification-strategies.md](./verification-strategies.md) — `verification-advisor` 가 읽는 검증 전략 레지스트리 (프로젝트별 `cmd` 를 채워 사용). 설계·테스트 단계 구조적 교훈(SSR 영향맵, fixture 전수 감사, freeze 분류 근거 확인, frontend-design fork 패턴, 다중 UI 안 Artifact 시각비교→AskUserQuestion 선택 수렴) 포함. - [document-category-classification.md](./document-category-classification.md) — 카테고리 분류 기준 (불필요한 카테고리는 프로젝트에 맞게 정리) - [agent-output-conventions.md](./agent-output-conventions.md) — 에이전트 출력 규약. 사용자 대면 의사결정 제시문엔 압축 비적용(배경+선택지+권장 풀어쓰기), 압축은 내부 산출물 한정 - [git-workflow.md](./git-workflow.md) — 브랜치 분류(메인스트림 vs 비-메인스트림) · 비-메인스트림 브랜치 커밋 표준 승인 · push 명시 요청 한정 · Conventional Commits + `Co-Authored-By` 트레일러 규약. CLAUDE.md '작업 원칙' 커밋 정책의 정본. diff --git a/docs/development/verification-strategies.md b/docs/development/verification-strategies.md index d2c1e8f..fbdc7ce 100644 --- a/docs/development/verification-strategies.md +++ b/docs/development/verification-strategies.md @@ -171,6 +171,19 @@ production-grade UI(SVG·a11y·다중 JS 인터랙션 포함)를 구현할 때, > 근거: W3-2 고도화 세션(20260622) — 육각형 SVG 레이더·6축 radiogroup·C1~C6 를 fork 위임으로 단일 JSP 파일 승격 + L1 43/43 GREEN 유지. +### (긍정 패턴) 다중 UI 안 Artifact 시각비교 → AskUserQuestion 선택 수렴 + +레이아웃·배치처럼 "여러 방식이 다 타당한" UI 결정은, 구현 전에 실제 프로젝트 CSS 토큰(색상·폰트·기존 클래스명)을 그대로 이식한 정적 Artifact(HTML)로 후보 N안을 한 화면에 나란히 렌더해 사용자가 비교하게 하고, `AskUserQuestion` 으로 확정받은 뒤에만 소스에 반영한다. `/task` §5.0 계획가시성 의무를 산문 대신 **눈으로 보는 산출물**로 충족하는 변형. + +절차: +1. 실제 프로젝트 색상/폰트/컴포넌트 클래스를 `grep`/`Read` 로 확인해 Artifact 에 그대로 이식 — 가짜 톤 금지(재현 신뢰도가 선택 신뢰도를 결정). +2. 결정축이 여러 개면(예: "요약 영역" + "카드 영역") 섹션을 분리하고 각 섹션 안에서만 후보를 나열 — 축을 섞으면 조합폭발. +3. 후보에 A/B/C/D 같은 안정적 레터를 부여해 이후 `AskUserQuestion` 옵션 라벨과 1:1 대응 — 참조 혼동 방지. +4. Artifact 자체의 라디오/버튼 선택은 눈요기일 뿐 상태를 orchestrator 로 되돌리지 못한다 — 실제 확정은 반드시 `AskUserQuestion`(같은 레터 옵션)으로 받는다. +5. 확정 전 단계는 소스 변경 0건이므로 verification-advisor/L1 게이트 대상이 아니다 — §9 종료조건 미적용, 세션은 사용자 응답 대기로 열어둔 채 진행. + +> 근거: 세션 20260701-113509 — game-detail.jsp 리뷰 영역(요약 그래프 vs 그래프+범례, 카드 미터바 배치 4안)을 Artifact 로 제시 → `AskUserQuestion` 1회로 즉시 확정(재작업 요청 0) → 반영 커밋 `0c8da40`. + ### 신규 `*Test.java` 는 "(검증)" 소유태그여도 구현 산출물 design 파일 영향맵에서 신규 테스트 파일이 owner 칸에 `(검증)` 으로 표시되더라도, **테스트 작성은 implementation 단계의 산출물**이다. `verification-advisor` 는 테스트를 **실행만** 하며 Write 권한이 없다. `(검증)` 은 "검증 관련 파일"이라는 용도 라벨일 뿐 작성 주체가 아니다. implementation 단계에서 파일 영향맵의 신규 `*Test.java` 를 전수 작성해야 하며, 빠뜨리면 verification 단계에서 시나리오 AC(VP) 가 "미커버"로 떨어진다(테스트가 없으니 실행할 게 없음).