Communitygithub.com

agency-of-one

에이전트가 '원스톱 에이전시(agency of one)'처럼 아트 디렉션을 하고 최종 산출물로 로고와 소규모 브랜드 시트를 제작하도록 안내합니다. 이 절차는 Agency of One, 존재 이유, 모드를 통해 진행됩니다. 새로운 작업이 이러한 기법을 필요로 할 때 사용하세요.

agency-of-one란 무엇인가요?

이 스킬은 AI 에이전트가 단순한 웹사이트 생성자가 아닌, 마치 최고의 에이전시처럼 작동하여 클라이언트의 브랜드에 완벽하게 맞는 고품질 로고와 브랜드 시트를 제작하도록 설계되었습니다. 기존의 AI가 생성하는 뻔한 디자인 패턴을 피하고, 클라이언트의 기존 브랜드 자산(로고, 사진, 전략)을 최우선으로 활용합니다. Claude Code, Cursor, Codex와 같은 터미널 기반 AI 코딩 도구에서 사용할 수 있으며, `draw.mjs` 스크립트를 통해 무작위성과 브랜드 일관성을 동시에 확보하고, 독립적인 비평가를 통해 디자인 방향의 전형성과 강도를 평가합니다. 또한 `craft.md`에 정의된 장인 정신 기준과 lint, plan-diff 등의 자동화된 검증을 통해 최종 결과물이 세계적인 수준의 마감과 미적 기준을 충족하도록 보장합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sam-pop/agency-of-one/tree/HEAD/skills/agency-of-one

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Agency of One

존재 이유

웹사이트를 요청하면 모델은 가장 확률이 높은 웹사이트를 생성합니다. 그런 모양을 금지하면 다음 확률이 높은 모양(크림 + 세리프 + 클레이, 블랙 + 애시드 그린, ALL-CAPS 눈썹, 링크의 →: 2차 물결 패턴)으로 이동할 뿐입니다. 그리고 '창의적'인 것이 해결책도 아닙니다. 비즈니스 사이트는 탁월한 에이전시가 만든 듯, 신뢰할 수 있고 세련되며 모든 것이 조화를 이루어야 합니다.

우선 순위: 1) 아름답고 클라이언트에게 적합함, 2) 명확하고 신뢰할 수 있음, 3) 차별적임(AI처럼 보이지 않음). AI 패턴을 피하는 것은 필요 조건이지만 충분 조건은 아닙니다. 차별적이지만 평범하거나 브랜드에 맞지 않는 페이지는 실패한 것입니다.

따라서 이 스킬은 클라이언트가 이미 가지고 있는 브랜드에서 시작하여, 가장 위험한 선택지를 빌더에게서 제거하고, 출력물을 세계적 수준의 마감과 미적 기준으로 유지합니다:

  1. 클라이언트의 브랜드와 자산 우선, 그다음 전략: 로고 색상, 실제 사진, 참조 자료, 포지셔닝, 증거, 브랜드 아이디어.
  2. 실제 무작위성, 브랜드 고정 색상: 스크립트가 레버(구성, 브랜드 장치, 팔레트 전략, 타이포그래피 전략)를 결정합니다. 색상은 로고가 있을 경우 클라이언트의 로고에서 가져오고, 그렇지 않으면 선별되고 대비가 확인된 팔레트 라이브러리에서 가져오며, 절대 모델의 취향에서 가져오지 않습니다.
  3. 독립적인 비평가가 다섯 가지 방향에 대해 전형성 및 강도를 평가합니다. 스크립트가 비전형적이면서 강한 방향을 선택합니다.
  4. 장인 정신 기준(craft.md)과 영웅 셋 피스를 먼저 독립적으로 구축합니다.
  5. 반박할 수 없는 검사: 모든 편집에 대한 린트, 렌더링된 측정, 계획 대 렌더링 비교, 교차 프로젝트 메모리, 렌더링된 미적 검사, 그리고 먼저 바람직성과 브랜드 적합성을 평가한 다음 장인 정신과 차별성을 평가하는 블라인드 리뷰어.

규칙이 충돌할 때 이 순서가 우선합니다: 클라이언트의 브리프와 브랜드 자산 > 아름다움(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)

  1. 실제 자산: 먼저 요청(agency.md 0단계). 로고, 사람 사진, 바이오 정보, 클라이언트 이름 또는 사례 연구, 연락처 및 법적 세부 정보, 실제 숫자, 제품 스크린샷. 블라인드 리뷰에서 디자인이 아무리 좋아도 이러한 자산이 없으면 신뢰성과 이미지가 약 6/10에서 멈춥니다. 누락된 항목은 전문적인 슬롯(agency.md 5단계)이 되며, 보고서는 무엇을 제공해야 하는지로 시작합니다.
  2. 이미 가지고 있는 브랜드(agency.md 0a단계). 로고, 문장, 기존 사이트 또는 사람 사진이 있으면 node $S/scripts/brand-extract.mjs를 실행하세요(자동 발견되거나 경로 전달 가능). .design-review/brand.json을 작성합니다. 이후 draw.mjs는 자동으로 브랜드 고정되며 plan-diff는 로고 색상을 잃는 모든 팔레트를 실패 처리합니다. 참석: 한 줄로 사용자에게 추출된 브랜드 색상을 확인하세요. 브랜드 고유 색상과 절대 싸우지 마세요.
  3. 참조 자료 (참석): 클라이언트가 아름답다고 생각하는 2-3개의 사이트를 요청하세요(모든 산업). 스크린샷을 design-references/에 저장하세요. 리뷰어가 이를 기준으로 비교합니다. 이는 모양이 아닌 품질 기준을 설정합니다.
  4. 인간의 취향 (참석 전용): 한 번 물어보세요. "감탄하는 브랜드나 개체 2-3개, 그리고 닮고 싶지 않은 경쟁사 사이트 하나".
  5. 전략 (에이전시 모드, agency.md 1단계): 포지셔닝 문장, 하나의 신념, 유지/파기로 표시된 5가지 카테고리 코드(파기 ≥ 2개), 브랜드 아이디어, '하지만 ~은 아님'이 포함된 성격, 증거 목록(증거를 절대 만들어내지 마세요).
  6. 주제 목록: 클라이언트 세계의 8개 이상의 실제 아티팩트, 장소, 재료, 토착 양식(익스프레시브 모드에서는 12개 이상). 에이전시 모드에서는 이미지 방향, 브랜드 장치 및 카피에 사용되며 의상이 아닙니다.
  7. 영웅 문장과 기본 동작 레이블을 브랜드의 목소리로 작성하세요. 추첨 후에 이를 다듬을 수 있습니다.

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라운드, 최상의 결과 유지)

  1. 먼저 스냅샷: 각 라운드 전에 현재 상태를 커밋(또는 복사)하여 더 나쁜 수정 버전을 롤백할 수 있도록 하세요.
  2. node $S/scripts/slop-lint.mjs: 오류 0개; 모든 경고는 §9 + slop-lint.config.json에서 수정되거나 정당화됨.
  3. node $S/scripts/screenshot.mjs --url <개발 URL> --routes / /about … (또는 정적 파일의 경우 --file index.html about.html …; 모든 페이지, 홈페이지만 아님) --state <이름>=click:<선택자>|hash:<#id>|scroll:<선택자>|hover:<선택자> 모든 시그니처 상태에 대해. 폴드, 모바일 폴드, scroll50 및 상태 샷을 확인하세요.
  4. node $S/scripts/plan-diff.mjs: 로고 색상이 팔레트에 있고, 계획된 글꼴이 로드되었으며, 팔레트가 렌더링되었고, 스케일이 적용되었으며, 계획 외 배경이 없고, 데스크톱 및 390px에서의 아름다움 검사: 애니메이션에 의해 콘텐츠가 보이지 않거나 JS 없이 숨겨지지 않음, 이니셜 아바타 없음, 일관된 사진 그룹(자르기, 크기, 배경), 중앙 정렬된 여러 줄 텍스트 없음, 대문자 레이블 없음, 구분선 없음, 모든 페이지에 설계된 페이지 헤더.
  5. 블라인드 리뷰: design-reviewer 하위 에이전트(agency-of-one:design-reviewer)가 URL 또는 파일, 경로 및 .design-review/만 받습니다. 먼저 바람직성과 브랜드 적합성을 평가한 다음, design-references/가 있으면 이를 기준으로 장인 정신과 차별성을 평가합니다. SHIP하려면 바람직성, 브랜드 적합성 및 모든 장인 정신 축이 ≥ 8이어야 합니다. 여러 페이지 사이트의 평결은 가장 약한 페이지를 기준으로 합니다.
  6. 수정하고 다시 렌더링하세요. 리뷰어가 이전 최고치보다 높게 점수를 매긴 경우에만 수정 버전을 유지하세요. 3라운드 후 중단하고 여전히 열려 있는 사항을 보고하세요.
  7. 미러: 브랜드 아이디어에 도움이 되지 않는 장식 하나를 제거하고 DESIGN.md §11에 기록하세요.
  8. 기록: node $S/scripts/designlog.mjs add --project "…" …check와 동일한 플래그… --media "<추첨 요약>" --signature "<장치 / 셋 피스>" (--log <경로>로 로그를 저장소에 유지).
  9. 보고: 방향(한 줄), 브랜드 아이디어, 셋 피스, lint/plan-diff/리뷰 결과(장인 정신 점수 포함), 열린 예외 사항, 클라이언트가 채우거나 확인해야 하는 모든 슬롯 및 가정.

참조 파일

파일사용 시기
references/agency.md에이전시 모드: 전략, 아이덴티티 시스템, 비즈니스 아키텍처, 슬롯, 신뢰성
references/craft.md3a, 3c, 4단계: 마감 기준, 정렬, 사진 시스템, 페이지 헤더, 점수 매기기
references/patterns.md3b: 사람 그리드, 페이지 헤더, 증명 밴드, 이벤트, 기부, 양식에 대한 검증된 레시피
references/palettes.json선별된 팔레트 라이브러리(draw.mjs가 읽음, 탐색 가능)
references/tells.md2b, 2f, 4단계: AI 패턴(1-3세대) 및 서명과 출처
references/typography.md2g: 글꼴 절차, 출처, 라이선스, 스케일
references/process-notes.md익스프레시브 모드: 카드 해석, 작업 예제
templates/DESIGN.md2g

관련 스킬