@AGENTS.md

# Claude Code 전용 보충

공통 지침은 위에서 가져온 `AGENTS.md`가 단일 출처다. 이 파일에는 Claude Code에서만 동작하는 것만 적는다.

**스킬 트리거:** 패턴(스킬) 추가·수정·재검증 요청 시 `add-skill` 스킬(`.claude/skills/add-skill` → `.agents/skills/add-skill` 심볼릭 링크)을 사용하라. UI 구현·수정에는 `fe-craft`, 데모 사이트 배포 전에는 `fe-predeploy`. 단순 질문은 직접 응답 가능.

**훅(`.claude/settings.json`):** PreToolUse에서 git 변경 명령 차단(`blockGitMutation`, commit·push는 `allowCommitPush` 옵트인 시에만)·시크릿 접근 차단(`blockSecretAccess`)·보호 브랜치 편집 차단(`branchGuard`). Stop에서 검증자 게이트(`verifierGate`)가 build·lint·test·스킬 구조·선택 평가 5종을 실행한다.

**커밋·PR:** 자동으로 하지 않는다. 사용자가 "커밋해줘/PR 올려줘"를 명시했을 때만 `pr` 스킬로 수행한다.

**변경 이력:**
| 날짜 | 변경 내용 | 대상 | 사유 |
|------|----------|------|------|
| 2026-08-19 | 초기 구성 (라이트 티어: add-skill 스킬 + 훅 3종 + PR 옵트인) | 전체 | - |
| 2026-08-20 | 커밋·PR 자동 실행 금지 명시 (사용자 육안 확인 후 직접) | CLAUDE.md | 사용자 지시 — 시각 결과물은 육안 확인이 커밋 게이트 |
| 2026-08-24 | 검증자 게이트(Stop 훅) 상시 등록 — build·lint·test·스킬 구조 4종 | settings.json·hooks·scripts/ | 사용자 승인 루프(docs/loops/goals-verification.md), 턴 종료마다 기계 강제 |
| 2026-08-24 | 플러그인 2개 분리 — plugins/ui(fe-ui)·plugins/system(fe-system), 시스템 스킬은 문서+문답(데모·브라우저 게이트 제외) | 전체 구조·add-skill·validateSkills | 사용자 결정 — UI 외 시스템 설계 스킬 추가(설계 문답 7) |
| 2026-08-25 | 검증자 게이트 maxTokens 400000→20000000 상향 | verifierGate.config.json | 사용자 승인 — 게이트가 세션 누적 transcript 기준으로 판정하므로 루프 1회분 예산이면 장기 세션에서 매 턴 안전장치 발동(08-25 세션 강제 종료 원인) |
| 2026-09-18 | 공통 지침을 AGENTS.md로 분리, CLAUDE.md는 `@AGENTS.md` 가져오기 + Claude 전용만. add-skill을 `.agents/skills/`로 이동(`.claude/skills/`는 심볼릭 링크). 설치 스크립트 추가 | AGENTS.md·CLAUDE.md·.agents/·scripts/install-skills.sh·README | 사용자 결정 — Claude 외 에이전트(Codex·Cursor·Gemini CLI·Copilot)도 사용·기여 가능하게(설계 문답 8) |
| 2026-10-06 | 프로젝트명 fe-skills → suta, 플러그인 fe-ui → suta. 데모 배포 경로를 저장소 이름에서 만들도록 변경(`VITE_BASE`) | 이름·URL 전체·demo·deploy-demo.yml | 사용자 결정 — 설치형 "AI 슬롭 제거" UI 스킬로 성격 전환, 1단계 이름 변경(설계 문답 9) |
| 2026-10-06 | 설계 문답 스킬(fe-system 플러그인 `design`) 완전 제거 — plugins/system·평가 파일·시스템 전용 과거 기록 4개 삭제, 검사·평가·설치 스크립트를 UI 스킬 하나로 단순화 | plugins/system·evals·scripts/·README·AGENTS.md·add-skill·docs | 사용자 결정 — 설치형 UI 스킬로 전환, 2단계(설계 문답 9) |
| 2026-10-06 | 단일 진입 스킬로 재구성 — UI 스킬 53개를 `skills/suta/patterns/{패턴}/PATTERN.md`로 옮기고 진입 스킬 `skills/suta/SKILL.md`(AI 슬롭 금지선 + 자동 생성 카탈로그) 신설. 저장소 루트가 플러그인(source "./"), add-skill은 metadata.internal로 숨김. 트리거 평가(evals/trigger.json)·카탈로그 생성(npm run catalog) 추가 | skills/·scripts/·evals/·demo 경로·README·AGENTS.md·add-skill | 사용자 결정 — impeccable처럼 설치하면 UI 요청에 자동 적용, 3단계(설계 문답 9) |
| 2026-10-07 | 레이아웃 스킬과 편집 후 검사 훅 — 패턴 `layout-principles`·`layout-audit` 추가(53→55), motion-audit의 공통 코어 `auditCore.ts` 분리, 통합 검사 `skills/suta/scripts/audit.mjs`, 편집 후 검사 훅(Claude Code·Codex 매니페스트 인라인), Codex 플러그인 매니페스트, 버전 0.4.0 | skills/·.claude-plugin·.codex-plugin·.agents/plugins·scripts/validateSkills·README·AGENTS.md·docs | 사용자 결정 — error만 돌려보내기, Codex 플러그인 형식까지, PR 1개(설계 문답 10) |
| 2026-10-07 | 화면 유형별 관례와 훅 소음 줄이기 — 앱 화면 1,116장·웹사이트 19곳 분석으로 `layout-principles`에 화면 유형별 관례(references/screen-conventions.md)·넓은 화면 값 추가, 진입 스킬 절차·금지선·값 반영, 편집 후 훅이 이번 편집이 바꾼 줄만 판정, tiny-text 아이콘 글꼴 제외·rem 루트 기준, 데모 ⑥ 메뉴 상세, 버전 0.5.0 | skills/suta·demo·evals·README·docs | 사용자 결정 — 디자인 레퍼런스를 분석해 레이아웃 스킬·훅에 결합(설계 문답 11) |
| 2026-10-07 | README 간결화(314줄 → 73줄) — 설치·소개만 남기고 나머지는 상세 안내(`docs/guide.md`·`guide.en.md`)로 옮김. 패턴 표는 상세 안내에 둔다 | README 2벌·docs/guide·AGENTS.md·add-skill | 사용자 요청 — 텍스트가 많아 읽기 어려움 |
| 2026-10-07 | 데모 사이트를 suta 검사로 점검·개선 — 셸 토큰화·좁은 화면 넘침 수정·모바일 메뉴 접기·조절 막대와 목록 행의 상자 걷기(error 5·warn 96 → 0). motion-audit 오탐(주석·템플릿 문자열) 수정, OTP 칸 320px 대응, 버전 0.5.1 | demo/·motion-audit·otp-input·매니페스트 3개 | 사용자 요청 |
| 2026-10-07 | 퍼블리싱 벤치마크 — 같은 요청 8개를 일반 Claude Code와 suta 설치 Claude Code에 2회씩(32회), 렌더 지표·axe·블라인드 판정으로 비교. README 맨 위에 요약 | scripts/benchmark·evals/benchmark·docs/benchmark(.en).md·README 2벌 | 사용자 요청 |
| 2026-10-07 | 글자·색·면 기준 — 레퍼런스(앱 1,104장·웹 19곳·피드백 사례) 재분석으로 색 역할 토큰 11개·본문 행간 1.5·구역 사이 32/48·띠 8, 진입 스킬 "글자·색·면" 금지선과 톤 단계(근거 없으면 거의 검정), 관례 문서(로그인·설정·장바구니 세부, 대시보드·랜딩), 데모 ⑦·⑧, 벤치마크 2차와 톤 지표, 버전 0.6.0 | skills/suta·demo·evals·scripts/benchmark·docs·README | 사용자 요청 — 벤치마크의 suta 화면이 아직 AI 티가 난다, 레퍼런스 우선 |
| 2026-10-08 | 실사용 점검 — NoodleLens 적용 결과로 색의 수·덜어내기·AI 채팅 관례 추가. 레퍼런스 31곳 1,116장 색 실측(UI 체계 색 2종 이하 81%, 옅은 색 면 13%), SKILL.md 덜어내기 단계·색 금지선, tone.md 색의 수, 화면 유형 14종(AI 채팅), layout-audit `tinted-surface`·`hue-count`, `--color-warning` 제거, 패턴 기본 파랑 제거, 데모 ⑨, 버전 0.7.0 | skills/suta·demo·evals·docs·README | 사용자 요청 — 실제 서비스(NoodleLens)에 적용해 보니 구조가 난잡하고 AI 색이 남았다 |
| 2026-10-08 | 실사용 점검 2 — 모바일 웹뷰 이커머스 화면 7종 + GNB를 suta로 구현해 개선. 새 패턴 `bottom-nav`(55→56), 아이콘 한 벌(`icons.ts`), 관례(하단 탭 바·모바일 웹뷰·커머스), layout-audit 규칙 4개(`emoji-icon`·`viewport-height`·`input-zoom`·`zoom-disabled`), 패턴 기본 파랑·초록 → 거의 검정, `toast-stack.clear()`, `bottom-sheet` 시트 안 버튼 클릭 버그 수정, 버전 0.8.0 | skills/suta·demo·evals·docs·README | 사용자 요청 — 실제 상황을 suta로 구현하며 기능 개선 |
| 2026-10-08 | README 손질 — 맨 위에 AS-IS / TO-BE 비교(같은 요청, suta 없이 vs suta 0.8, 이미지 `docs/assets/as-is-to-be.jpg` + 사진 출처 `docs/assets/CREDITS.md`), AI 슬롭 문장(줄표 이음·굵은 머리말·숫자 없는 평가어) 손질, 배지 무채색 | README 2벌·docs/assets | 사용자 요청 — README의 AI 슬롭 문장을 고치고 suta 효과를 전후 화면으로 보인다 |
| 2026-10-08 | 데모의 이모지를 음식 사진·선 아이콘으로 — Commons CC0·CC BY 사진 18장(`demo/public/photos/`, 각 40KB 이하)과 출처 페이지(`#/credits`), 데모 아이콘을 layout-principles 아이콘 한 벌로(Lucide 5개 추가 → 45개), 데모의 `emoji-icon` 무시 주석 33개와 레지스트리 `emoji` 필드 제거, QuantityStepper 🗑 → 휴지통 선 아이콘, PATTERN.md 예시 4곳, 버전 0.8.1 | demo·skills/suta/patterns(layout-principles·quantity-stepper·cart-fly·card-expand·glass-nav·tooltip)·매니페스트 3개 | 사용자 요청 — 진입 스킬의 "이모지를 아이콘·사진 대신 쓰지 않는다"를 데모 스스로 지키게 |
| 2026-10-08 | 출시 준비(Show GN·Show HN) — 데모 사이드바 위계(밝기·굵기·들여쓰기, 밝은 테마는 시도 후 사용자 확인으로 예전 색 유지), 데모 안 문구 한국어·영어 두 벌(`defineCopy`, 회귀 테스트 `demoCopy.test.tsx`), 패턴 9종 낭독 문구 prop·접근성 고침(select·long-press-menu·range-slider·pull-to-refresh), README 사실 정정(실행 횟수·판정)·동작 방식·한계 절, guide·benchmark 문장 손질, 매니페스트 설명 영어, PR #40(사진·아이콘)과 합치며 공용 메뉴 데이터에 영어 이름, 버전 0.9.0 | demo·skills/suta/patterns·README 2벌·docs·매니페스트·AGENTS.md·add-skill | 사용자 요청 — 긱뉴스·해커뉴스 게시 전 README·데모 점검, 사이드바 제목·항목 구분 |
| 2026-10-09 | 실사용 점검 3 — 증권 플랫폼 웹사이트(화면 7개 + GNB, 데스크톱 중심)를 일반 4번·suta 0.9 2번·suta 0.10 2번 만들어 비교, 증권 웹 10곳·앱 화면 55장 레퍼런스. 등락 색 토큰(`--color-rise`·`--color-fall`)과 tone.md 예외, `hue-count`가 등락 색 변수를 따로 셈, 화면 관례 "증권·투자" 절, SKILL.md 금지선·값·체크리스트, 아이콘 채움의 안쪽 선(`--icon-cutout`), README AS-IS/TO-BE에 데스크톱 증권 웹 비교, 버전 0.10.0. 블라인드 판정 23:5·24:4 | skills/suta·demo/src/tests·evals·docs·README 2벌·docs/assets·매니페스트 | 사용자 요청 — 증권 플랫폼 웹사이트로 벤치마크(측정 → 개선 → 재측정) |
| 2026-10-12 | 실사용 점검 4 — 걷기 리워드 앱(게이미피케이션, 모바일 웹앱 화면 6개 + 하단 탭)을 일반 2번·suta 0.10 2번·suta 0.11 2번 만들어 비교, 학습·공동구매·금융 앱 화면을 레퍼런스. 새 패턴 `celebration`(축하 오버레이, 56→57), `count-up` 낭독은 최종값만, 보상 색 토큰(`--color-reward` 금·은·동)과 tone.md 예외, `hue-count`가 보상 색 변수를 따로 셈, 화면 관례 "게이미피케이션·리워드" 절, 아이콘 7개(45→52), SKILL.md 금지선·값·체크리스트, 버전 0.11.0. 블라인드 판정 1차 17:7·19:5, 2차 10:14·15:9(순위·배지 개선, 축하·홈·미션 패배 — 2차 뒤 관례 고침, 재측정 안 함) | skills/suta·demo·evals·docs·README 2벌 배지·매니페스트 | 사용자 요청 — 간단한 게이미피케이션 앱으로 벤치마크·개선 |
| 2026-10-12 | 패턴 CSS의 suta 검사 경고 22건 정리 — 패턴 20개의 간격을 4px 척도로(누르는 영역은 위로), file-upload 반경 2종으로, `effect-overuse`가 `blur(0)`·투명 그림자 같은 전이 시작 상태를 세지 않게(TDD). 스킬 전체 검사 warn 22 → 0 | skills/suta/patterns·layout-audit·demo/src/tests·README 2벌 배지 | 사용자 요청 — suta 패턴을 그대로 복사한 앱에서도 suta 검사 경고가 났다 |
| 2026-10-12 | 걷기 리워드 화면 비교와 "요청마다 화면 비교" 규칙 — 배포판 0.11.0으로 suta를 2번 더 돌려(3차) 측정·블라인드 판정(20:4·20:4), 비교 이미지 `docs/assets/walking-as-is-to-be.jpg`(일반 1번째 ↔ suta 0.11.0 1번째, 390 화면 6개)와 화면 비교 문서 2벌에 걷기 리워드 절, 연구 문서 7절(3차 결과). AGENTS.md 규칙 12·harness-rules 9·add-skill에 화면 비교(점검·벤치마크는 비교 문서, 작은 변경은 작업 기록·PR 본문) | docs/comparisons(.en).md·docs/assets·docs/research·AGENTS.md·docs/harness-rules.md·add-skill | 사용자 요청 — 증권처럼 README 쪽에서 화면을 비교하고, 앞으로 요청마다 화면 비교를 붙인다 |
| 2026-10-13 | 실사용 점검 5 — React Native 앱(데일리디저트, 비공개)에 suta를 적용하며 RN 대응. layout-audit가 `StyleSheet.create`의 글자 크기·간격·반경·색·그림자, motion-audit가 Reanimated `useAnimatedStyle` 레이아웃 속성·`withRepeat` 무한 반복·`withTiming` 시간과 RN `Animated`·`LayoutAnimation`의 동작 줄이기를 읽는다(TDD, 테스트 8개). 공통 코어에 JS 스캔 도구. `layout-principles/references/react-native.md`(웹 → 네이티브 대응표, 토스트·진행 막대·스켈레톤·시트·축하 옮기기, 검사 범위), SKILL.md 절차 1단계·한계·description, 트리거 평가 2개, guide 2벌, 버전 0.12.0. 앱 화면 비교는 사용자 결정으로 앱 저장소에만 둔다 | skills/suta·demo/src/tests·evals·docs·README 2벌 배지·매니페스트 | 사용자 요청 — 데일리디저트의 부족한 디자인 시스템을 suta로 구현하며 suta도 개선 |
| 2026-10-14 | 색 조합·글꼴·문구 — 처음 받은 레퍼런스(앱 31곳 1,116장·웹 19곳·피드백 사례) 재분석. 무채색 토큰을 순수 회색으로, 글꼴 토큰 `--font-sans`, 색 조합 도구 `palette.ts`·`scripts/palette.mjs`(강조색 하나 → 대비를 지킨 한 벌, 반올림 없이), `tone.md` 강조색 맑기·무채색 온도·글꼴·제목 줄바꿈, 새 `copy.md`(말투·버튼·대화상자·오류·빈 상태·토스트), layout-audit 규칙 5개(`muddy-accent`·`neutral-temperature`·`accent-contrast`·`meta-copy`·`mixed-tone`)와 `tinted-surface` 오탐 2종, SKILL.md 절차·금지선(문구 표)·값, 데모 문구 해요체, 버전 0.13.0. 같은 요청 0.12 → 0.13 재측정: 탁한 강조색 6 → 0, 푸른 회색 글자 10 → 0, 말투 섞임 2 → 0, 블라인드 판정 11:13·10:14(우열 없음) | skills/suta·demo·evals·docs·README 2벌 배지·매니페스트 | 사용자 요청 — 처음 준 레퍼런스를 기준으로 색 조합·폰트·문구 개선 |
| 2026-10-14 | 설정·랜딩 — 레퍼런스 앱 31곳 화면 전체 목록에서 설정류 161장, 시중 SaaS·서비스 42곳 랜딩 실측. 화면 관례 설정·마이(폭 가득 목록·스위치 강조색·꺾쇠 행 테마·고객센터·약관·버전)·랜딩(증거 띠·기능마다 제품 화면·후기·마지막 띠, 그림은 컨테이너 안·모바일은 한 열 그림) 절 다시 씀, `tone.md` 스위치 예외, `switch` 켜짐 강조색·꺼짐 옅은 트랙 + 1px 테두리, layout-audit 규칙 `numbered-markers`·`interactive-in-picture`(그림 안 상자는 `nested-card`에서 뺌), 벤치마크 측정이 그림 안 상자를 세지 않음, SKILL.md 금지선 2행·체크리스트, 데모 ⑦ 설정, 버전 0.14.0. 같은 요청 0.13 → 0.14 재측정 세 차례: 블라인드 판정 1차 6:6, 2차 4:8, 3차 랜딩 6:0. 설정은 판정이 0.13 틀을 골랐으나 레퍼런스와 반대라 유지 | skills/suta·demo·scripts/benchmark·docs·README 2벌 배지·매니페스트 | 사용자 요청 — 0.13 비교에서 설정·랜딩이 아직 AI 슬롭, 레퍼런스와 시중 웹·앱을 더 참고 |
| 2026-10-14 | README 비교 이미지를 suta 0.14로 — 벤치마크 요청 4개(일정 관리 SaaS 랜딩·판매자 대시보드·로그인·설정)를 suta 없이와 0.14.0으로 2번씩 새로 실행, 첫 실행으로 `docs/assets/benchmark-as-is-to-be.jpg`(왼쪽 AS-IS·오른쪽 TO-BE), README 2벌 이미지·설명, 비교 문서 2벌 맨 앞 절. 강조색 파랑·남색·보라 8번 → 파랑 1번(대시보드), 그라데이션 등 12 → 1, 접근성 위반 16 → 1. 블라인드 판정 9:7·7:9(대시보드·랜딩 우세, 설정·로그인 열세). 릴리스 0.14.0 노트 초안 | README 2벌·docs/assets·docs/comparisons(.en).md·docs/worklog | 사용자 요청 — PR #49 병합 뒤 README AS-IS/TO-BE를 최신 버전·차이가 잘 보이는 이미지로 |
| 2026-10-14 | 릴리스 워크플로 — `.github/workflows/release.yml`이 `docs/releases/v{버전}.md`가 main에 들어오면 검사를 다시 돌리고 그 커밋으로 `suta {버전}` 릴리스를 만든다(이미 있거나 노트가 없으면 건너뜀, 수동 실행 가능). 0.14.0 노트(0.12·0.13·0.14 묶음), docs/releases/README.md 절차 4 | .github/workflows·docs/releases | 사용자 요청 — 릴리스를 에이전트가 올리게(세션 도구에 릴리스 생성이 없어 Actions로) |
| 2026-10-19 | 앱 화면 — 앱 화면 요청 8개(피드·배달·숙소·채팅방·알림·프로필·온보딩·은행)로 진단(0.14 4 : 12·3 : 13), 레퍼런스 앱 31곳 194장 유형별 기록 + 시중 앱 16곳 앱 마켓 스크린샷. 콘텐츠 그림 `content-art.css`, 그림 아이콘 57개 `illustrations.ts`·`Illustration.tsx`(Fluent Emoji Flat, MIT — 큰 칸에만), 선 아이콘 52 → 64, 관례 콘텐츠 그림·페이지 점·채팅방·알림·내 프로필·은행 홈, layout-audit `.art` 제외·규칙 `stacked-icon-buttons`(23 → 24), `carousel` 점 칸 24px을 정본으로, 측정은 그림 안 그라데이션을 세지 않음, SKILL.md 절차·금지선·값·체크리스트, 데모 ⑩, 버전 0.15.0. 6차에서 검사 규칙 `grid-blowout`·`hidden-text-escape`(24 → 26, 채팅방 가로 넘침·입력 줄 아래 빈 영역의 원인), 사진 대역 `art--dish`·접시·그릇 장면, 선 아이콘 64 → 72, 관례 세부(알림 행·시작 안내 그림·은행 버튼과 거래 아이콘·배달 가게 사진·숙소 객실). 여섯 차례 재측정 — 5차 15 : 17·16 : 16 → 6차 19 : 13·20 : 12, 이모지 80 → 0·axe 232 → 17 | skills/suta·demo·evals·scripts/benchmark·docs·README 2벌 배지·매니페스트 | 사용자 요청 — 앱 화면 자료조사를 더 하고 앱 화면도 디자인이 잘 나오게. 중간에 "메인 말고는 AS-IS가 더 앱 같다", "페이지 점은 TO-BE가 낫다", "AS-IS/TO-BE가 달라진 게 없어 보이고 디테일이 부족하다" |
| 2026-11-05 | 외부 개발자 도입 — 판단 순서(명시한 요구 → 기존 디자인 체계 → 사용 문제 → suta 기본값)와 사용 문제·취향 구분, 요청에 없는 구역·항목을 더하지 않기, 랜딩 사실 정보(실제 서비스는 받은 자료만·가상 목업은 화면에 예시 표시), SKILL.md를 늘 읽는 핵심(57,732 → 24,743바이트)과 `references/`(defaults·checklist·catalog)로 나누고 읽을 문서 표, validateSkills가 핵심 절·참조 연결·경로를 검사, 패턴 색인·카탈로그 생성 분리, 편집 후 검사 warn을 `[사용 문제]`와 취향으로 나눠 안내(규칙·심각도는 그대로), README 소개를 기준·패턴 코드·편집 후 검사로 + 불리한 행을 포함한 측정 표, 데모 첫 화면에 대표 사례(걷기 리워드 0.11.0, 포커스·무한 반복·axe)·직접 확인·설치와 첫 요청, 데모 README 링크 버그, 버전 0.16.0. 새 LLM 평가는 돌리지 않음 | skills/suta·scripts·demo·README 2벌·docs/guide·AGENTS.md·add-skill·매니페스트 | 사용자 요청 — 외부 개발자가 이해하고 도입하기 쉽게, 근거는 기존 자료와 로컬 검증으로 |
| 2026-11-06 | 레퍼런스 재분석과 관례 보강 — 처음 받은 레퍼런스(앱·웹 화면 아카이브의 빈 흐름 17개, 51흐름·293장)와 웹 디자인 어워드 선정작 60개를 다시 봄(`docs/research/2026-11-06-reference-gaps.md`). 같은 요청 진단(글쓰기·상품 필터·SaaS 리포트, 18번)에서 앱 2 : 10·3 : 9로 진 곳의 관례를 고침 — 화면 관례 글쓰기·필터·정렬 절, 대시보드·리포트 다시 씀(지표 탭 + 큰 선 그래프), 상품 그림은 상품 이름에 맞게, 강조색 근거에서 업종 일반론을 뺌, 버전 0.17.0. suta만 9번 재측정: 앱 4 : 8·4 : 8, 리포트 6 : 0 → 2 : 4(금액 칸 잘림·모바일 표 열 빠짐). 재측정 뒤 칸 잘림·열 빠짐을 사용 문제로, 하위 화면의 뒤로·닫기는 요청에 없어도 둔다(다시 재지 않음) | skills/suta·evals/benchmark·docs/research·docs/comparisons(.en).md·docs/assets·매니페스트 | 사용자 요청 — 아직 AI 슬롭 디자인이 나온다, 처음 준 레퍼런스를 더 분석하고 빈 유형을 브리핑, 순차 진행(재분석 → 진단 → 보강·재측정) |
| 2026-11-06 | 다른 요청 재측정과 업종별 글꼴 — 같은 화면 유형을 다른 업종 요청(책 후기 쓰기·숙소 필터·쇼핑몰 매출 리포트)으로 두 조건 18번: 숙소 필터 5 : 1·5 : 1, 후기 쓰기 1 : 5·1 : 5, 매출 리포트 2 : 4·1 : 5. 진 이유(안내 문구 안에만 있는 필수 표시, 모바일 표의 매출 열이 첫 화면 밖)를 사용 문제로 고침. 업종 9개 웹사이트 48곳의 글꼴·글자 크기를 재서 `tone.md` 5절 "업종과 읽는 조건에 따라"와 토큰 `--font-serif`·`--font-mono`(다시 재지 않음) | skills/suta·demo/src/tests·evals/benchmark·docs/research·docs/comparisons(.en).md·docs/assets·README 2벌 배지 | 사용자 요청 — 다른 요청으로 다시 재기, 폰트 사이즈와 폰트도 도메인에 따라 |
| 2026-11-06 | 세 번째 요청 묶음 재측정(중고 판매글 쓰기·구청 민원 처리 현황·매거진 기사, 18번)과 측정 스크립트 고침 — `measure.mjs`가 처음 화면 밖의 닫힌 하단 시트를 캡처에 끌어오던 결함을 고치고 판매글 쓰기를 다시 판정(4 : 2 → 0 : 6·1 : 5). 민원 2 : 4·3 : 3, 매거진 1 : 5·0 : 6. 고침(다시 재지 않음): 글쓰기 관례를 제목·본문뿐인 글쓰기와 작성 폼(칸 모양 하나 + 굵은 라벨)으로 나눔, 견본 숫자의 정합성, 웹 사이트 머리는 화면의 틀, 업종과 화면 유형이 겹칠 때, `--font-serif`는 한국어 명조가 없으면 고딕으로 | skills/suta·scripts/benchmark/measure.mjs·demo/src/tests·evals/benchmark·docs | 사용자 요청 — 다른 요청으로 다시 재기 |
| 2026-11-06 | 네 번째 요청 묶음 재측정(동네 모임 만들기·시립 도서관 이용 통계·음악 웹진 앨범 리뷰, 18번) — 도서관 6 : 0·6 : 0(지표 묶음·모바일 카드 목록·사이트 머리), 모임 1 : 5·1 : 5(조작이 단조로움), 앨범 리뷰 2 : 4·2 : 4(구성 빈약). 고침(다시 재지 않음): 작성 폼의 고르는 칸을 값의 종류로(세그먼트·칩·기본값 스테퍼·시트), 새 화면 관례 "기사·리뷰 상세"(관례 24종) | skills/suta·evals/benchmark·docs | 사용자 요청 — 다른 요청으로 다시 재기 |
| 2026-11-06 | 측정 보강 — 벤치마크 측정이 칸 밖으로 잘리거나 삐져나온 글자(390·1280)와 390px 첫 화면 폭 밖의 표 열을 센다(`scripts/lib/clipCheck.ts`, TDD 15개), 집계에 두 줄과 생성 비용(`costUsd`). 지난 웹 실행 24개로 판정이 짚은 결함만 잡히는 것을 확인 | scripts/lib·scripts/benchmark·demo/src/tests·docs/benchmark(.en).md | PR #57 후속 — 사람이 캡처에서 찾던 결함을 숫자로, 리뷰 지적(결과 JSON에 비용 없음) |
| 2026-11-06 | 다섯 번째 요청 묶음 재측정(병원 진료 예약·강의 등록·여행 매거진 기사, 18번) — 진료 예약 4 : 2·4 : 2(고르는 칸 고침이 통함), 강의 등록 3 : 3·3 : 3, 여행 기사 0 : 6·0 : 6(사이트 메뉴가 항목 하나). 고침(다시 재지 않음): 가로로 넘기는 줄의 첫 항목 정렬, 데스크톱 작성 폼의 같은 폭·구역, 기사 관례의 표현 | skills/suta·evals/benchmark·docs | 사용자 요청 — 후속 후보를 PR → 서브 에이전트 검토 → 병합 순서로 |
| 2026-11-06 | 요청 범위의 경계 — "요청하지 않은 기능·구역은 더하지 않는다"는 그대로 두고, 요청한 것을 보이는 방식(평점 막대·필수 표시·소제목 번호·드롭캡·칩과 스테퍼)과 화면의 틀(사이트 메뉴 이름 3~5개, 지어낸 이름은 보고에)은 범위 안, 찜·공유·검색·후기 구역·요청에 없는 데이터 항목은 제안으로 표에 정리. 여행 기사 재측정의 "메뉴 항목 하나" 문제를 고침(다시 재지 않음) | skills/suta/SKILL.md·references/defaults.md·checklist.md·screen-conventions.md(기사·커머스·상세·증권 GNB)·docs/worklog | 사용자 요청 — 후속 후보(요청 범위 규칙 정리) |
| 2026-11-06 | README·상세 안내 0.17 갱신과 릴리스 노트 — README 2벌에 화면 유형 24종·업종별 글꼴 한 문장과 "관례가 없던 화면 (suta 0.17)" 절(다섯 묶음 판정 표, axe 0, 기사 세 번 패배, 비용 1.2~3.3배, 다시 재지 않은 것), 상세 안내 2벌에 요청 범위의 경계와 24종·글꼴, `docs/releases/v0.17.0.md`(main에 들어가면 릴리스 발행) | README 2벌·docs/guide(.en).md·docs/releases·docs/worklog | 사용자 요청 — 후속 후보(README·안내 0.17, 릴리스 노트 발행) |
| 2026-11-06 | segmented-control 재검증 — thumb 전이를 `transform` 하나로(같은 폭 칸이라 모양 그대로, 레이아웃 애니메이션 무시 주석 제거), 크기 감시의 첫 알림이 진행 중인 슬라이드를 끊어 thumb가 건너뛰던 결함 수정(`immediate`는 같은 자리면 아무것도 하지 않음), 리뷰에서 찾은 마운트 때 미끄러져 들어오던 결함 수정(`transition: none` 뒤 스타일 확정, 프로덕션 번들로 확인). 테스트 7개(TDD) | skills/suta/patterns/segmented-control·demo/src/tests·README 2벌 배지·docs/worklog | 사용자 요청 — 후속 후보(segmented-control width 전이 정리) |
| 2026-11-06 | 여섯 번째 요청 묶음 재측정(반려견 미용 예약·채용 공고 등록·인테리어 집 소개 기사, 18번) — 집 소개 기사 6 : 0·4 : 2(기사 표현·사이트 메뉴 고침이 통함), 채용 공고 5 : 1·2 : 4, 미용 예약 4 : 2·3 : 3. 기본 모델(생성 모델과 같음)이 처음으로 세 요청 모두 suta(15 : 3), 다른 모델 9 : 9. 고침(다시 재지 않음): 데스크톱 작성 폼은 입력 열·패널을 한 묶음으로 머리와 좌우 끝 맞춤·회색 바탕 위 테두리 입력칸, 세그먼트는 늘 한 칸 선택(기본값 없는 필수는 칩·라디오), 금액 있는 예약 폼은 항목별 내역 + 금액 든 하단 바, 반려견 아바타는 이름 첫 글자 원. README 2벌 결과 절 | skills/suta·evals/benchmark·docs·README 2벌 | 사용자 요청 — 후속 후보(마지막 고침을 새 요청으로 재측정) |
| 2026-11-09 | 측정 — 넘친 페이지에서 화면 크기를 `clientWidth`·`clientHeight`로(모바일 에뮬레이션의 `innerWidth`·`innerHeight`가 늘어나 페이지를 넘친 표 열을 0으로 세고 톤 지표의 여섯 장 범위가 넓어졌다). 고정 요소 판정은 늘어난 화면이 맞아 그대로. 재현 페이지 3개·지난 실행 126개로 확인(표 열 변화 없음, 톤 지표 1개 페이지). 여섯 번째 재측정 기록의 "측정의 빈틈"을 원인(가로 넘침과 캡처 자르기)으로 정정 | scripts/benchmark/measure.mjs·docs/benchmark(.en).md·docs/research·docs/worklog | 사용자 요청 — 후속 후보(측정의 빈틈) |