agentleFS
GuksuGuksu/suta/CLAUDE.md

suta

CLAUDE.md18 starsChanged 40 days agoMITView on GitHub

공통 지침은 위에서 가져온 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 스킬로 수행한다. 변경 이력: | 날짜 |…

The file

Files
CLAUDE.md

@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.0skills/·.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.0skills/suta·demo·evals·README·docs사용자 결정 — 디자인 레퍼런스를 분석해 레이아웃 스킬·훅에 결합(설계 문답 11)
2026-10-07README 간결화(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.1demo/·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.0skills/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.0skills/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.0skills/suta·demo·evals·docs·README사용자 요청 — 실제 상황을 suta로 구현하며 기능 개선
2026-10-08README 손질 — 맨 위에 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.1demo·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.0demo·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:4skills/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 → 0skills/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-14README 비교 이미지를 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 → 17skills/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).mdPR #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-06README·상세 안내 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-06segmented-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사용자 요청 — 후속 후보(측정의 빈틈)
2026-11-09glass-nav 재검증 — 활성 알약을 링크 전체 폭(마지막 링크의 끝, 줄이 옆으로 스크롤돼도 덮게 — 리뷰가 찾은 결함)에 깔고 clip-path: inset(… round var(--gnav-pill-radius, 999px))만 전이(링크 폭이 달라 transform만으로는 폭이 어긋나고 scaleX는 끝이 찌그러짐, width 전이·무시 주석 제거), 마운트 때 폭 0에서 자라나던 결함 수정(첫 배치는 전이 없이 스타일 확정, 숨긴 마운트는 보일 때). 테스트 새로 6개·고침 3개(TDD), 프로덕션 빌드·compact·reduced-motion 확인skills/suta/patterns/glass-nav·demo/src/tests·README 2벌 배지·docs/worklog사용자 요청 — 후속 후보(glass-nav width 전이)
2026-11-09일곱 번째 요청 묶음 재측정(동물병원 진료 예약·출장 세차 예약·숙소 등록, 18번) — 진료 4 : 2·3 : 3, 세차 5 : 1·6 : 0, 숙소 등록 6 : 0·2 : 4(기본 모델 15 : 3, 다른 모델 11 : 7). 측정 결함 두 가지(긴 페이지에서 하단 고정 바가 잘림, 넓은 바가 늘어난 innerHeight로 위로 밀려 찍힘)를 고치고 숙소 등록을 다시 판정 — 다른 모델은 거의 같은 캡처에서 4 : 2 → 3 : 3 → 2 : 4. 고침(다시 재지 않음): 작성 폼의 같은 줄 선택 카드는 보이는 상자까지 같은 높이·라벨 간격 통일. README 2벌 결과 절(일곱 묶음, 21개 요청)scripts/benchmark/measure.mjs·skills/suta·evals/benchmark·docs·README 2벌사용자 요청 — 후속 후보(지난 고침을 새 요청으로 재측정)
2026-11-10스킬의 깊이 — 설계 판단(references/design.md: 화면의 일 여섯 가지에서 뼈대, 맞는 유형이 없을 때 빌리는 법), 화면 디테일(references/detail.md: 견본 데이터·값의 종류별 조작·컴포넌트 상태·마감), 층(elevation.md + 그림자 3단계·스크림·겹치는 순서 5단계 토큰, 공개 웹사이트 47곳 실측, 검사 규칙 glow-shadow·shadow-variety 26 → 28, 데모 ⑪), 패턴 22종의 "상태와 경계" 절과 코드 보강(skeleton 지연 표시·select 순수 JS 코어·시트 포커스와 뒤로 가기·툴팁 WCAG 1.4.13 등). 패턴 기본값을 토큰 사슬로(탭 바가 시트 위에 그려지던 순서 결함, 3.2:1 라벨 색 수정). SKILL.md 절차 7단계 추가, 테스트 754 → 1,092, 버전 0.18.0. 같은 요청 0.17 ↔ 0.18 재측정(배송 조회·대기 등록·휴가 신청, 12번): 블라인드 판정 8 : 4·9 : 3, 지표는 거의 같음, 새 참조 문서는 6번 중 0~1번만 읽힘 — 절차에 "읽는다"를 명시(다시 재지 않음)skills/suta·demo·evals/benchmark·docs·README 2벌 배지·매니페스트사용자 요청 — 스킬을 분석해 깊이를 개선(네 방향 모두 선택)
2026-11-11깊이 후속 다섯 가지 — ① 새 참조 문서가 읽히는지 다시 재기(design.md 6번 중 0번 → 설계 순서의 핵심을 SKILL.md 절차로 올림, 그 판의 판정은 0.17과 6 : 6·6 : 6) ② 선택 상태(칩은 테두리·고른 것은 색 + 체크 표시·여러 줄 안내는 회색 상자 하나, 대기 등록 1 : 3·0 : 4 → 3 : 1·3 : 1) ③ 층을 쓰는 요청 재측정(두 판 모두 층은 맞고 값만 토큰으로 모임) ④ 남은 패턴 31종의 "상태와 경계"와 코드 보강(컴포넌트 패턴 53종 전부, 테스트 1,092 → 1,297) ⑤ 시트 위 시트의 겹치는 순서·sticky-header 기본 색. 버전 0.19.0skills/suta·demo·evals/benchmark·docs·README 2벌 배지·매니페스트사용자 요청 — 후속 후보를 하나씩 PR → 병합 순서로
2026-11-11깊이 본측정 — 관례에 없는 요청 6개(배송 조회·대기 등록·휴가 신청·수업 시간표·모임 정산·재고 관리)를 0.17과 0.19에 3번씩(36번). 블라인드 판정 19 : 17·20 : 16으로 사실상 비김, 접근성 위반 0.19가 0(0.17 앱 0.17·웹 1.67), 새 참조 문서는 18번 중 한 번씩만 읽힘. 진 이유(옅은 색 채움 버튼·같은 정보 두 곳·회색 채움 입력칸)는 고치지 않음evals/benchmark·docs/comparisons(.en).md·docs/assets·docs/research·docs/worklog사용자 요청 — 설계·디테일 문서의 효과를 가르는 측정
2026-11-11본측정에서 진 이유 세 가지(행의 행동 버튼은 윤곽선·같은 항목은 목록 하나에·데스크톱 입력칸은 테두리)를 defaults.md에 넣고 다시 잼(6번 실행) — 수업 시간표 0 : 6·0 : 6, 재고 관리 3 : 3·1 : 5로 나아지지 않아 되돌림. 진 판정 12번이 모두 0.17의 요청에 없는 하단 탭 바를 듦skills/suta/references/defaults.md(되돌림)·docs/research·docs/worklog사용자 요청 — 진 이유 고침 진행
2026-11-15README 0.19 갱신과 넘겨 둔 코드 수정 — README 2벌에 0.18~0.19 내용과 "버전을 올리며 다시 잰 것"·"패턴 코드에서 고친 것" 절(0.17 절은 비교 문서로), 상세 안내 패턴 표 41행. 스프링 공유 코어가 숫자가 아닌 입력·멈추지 않는 설정에서도 끝남, 패턴 13종의 면이 --color-surface를 따름(어두운 토큰에서 메뉴 글자 대비 1.09 → 15.63), dir="rtl"에서 swipe-to-delete·edge-swipe-back·long-press-menu 방향과 Drawer의 side start·end(기본 start). 테스트 1,297 → 1,322(TDD). 버전은 0.19.0 그대로README 2벌·docs/guide(.en).md·docs/comparisons(.en).md·skills/suta/patterns·demo/src/tests·docs/worklog사용자 요청 — README를 0.19 기준으로, 패턴 표 갱신과 코드 수정
2026-11-15버전 0.20.0과 릴리스 노트 — 매니페스트 세 개 0.19.0 → 0.20.0, docs/releases/v0.20.0.md(면 토큰·dir="rtl"·스프링 종료, 동작이 바뀐 것, 확인하지 못한 것), README 2벌 "패턴 코드에서 고친 것" 절에 0.20 두 줄매니페스트·docs/releases·README 2벌·docs/worklog사용자 요청 — 0.20.0으로 버전 올리고 릴리스 노트

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.