do-design은(는) 무엇을 하나요?
경로는 이 스킬 폴더 기준이며; P는 프로젝트 루트입니다. 스크립트는 표준 라이브러리 Python 3.8+입니다. 스크립트가 측정하는 모든 것에 대해 추론하기 전에 먼저 스크립트를 실행하고, 그 결과를 인용하며, 스크립트가 보고한 내용을 재추론하거나 추정하지 마십시오.
모델
- 프로젝트의
DESIGN.md(종이)가 바인딩되며 이 스킬보다 우선합니다. 충돌 시 종이가 승리합니다. 그렇게 말하십시오. - 모든 규칙은 이유를 함께 제시합니다. 이유 없는 규칙은 처음 불편해질 때 삭제됩니다.
- 기본값보다 증거가 먼저입니다. 얇은 브리프("새롭게 만들어라" + 로고)는 조사해야 할 이유이지, 일반적인 모양으로 돌아가거나 사실을 지어낼 이유가 아닙니다. 출처가 없으면 주장도 없습니다: 그 차이(gap)를 표시하거나 질문하십시오.
- 느리게 로드하십시오. 명령어 테이블이 명명한 파일만 로드합니다. "완전함"을 위한 추가 레이어는 방법론적 실패입니다.
- 관례는 기본값이지 실패가 아닙니다. 모드는 얼마나 벗어날지를 결정합니다.
모드: 모든 명령어 시작 시 한 줄로 상태를 명시하십시오
| 모드 | 방문자는 | 추진력 |
|---|---|---|
| 설득(Persuade) | 결정하고 행동하고 있음 | 강하게: 템플릿은 실패입니다 |
| 작동(Operate) | 작업을 완료하고 있음 | 자제: 관례는 기능입니다 |
| 읽기(Read) | 무언가를 이해하고 있음 | 중간: 읽기 편안함이 승리합니다 |
| 경험(Experience) | 작업 자체 내부에 있음 | 강하게: 결과물이 주도합니다 |
표면(화면 유형)으로 선택하고 제품으로 선택하지 마십시오: 개발 도구의 랜딩 페이지는 설득(Persuade)이고, 설정 화면은 작동(Operate)입니다.
명령어: 명령 파일 하나와 해당 행이 명명하는 파일들을 로드하십시오
| 명령어 | 사용 시기 | 추가 로드 | 위험 |
|---|---|---|---|
do-design-review | "이게 종이와 일치하나요?" 가장 저렴함, 가장 자주 실행 | 프로젝트의 DESIGN.md | - |
do-audit | "이게 얼마나 좋은가요?" 점수 + 순위별 발견 사항 | references/critique-rubric.md, references/slop-catalog.md, 범위가 닿는 레이어 00-05 | - |
do-design-new | "X를 구축하라": 관례적이고, 유능하며, 종이에 기반 | layers/00, 작업이 닿는 1-3 레이어; 브리프가 얇거나 고객 대상일 때 layers/06 | 낮음 |
do-design-renew | "이 모양을 재구성하라": 새로운 세계, 동일한 제품 진실 | layers/00, layers/06 | 중간 |
do-crazy | "이 업계에서는 아무도 하지 않을 것" | layers/00, layers/06 | 높음, 설계된 대로 |
레이어: 00-craft-floor (모든 모드) · 01-color · 02-typography · 03-space-layout ·
04-motion-states · 05-voice · 06-research. 종이 작성: templates/DESIGN.md,
examples/01-two-papers.md, references/interview.md.
스크립트 (모두 --json 인수 사용)
| 실행 | 결과 |
|---|---|
scripts/check-design.py --root P | 종이의 토큰 블록과의 차이(drift). 종료 코드 0: 일치, 1: 차이, 2: 종이/토큰 없음. --init는 코드에서 토큰 초안을 생성합니다 |
scripts/audit.py scan P | 소스 텔(tells) (slop 카탈로그의 ID), a11y 및 브라우저 표면 차이, 가치 인벤토리 |
scripts/audit.py copy P | 산문 및 마이크로카피 텔, 문장 리듬, 채워지지 않은 차이 마커 |
scripts/audit.py contrast FG BG / --paper P/DESIGN.md | WCAG 비율 |
scripts/audit.py score H L S C T U D | 가중 점수, 밴드, 작업 목록 |
scripts/render-audit.py URL-or-file [--shots DIR] [--inject-css FILE] | 1280/768/390에서 그려진 페이지: 겹침, 가로 스크롤, 클리핑, 그려진 대비, 탭 대상, 포커스 가시성. --inject-css는 배포 전에 배포된 페이지에 대해 CSS 수정을 측정합니다. Chrome/Chromium 필요 |
| `scripts/research.py suggest | profile |
bash scripts/install-guardrails.sh P | 템플릿의 DESIGN.md, AGENTS.md/CLAUDE.md 블록, 체커 |
스크린샷은 스크립트 출력보다 훨씬 많은 컨텍스트를 소비합니다: 눈으로 확인해야 하는 것(계층, 구별, 구성)에만, 뷰포트만, 390 우선으로 사용하십시오. 스크립트도 틀릴 수 있습니다: 터무니없어 보이는 P0를 보고하기 전에 한 번 확인(대상 스크린샷 또는 요소의 지오메트리)하고, 거짓 긍정이었다면 스크립트를 수정하십시오.
공유 정의
교체 테스트(Swap test). 제품 이름을 경쟁사 제품 이름으로 바꾸십시오. 아무것도 깨지지 않는다면, 페이지는 이 제품에 대해 아무 말도 하지 않는 것입니다: 선택되지 않음, 못생기지 않음. 장식을 추가하는 것이 아니라 카피, 시각적 요소 및 하나의 시그니처 세부 사항에서 수정하십시오.
방향(Direction), 다섯 줄. 빌드 전에 작성하고, 보여주고, 예스(YES)를 기다리십시오 ("그냥 해"라고 하면 한 줄로 가정을 명시하고 진행하십시오):
제품: 무엇을 하는지, 누구를 위한 것인지, 한 문장으로 평범하게
성격: 2-3개의 구체적인 단어 (깔끔한, 현대적인, 세련된, 미니멀한, 프리미엄 절대 안 됨)
세상: 그것이 속한 장소나 재료; 중립 색조, 강조 색상, 이미지 설정
순간: 화면이 풍부해지는 1-2곳
시그니처: 이 제품만이 가지고 있는, 일관되게 사용되는 하나의 세부 사항
차이 마커(Gap marker). [number needed], [source needed], [photo needed] 사실이나 에셋이 누락된 곳에 표시. audit.py copy는 아직 열려 있는 것들을 나열합니다; 아무 것도 출시되어서는 안 됩니다.
점수 매기기: 모든 평가 명령어는 이것으로 끝납니다
| # | 필드 | 질문 | 가중치 |
|---|---|---|---|
| 1 | 계층(Hierarchy) | 가장 중요한 것을 2초 안에 이름 지을 수 있습니까? | 3 |
| 2 | 가독성(Legibility) | 모든 너비에서 대비, 크기, 행 길이, 실제 카피 | 3 |
| 3 | 시스템(System) | 하나의 팔레트, 하나의 스케일, 하나의 반경 로직, 하나의 모션 언어 | 2 |
| 4 | 공예(Craft) | 정렬, 간격 리듬, 상태, 브라우저 표면 | 2 |
| 5 | 콘텐츠 진실성(Content truth) | 실제 데이터, 구체적인 카피, 지어낸 주장 없음 | 3 |
| 6 | 사용성(Usability) | 작업 완료; 어포던스 명확; 오류 복구 가능 | 3 |
| 7 | 차별성(Distinction) | 교체 테스트를 통과합니까? | 2 |
각각 0-4점 (4 = 진정으로 훌륭함, "괜찮음"이 아님)으로 점수를 매기고 audit.py score로 계산하십시오. 밴드: 85+ 강력함, 출시하고 P0만 수정 · 70-84 건실함, 명명된 P1 이후 출시 ·
50-69 약함, 실제 패스 먼저 · <50 실패, 방향이 잘못됨: 재구축 (do-design-renew).
소스가 아닌 렌더링에 점수를 매기십시오. 확인할 수 없었던 필드는 u입니다: 0점으로 처리되고 unverified로 읽히며, 절대 추정하지 않습니다. 차별성은 이 제품의 것으로 만드는 것이 무엇인지 이름 지을 수 있을 때만 4점을 받습니다. 가장 낮은 세 개의 필드가 작업 목록이 되며, 각각 하나의 조치가 따릅니다.
심각도: P0 출시 차단 (깨짐, 읽을 수 없음, 하드 금지), 모두 보고 · P1 신뢰 손상, 상위 5개 · P2 공예, 상위 5개 · P3 다듬기, 목록만.
발견 형식: [Pn] 위치 - 무엇이 잘못되었는지 - 수정 방법; 스크립트 발견 사항은 ID를 유지합니다.
종이 없음
"DESIGN.md 없음: 가드레일이 강제할 것이 없습니다."라고 말하십시오. 종이를 작성(템플릿 + 인터뷰)하거나, 코드에서 리트로핏(check-design.py --init + 인터뷰 §Retrofit)을 제공하십시오: v1.0은 출시되는 것이며, 이전 값은 legacy:로 이동(계산되지만 실패로 간주되지 않음)하고, 차이는 종이의 델타 목록에 기록됩니다. 아카이브와 데모는 skip: (또는 --skip a,b)을 통해 폴더나 파일별로 모든 스캔에서 제외됩니다. 건너뛰기 전에 임포트를 grep하십시오: 아카이브 폴더는 종종 라이브 파트를 보유하고 있습니다. 체커가 통과하도록 종이를 절대 지어내지 마십시오.
비협상 사항
- 작동하는 코드를 절대 깨지 마십시오. Props, state, routing, handlers 및 a11y는 유지되고; 카피는 그 의미를 유지합니다.
- 브리프가 승리합니다. 명시된 브랜드, 글꼴 또는 색상은 거부 목록에 있더라도 취향보다 우선합니다. 그것을 종이에 기록하십시오 (
allow:는 토큰 블록에서 체커 규칙 또는 감사 ID를 의도적으로 끕니다). - 사실, 에셋 또는 출처를 절대 지어내지 마십시오. 모호한 주장을 자르십시오; 지어낸 구체적인 내용으로 대체하지 마십시오. 차이 마커를 사용하십시오.
- 저자의 목소리를 유지하십시오. 기계적인 습관을 자르고, 사람의 특성을 유지하십시오.
- 존재가 아닌 밀도. 하나의 그라데이션이나 하나의 em 대시가 아닌, 클러스터(3개 이상의 별개 P0/P1 텔)에 대해 행동하십시오. 깨끗한 결과는 유효합니다; 발견 사항을 절대 만들어 내지 마십시오.
- 고발하지 말고 수정하십시오. "이것은 AI가 생성한 것처럼 보입니다"라고 말하지 마십시오; 선택되지 않은 것이 무엇이고 대신 무엇을 해야 하는지 이름을 지으십시오.
- 리뷰 및 감사의 경우 요청이 없으면 읽기 전용으로 처리하십시오.