Agency of One
존재 이유
웹사이트를 요청하면 모델은 가장 확률이 높은 웹사이트를 생성합니다. 그런 모양을 금지하면 다음 확률이 높은 모양(크림 + 세리프 + 클레이, 블랙 + 애시드 그린, ALL-CAPS 눈썹, 링크의 →: 2차 물결 패턴)으로 이동할 뿐입니다. 그리고 '창의적'인 것이 해결책도 아닙니다. 비즈니스 사이트는 탁월한 에이전시가 만든 듯, 신뢰할 수 있고 세련되며 모든 것이 조화를 이루어야 합니다.
우선 순위: 1) 아름답고 클라이언트에게 적합함, 2) 명확하고 신뢰할 수 있음, 3) 차별적임(AI처럼 보이지 않음). AI 패턴을 피하는 것은 필요 조건이지만 충분 조건은 아닙니다. 차별적이지만 평범하거나 브랜드에 맞지 않는 페이지는 실패한 것입니다.
따라서 이 스킬은 클라이언트가 이미 가지고 있는 브랜드에서 시작하여, 가장 위험한 선택지를 빌더에게서 제거하고, 출력물을 세계적 수준의 마감과 미적 기준으로 유지합니다:
- 클라이언트의 브랜드와 자산 우선, 그다음 전략: 로고 색상, 실제 사진, 참조 자료, 포지셔닝, 증거, 브랜드 아이디어.
- 실제 무작위성, 브랜드 고정 색상: 스크립트가 레버(구성, 브랜드 장치, 팔레트 전략, 타이포그래피 전략)를 결정합니다. 색상은 로고가 있을 경우 클라이언트의 로고에서 가져오고, 그렇지 않으면 선별되고 대비가 확인된 팔레트 라이브러리에서 가져오며, 절대 모델의 취향에서 가져오지 않습니다.
- 독립적인 비평가가 다섯 가지 방향에 대해 전형성 및 강도를 평가합니다. 스크립트가 비전형적이면서 강한 방향을 선택합니다.
- 장인 정신 기준(
craft.md)과 영웅 셋 피스를 먼저 독립적으로 구축합니다. - 반박할 수 없는 검사: 모든 편집에 대한 린트, 렌더링된 측정, 계획 대 렌더링 비교, 교차 프로젝트 메모리, 렌더링된 미적 검사, 그리고 먼저 바람직성과 브랜드 적합성을 평가한 다음 장인 정신과 차별성을 평가하는 블라인드 리뷰어.
규칙이 충돌할 때 이 순서가 우선합니다: 클라이언트의 브리프와 브랜드 자산 > 아름다움(craft.md 우선순위, §2b) > 추출된 팔레트와 카드 > 패턴 목록. 카드나 패턴 회피 규칙이 더 못생기거나 브랜드에 맞지 않는 것을 정당화하지 않습니다.
$S = 이 스킬의 폴더: 스킬이 로드될 때 Claude Code가 표시하는 기본 디렉토리(플러그인인 경우 ${CLAUDE_PLUGIN_ROOT}/skills/agency-of-one, 드롭인인 경우 .claude/skills/agency-of-one 또는 ~/.claude/skills/agency-of-one). 저장소 루트에서 스크립트 실행: node $S/scripts/<name>.mjs. 세션 훅이 절대 스크립트 경로를 출력합니다. 모든 하위 에이전트에 그 절대 경로를 전달하세요(하위 에이전트가 $S를 자체적으로 확인할 수 없습니다). 절대 references/decks.json을 열지 마세요. 카드는 스크립트에서만 제공됩니다.
모드
- Agency (기본값): 비즈니스 중심적, 전문적, 세련됨.
references/agency.md를 읽으세요. - Expressive (
--mode expressive): 브리프가 실험적, 예술적, 사설, 캠페인 또는 이벤트와 같은 것을 요구할 때만 사용합니다. 비웹 참조 미디어와 제약 조건을 사용합니다.references/process-notes.md를 읽으세요.
게이트
DESIGN.md가 존재함 → 정확히 따르고 3단계로 이동하세요. 수정안을 제안하고 조용히 이탈하지 마세요.<!-- agency-of-one design v1.1 -->마커가 없으면 브랜드 우선 색상 이전입니다:brand-extract.mjs를 실행하고, 팔레트가 브랜드 자산과 충돌하면(plan-diff가 충돌을 보고함), 구축 전에 사용자에게 §4 색상 수정안을 제안하세요.- 브리프가 방향이나 브랜드 가이드를 고정함 → 브리프가 우선하며, 알려진 패턴을 언급하더라도 마찬가지입니다. 이를 기록하고(§9의 예외 사항과 함께) 3단계로 이동하세요.
- 그 외의 경우 → '작은' 페이지라도 1-2단계를 수행하세요.
저장소당 한 번 설정: npm i -D playwright && npx playwright install chromium (devDependency로 설치하여 이후 npm i가 제거하지 않도록 함).
1단계: 자산, 브랜드, 전략 (DESIGN.md §1)
- 실제 자산: 먼저 요청(agency.md 0단계). 로고, 사람 사진, 바이오 정보, 클라이언트 이름 또는 사례 연구, 연락처 및 법적 세부 정보, 실제 숫자, 제품 스크린샷. 블라인드 리뷰에서 디자인이 아무리 좋아도 이러한 자산이 없으면 신뢰성과 이미지가 약 6/10에서 멈춥니다. 누락된 항목은 전문적인 슬롯(agency.md 5단계)이 되며, 보고서는 무엇을 제공해야 하는지로 시작합니다.
- 이미 가지고 있는 브랜드(agency.md 0a단계). 로고, 문장, 기존 사이트 또는 사람 사진이 있으면
node $S/scripts/brand-extract.mjs를 실행하세요(자동 발견되거나 경로 전달 가능)..design-review/brand.json을 작성합니다. 이후draw.mjs는 자동으로 브랜드 고정되며 plan-diff는 로고 색상을 잃는 모든 팔레트를 실패 처리합니다. 참석: 한 줄로 사용자에게 추출된 브랜드 색상을 확인하세요. 브랜드 고유 색상과 절대 싸우지 마세요. - 참조 자료 (참석): 클라이언트가 아름답다고 생각하는 2-3개의 사이트를 요청하세요(모든 산업). 스크린샷을
design-references/에 저장하세요. 리뷰어가 이를 기준으로 비교합니다. 이는 모양이 아닌 품질 기준을 설정합니다. - 인간의 취향 (참석 전용): 한 번 물어보세요. "감탄하는 브랜드나 개체 2-3개, 그리고 닮고 싶지 않은 경쟁사 사이트 하나".
- 전략 (에이전시 모드, agency.md 1단계): 포지셔닝 문장, 하나의 신념, 유지/파기로 표시된 5가지 카테고리 코드(파기 ≥ 2개), 브랜드 아이디어, '하지만 ~은 아님'이 포함된 성격, 증거 목록(증거를 절대 만들어내지 마세요).
- 주제 목록: 클라이언트 세계의 8개 이상의 실제 아티팩트, 장소, 재료, 토착 양식(익스프레시브 모드에서는 12개 이상). 에이전시 모드에서는 이미지 방향, 브랜드 장치 및 카피에 사용되며 의상이 아닙니다.
- 영웅 문장과 기본 동작 레이블을 브랜드의 목소리로 작성하세요. 추첨 후에 이를 다듬을 수 있습니다.
2단계: 추첨 → 기준선 → 분기 → 비평 → 선택 → 확정
2a. 추첨. node $S/scripts/draw.mjs --project "<이름>" (기본적으로 에이전시 모드)가 품질 참조, 구성 시스템, 브랜드 장치, 팔레트 전략 및 타이포그래피 전략을 제공합니다. .design-review/brand.json이 존재하면 색상은 자동으로 브랜드 고정됩니다(재정의는 --no-brand "<사유>", 예: 클라이언트가 요청한 리브랜딩). 그렇지 않으면 선별되고 대비가 확인된 팔레트 라이브러리에서 제공됩니다: 아름다운 시작점, 절대 원시 임의의 색조가 아닙니다. DESIGN.md §2에 붙여넣으세요. 서면 사유가 있는 한 번의 거부권: --redraw <슬롯>. 카드가 패턴 목록에 있는 것을 요구하면(예: 눈에 보이는 그리드), 카드에 의해 의무화된 예외로 허용됩니다: §9에 card: <사유>로 기록하고 장식이 아닌 구조로 실행하세요.
2b. 기준선. 두 개의 쌍둥이를 작성하세요: AI 쌍둥이(모델이 이 브리프에 대해 만들 내용: 글꼴, 16진수, 영웅, 섹션)와 에이전시 모드에서는 에이전시-클리셰 쌍둥이(수상 경쟁 버전). 두 가지 모두 references/tells.md와 비교하세요.
2c. 분기. 5가지 방향(A-E) 을 .design-review/directions.md에 짧은 브리프 요약과 §1 목록과 함께 작성하세요. 각 방향은 브랜드 아이디어 표현, 추첨된 각 레버가 적용되는 방식, 영웅 구성(작은 ASCII 와이어프레임), 얼굴 클래스(아직 특정 얼굴 아님), 팔레트 스케치 및 브랜드 장치를 포함합니다. 스스로 점수를 매기지 마세요. 적어도 3가지는 스킨이 아닌 페이지 아키텍처에서 달라야 합니다.
2d. 독립 비평가. direction-critic 하위 에이전트(플러그인인 경우 agency-of-one:direction-critic)를 실행하고 경로만 전달하세요. 각 방향에 대한 전형성 t와 강도 s 및 PICK_ARG를 반환합니다.
2e. 선택. node $S/scripts/draw.mjs --pick "<PICK_ARG>"를 실행하세요. 에이전시 모드에서는 가장 강한 방향(s ≥ 8, 최고와의 차이 0.5 이내)을 취하며, 명백히 일반적인 것(t ≥ 0.7)만 제외합니다. 익스프레시브 모드에서는 비전형적인 것을 선호합니다. 종료 코드 3은 해당 사항 없음을 의미합니다: 3개의 새 방향을 작성하고(비평가의 가장 강한 아이디어를 접목) 비평가를 다시 실행하세요. 스크립트가 선택한 것을 구축하세요. 참석: 선택 항목과 차점자를 각각 한 줄씩 보여주고 사용자가 재정의할 수 있도록 하세요.
2e'. 영웅 구성 (아름다움 게이트). 확정하기 전에, 선택 항목 및 차점자에 대한 영웅(폴드 + 첫 스크롤, 데스크톱 및 모바일)을 실제 자산을 사용하여 두 개의 빠른 정적 구성으로 구축하세요. 둘 다 스크린샷을 찍고(screenshot.mjs --file comp-a.html comp-b.html), 그런 다음 새 design-reviewer에게 레이블이 없는 두 개의 폴드 및 모바일 폴드 이미지만 제공하고 하나의 강제 선택을 요청하세요: 클라이언트가 보내는 것을 더 자랑스러워할 것은 무엇이며, 그 이유는 무엇입니까? 승자를 구축하세요. 리뷰어가 둘 다 평범하거나 브랜드에 맞지 않는다고 평가하면, 다듬는 대신 다시 추첨하세요.
2f. 차이. 두 쌍둥이 모두에 대해 DESIGN.md §3 표를 채우세요. 일치하는 축은 브리프에서 요구하지 않는 한 변경되어야 합니다. 교체 테스트: 경쟁사 이름이 들어맞습니까? 그렇다면 §1에서 더 많이 가져오세요.
2g. 토큰 확정. templates/DESIGN.md → DESIGN.md를 완성하세요. 여기에는 plan-diff가 읽는 기계 판독 가능한 토큰 블록이 포함됩니다.
- 타이포그래피:
references/typography.md.node $S/scripts/type-specimen.mjs로 후보 목록을 렌더링하고 보고 선택하세요. 하나의 비율 스케일을 사용하세요. 유동 디스플레이 크기는fluid로 표시하세요. - 색상: brand.json의 제안(또는 선별된 팔레트)에서 시작하세요: 브랜드 그대로, 밝은 배경용 brandForText, 진한/밝은 색조, 색조가 있는 중성색 및 잉크(craft.md §4). AA를 테스트하세요. 로고 색상을 인식 가능하게 유지하세요.
- 반복 확인:
node $S/scripts/designlog.mjs check --project "<이름>" [--brand-locked] --display … --body … --ground … --accent … --layout … --medium "<구성 또는 기본 미디어>"를 실행하세요. REPEAT를 보고하면 반복된 축을 변경하세요.
3단계: 장인 정신 기준에 따라 구축
3a. 영웅 셋 피스를 먼저, 독립적으로 구축. 영웅만 구축하세요(에이전시 모드: 추첨된 구성을 완벽하게 실행; 익스프레시브 모드: 시그니처 메커니즘). 스크린샷을 찍고(screenshot.mjs, 대화형 상태를 위해 --state 사용) references/craft.md의 모든 관련 장인 정신 축에서 ≥ 8점을 받을 때까지 반복하세요. 그런 다음에만 나머지를 구축하세요.
3b. 토큰만으로 페이지 구축(CSS 변수 / Tailwind v4 @theme), agency.md 3단계 아키텍처 또는 익스프레시브 스켈레톤을 따르세요. shadcn/Radix는 동작만 제공합니다. 모든 프리미티브를 다시 스타일링하세요. 카피는 구체적이고, 문장 케이스이며, 브랜드 목소리를 따릅니다. 증거는 실제이거나 슬롯화됩니다. 린트 훅이 모든 편집 시 패턴을 플래그 지정하므로, 발생할 때 수정하세요.
3c. 마무리 패스. references/craft.md §1–10을 한 줄씩 검토하세요: 타이포그래피 세부 정보, 그리드 감사, 리듬, 색상 및 대비, 이미지 및 슬롯, 모션 및 상태, 1440/1024/768/390에서의 반응형 구성, 카피 편집(−30%), 기술적 마무리. 이 패스가 '에이전시 제작'의 느낌을 만들어냅니다. 건너뛰지 마세요.
4단계: 검증 (최대 3라운드, 최상의 결과 유지)
- 먼저 스냅샷: 각 라운드 전에 현재 상태를 커밋(또는 복사)하여 더 나쁜 수정 버전을 롤백할 수 있도록 하세요.
node $S/scripts/slop-lint.mjs: 오류 0개; 모든 경고는 §9 +slop-lint.config.json에서 수정되거나 정당화됨.node $S/scripts/screenshot.mjs --url <개발 URL> --routes / /about …(또는 정적 파일의 경우--file index.html about.html …; 모든 페이지, 홈페이지만 아님)--state <이름>=click:<선택자>|hash:<#id>|scroll:<선택자>|hover:<선택자>모든 시그니처 상태에 대해. 폴드, 모바일 폴드, scroll50 및 상태 샷을 확인하세요.node $S/scripts/plan-diff.mjs: 로고 색상이 팔레트에 있고, 계획된 글꼴이 로드되었으며, 팔레트가 렌더링되었고, 스케일이 적용되었으며, 계획 외 배경이 없고, 데스크톱 및 390px에서의 아름다움 검사: 애니메이션에 의해 콘텐츠가 보이지 않거나 JS 없이 숨겨지지 않음, 이니셜 아바타 없음, 일관된 사진 그룹(자르기, 크기, 배경), 중앙 정렬된 여러 줄 텍스트 없음, 대문자 레이블 없음, 구분선 없음, 모든 페이지에 설계된 페이지 헤더.- 블라인드 리뷰:
design-reviewer하위 에이전트(agency-of-one:design-reviewer)가 URL 또는 파일, 경로 및.design-review/만 받습니다. 먼저 바람직성과 브랜드 적합성을 평가한 다음,design-references/가 있으면 이를 기준으로 장인 정신과 차별성을 평가합니다. SHIP하려면 바람직성, 브랜드 적합성 및 모든 장인 정신 축이 ≥ 8이어야 합니다. 여러 페이지 사이트의 평결은 가장 약한 페이지를 기준으로 합니다. - 수정하고 다시 렌더링하세요. 리뷰어가 이전 최고치보다 높게 점수를 매긴 경우에만 수정 버전을 유지하세요. 3라운드 후 중단하고 여전히 열려 있는 사항을 보고하세요.
- 미러: 브랜드 아이디어에 도움이 되지 않는 장식 하나를 제거하고 DESIGN.md §11에 기록하세요.
- 기록:
node $S/scripts/designlog.mjs add --project "…" …check와 동일한 플래그… --media "<추첨 요약>" --signature "<장치 / 셋 피스>"(--log <경로>로 로그를 저장소에 유지). - 보고: 방향(한 줄), 브랜드 아이디어, 셋 피스, lint/plan-diff/리뷰 결과(장인 정신 점수 포함), 열린 예외 사항, 클라이언트가 채우거나 확인해야 하는 모든 슬롯 및 가정.
참조 파일
| 파일 | 사용 시기 |
|---|---|
references/agency.md | 에이전시 모드: 전략, 아이덴티티 시스템, 비즈니스 아키텍처, 슬롯, 신뢰성 |
references/craft.md | 3a, 3c, 4단계: 마감 기준, 정렬, 사진 시스템, 페이지 헤더, 점수 매기기 |
references/patterns.md | 3b: 사람 그리드, 페이지 헤더, 증명 밴드, 이벤트, 기부, 양식에 대한 검증된 레시피 |
references/palettes.json | 선별된 팔레트 라이브러리(draw.mjs가 읽음, 탐색 가능) |
references/tells.md | 2b, 2f, 4단계: AI 패턴(1-3세대) 및 서명과 출처 |
references/typography.md | 2g: 글꼴 절차, 출처, 라이선스, 스케일 |
references/process-notes.md | 익스프레시브 모드: 카드 해석, 작업 예제 |
templates/DESIGN.md | 2g |