Kami: AI 에이전트가 만든 문서에 일관된 시각 정체성을 부여하는 디자인 시스템

9bow · 5월 20, 2026, 6:30오전

Kami 소개

Kami(紙, かみ)는 AI 에이전트가 만들어 내는 문서, 슬라이드, 이력서, 랜딩 페이지에 일관된 시각적 정체성을 부여하기 위한 "조용한" 디자인 시스템입니다. 일본어로 종이를 뜻하는 이름처럼, 완성된 아이디어가 정착하는 표면을 정의하는 데 초점을 둡니다. AI는 이미 사람이 직접 다듬는 것보다 더 빠르게 긴 문서를 작성할 수 있지만, 회마다 다른 회색 톤과 들쭉날쭉한 레이아웃이 결과의 신뢰도를 깎습니다. Kami는 그 빠진 부분을 채우기 위해 한 가지 제약 언어, 10가지 템플릿, 그리고 에이전트가 안정적으로 따를 수 있을 만큼 단순하면서도 매번 같은 결과를 보장할 만큼 엄격한 규칙 집합을 제공합니다.

Kami는 tw93가 만든 도구 3부작 중 마지막 작품으로, 코드를 쓰는 Kaku(書く), 습관을 단련하는 Waza(技)와 짝을 이룹니다. 첫 출발점은 저자가 Claude에게 미국 주식 리서치 리포트를 부탁할 때마다 똑같은 기본 문서 디자인이 나오는 답답함이었습니다. 타이포그래피, 팔레트, 여백을 한 가지 규칙씩 정돈해 가다 보니 어느 순간 슬라이드, 강의 자료, 인포그래픽까지 모두 같은 톤으로 정리되는 디자인 언어가 만들어졌고, 그 결과가 지금의 Kami가 되었습니다. 영어와 중국어가 1급 시민이고, 일본어는 CJK 폰트 폴백을 통한 최선의 결과를 제공합니다.

기본 단위는 따뜻한 양피지 색의 캔버스(#f5f4ed), 단 하나의 강조색인 잉크 블루(#1B365D), 그리고 본문 전체를 책임지는 단일 세리프 폰트입니다. 그림자는 부드러운 링이나 속삭이는 정도로만 허용되며, 푸른 회색이나 두 번째 색조는 의도적으로 배제됩니다. 이러한 제약은 화려함을 줄이는 대신 본문이 "대시보드"가 아닌 "조판된 페이지"로 읽히게 만들고, 결과적으로 AI 에이전트가 만든 자료에도 출판물 같은 신뢰감을 부여합니다.

Kami가 제공하는 10가지 템플릿

Kami는 다음 10종의 템플릿을 제공해, 자주 쓰이는 문서 유형을 빈 페이지에서 시작하지 않게 합니다. 각 템플릿은 같은 제약 시스템을 공유하므로 문서 종류가 달라져도 시각적 일관성이 유지됩니다.

카테고리	용도
One-Pager	스타트업 한 장 요약, 제품 소개
Long Doc	장문 리서치 보고서, 백서
Letter	공식 서신, 안내
Portfolio	작품집, 프로젝트 갤러리
Resume	이력서, 1~2 페이지 자기소개
Slides	발표용 슬라이드, 키노트
Equity Report	주식 리서치 리포트(Tesla Q1 2026 등 데모 수록)
Changelog	릴리스 노트, 변경 이력
Landing Page (EN / CN)	영문 및 중문 제품 랜딩 페이지

데모로 함께 공개된 Tesla 1분기 재무 리포트는 표지, 차트, 인용, 인포그래픽이 한 화면에 동시에 배치되었음에도 정돈된 톤을 잃지 않는 좋은 예시입니다.

또한 14종의 인라인 SVG 다이어그램을 기본 제공해 그래프, 흐름도, 타임라인 등을 별도 디자인 도구 없이 그릴 수 있고, 코드 블록은 Pygments 기반 신택스 하이라이팅을 지원합니다. 영문 문서에는 Charter, 중문에는 TsangerJinKai02, 일문에는 YuMincho가 자동 적용됩니다.

Kami의 디자인 제약 시스템

Kami의 제약은 단순히 "이쁘게"를 위한 가이드라인이 아니라, AI 에이전트가 안정적으로 따라갈 수 있도록 명문화된 규칙에 가깝습니다. 주요 규칙은 다음과 같이 표로 정리되어 있습니다.

요소	규칙
Canvas	`#f5f4ed` 양피지색 고정, 순백 사용 금지
Accent	잉크 블루 `#1B365D`만 사용, 두 번째 색조 금지
Neutrals	노랑-갈색 톤의 따뜻한 중성색, 푸른 회색 금지
Serif	본문 400, 헤딩 500. 합성 볼드 사용 금지
Line-height	제목 1.1~1.3, 본문 1.4~1.55
Shadows	링 또는 속삭임 수준만 허용, 강한 드롭 섀도 금지
Tags	단색 hex 배경만 사용 (`rgba()` 는 WeasyPrint 이중 사각형 버그 회피)

이러한 규칙은 references/design.md 와 CHEATSHEET.md 에 풀 사양으로 정리되어 있으며, 다른 그리기 도구에 그대로 브리프(brief)로 전달할 수 있도록 의도되었습니다. README의 "Apply the Kami design system from Kami/references at main · tw93/Kami · GitHub" 한 줄만 ChatGPT Images 2.0 같은 모델에 넘기면, 동일한 양피지 톤과 잉크 블루 강조, 단선 기하 아이콘으로 인포그래픽이 그려지는 데모가 공개되어 있습니다.

Kami의 설치 및 사용법

Kami는 Claude Code, Claude Desktop, 그리고 ~/.agents/ 디렉토리에서 스킬을 읽는 범용 에이전트(Codex, OpenCode, Pi 등)를 모두 지원합니다. 별도 슬래시 명령이 필요 없도록, 자연어 요청("make a one-pager", "帮我做一份简历")에 의해 자동으로 트리거되는 스킬 형태로 배포됩니다.

# Claude Code (스킬 설치 도구 사용)
npx skills add tw93/kami -a claude-code -g -y

# Codex, OpenCode, Pi 등 ~/.agents/ 기반 에이전트 전체
npx skills add tw93/kami -a '*' -g -y

Claude Desktop을 사용하는 경우, 릴리스 페이지에서 kami.zip 을 내려받아 Customize > Skills > "+" > Create skill 메뉴에서 압축 파일을 그대로 업로드하면 됩니다. 중문 폰트는 로컬 체크아웃 또는 jsDelivr CDN에서 자동 로딩되어 초기 설치 패키지를 가볍게 유지합니다.

마지막으로, Kami가 제공하는 선택적인 옵션인 ~/.config/kami/brand.md 에 본인의 정체성, 브랜드 색, 톤, 기본 통화 등을 YAML frontmatter + 자유 텍스트로 적어두면 Kami가 모호한 요청에 대해서만 이 컨텍스트를 적용합니다. 매번 같은 정보를 다시 주지 않아도 되면서, 각 문서가 무리하게 비슷해 보이지 않도록 우선순위가 가장 낮은 컨텍스트로 사용됩니다.

언어별 자연어 예시는 다음과 같습니다:

English: make a one-pager for my startup, design a slide deck for my talk, build a landing page for my app
中文: 帮我做一份一页纸, 帮我做一份简历, 帮我做一个产品落地页
日本語: スタートアップ向けの一枚資料を作って, 履歴書を作って, アプリのランディングページを作って

Kami의 라이선스

Kami의 코드와 템플릿은 MIT 라이선스로 공개되어 있어 개인 및 상업적 용도로 자유롭게 사용하고 기여할 수 있습니다. 다만 중문 본문에 사용되는 TsangerJinKai02 폰트는 개인 용도에만 무료이며, 상업적 용도로 사용하려면 별도 라이선스 가 필요합니다. 영문 Charter, 일문 YuMincho, 그리고 CJK 폴백 폰트는 시스템 번들 또는 오픈 라이선스를 따릅니다.

Kami 공식 홈페이지

Kami 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~