스프쌤
오픈소스

tw93의 Kami, AI 에이전트 문서 출력을 바꾸는 조판 디자인 시스템

✍ 야금야금⏱ 19분 소요2026-10-18👁
← 목록으로 돌아가기

매번 그라디언트 범벅이거나 삭막한 기본 서식으로 흩날리던 AI 생성 문서에 단행본 인쇄소의 조판 제약이 적용된다면 어떨까요?

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: 오픈소스 AI 에이전트 조판 스킬 tw93/Kami 아키텍처 및 활용

✦ KR 핵심 요약: Kami는 AI 에이전트가 생성하는 문서의 시각적 무질서를 해결하기 위해 설계된 오픈소스 조판 시스템입니다. 순백색을 배제한 양피지 색조와 단 하나의 잉크 블루 색상, 본명조 기반의 타이포그래피 제약을 통해 PDF, PNG, 편집 가능한 파워포인트를 자연어 명령만으로 결손 없이 생성합니다.

🌐 Global Takeaway: tw93/Kami is an open-source layout design system and agent skill that enforces publication-grade typesetting constraints onto AI agent outputs. By replacing erratic styles with disciplined warm-tone paper palettes, strict serif hierarchies, and native SVG diagrams, it enables automated export of presentation-ready PDFs and editable PowerPoint slides.

아래 비교는 생성형 AI의 일반적인 문서 출력 방식과 Kami 조판 시스템이 취하는 구조적 차이를 보여줍니다.

일반 LLM 마크다운 출력 vs Kami 기반 에이전트 조판
일반 LLM 마크다운
  • 세션마다 임의로 바뀌는 CSS 스타일링
  • 형광 그라디언트와 순백색(#fff) 캔버스 남발
  • 페이지 경계 무시로 PDF 인쇄 시 요소 잘림
  • 서체 계층 부재 및 폰트 렌더링 깨짐
VS
Kami 조판 시스템
  • 양피지 배경(#f5f4ed)과 단일 액센트 잉크 블루
  • 8~9종의 정형화된 규격 문서 템플릿 내장
  • PDF·PNG·편집 가능한 PPT 즉시 출력
  • 본명조 기반 다국어 타이포그래피 및 SVG 차트
단순 텍스트 덤프와 인쇄용 레이아웃 엔진의 결과물 통제력 차이
tw93 엔지니어링 에이전트 트릴로지 구조
1층: Waza (技)엔지니어링 습관과 문제 해결 규칙을 에이전트 행동 양식으로 훈련
2층: Kaku (書く)엄격한 논리와 아키텍처 규칙에 기반한 프로덕션 소스 코드 작성
3층: Kami (紙)산출물을 단행본과 공문 수준의 완성도로 정착시키는 시각 조판 레이어
발상부터 코드 구현, 최종 인쇄 문서 전달까지 이어지는 3단계 스택

1. AI 생성 문서의 고질적인 시각적 혼란

대규모 언어 모델(LLM)과 자율 에이전트의 발전으로 초안 작성, 기술 명세서 작성, 재무 분석 리포트 생성에 들어가는 시간은 획기적으로 줄어들었습니다. 그러나 결과물의 형태를 들여다보면 또 다른 병목이 발생합니다. 에이전트가 산출하는 결과물은 대개 두 가지 극단적인 양상 중 하나로 귀결됩니다. 시스템 기본 서식에 갇힌 건조하고 무미건조한 흑백 마크다운 텍스트이거나, CSS 프레임워크가 무분별하게 적용되어 과도한 네온 그라디언트와 화려한 섀도가 난무하는 이른바 'SaaS 랜딩 페이지 스타일'의 왜곡입니다.

이러한 결과물은 실제 비즈니스 미팅, 투자 유치, 경영진 보고 자리에서 그대로 활용하기 어렵습니다. 종이나 스크린 위에 정착되어야 할 중요한 지표와 전략이 일관되지 않은 마진, 어긋난 서체 크기, 세션마다 달라지는 색채 규격 때문에 신뢰도를 잃기 때문입니다. 생성형 AI 모델이 지닌 추론 능력과 코드 작성 능력은 프로덕션 수준에 도달했으나, 이를 외부에 전달하는 '시각적 패키징' 단계는 여전히 사용자가 수작업으로 파워포인트를 열고 복사해 붙여넣는 후가공에 머물러 있었습니다.

오픈소스 생태계에서 활동하는 개발자 tw93는 바로 이 간극에 주목했습니다. 주식 분석 리포트나 기술 백서를 에이전트로 뽑아낼 때마다 매번 형태가 뒤틀리는 현상을 방지하기 위해, 에이전트 전용 조판 규격인 Kami(紙, かみ)를 설계하여 공개했습니다. Kami는 임의적인 스타일링을 허용하는 것이 아니라 오히려 철저한 제약을 부과함으로써, AI가 뽑아낸 콘텐츠에 단행본과 전문 정기간행물 수준의 권위를 부여합니다.

2. Kami가 정의하는 디자인 제약 시스템

Kami는 일반적인 UI 컴포넌트 라이브러리나 웹 디자인 프레임워크가 아닙니다. 그것은 '종이 위에 잉크로 인쇄되는 물리적 매체'의 미학을 디지털 에이전트 환경으로 옮겨온 강력한 제약 시스템(Constraint System)입니다. 디자인 자유도를 무한히 열어둘 경우 LLM은 일관성을 상실하지만, 명확하고 단단한 규칙을 바운더리로 설정해 두면 에이전트는 규칙 안에서 완벽한 조화를 찾아냅니다.

Kami의 시각 규칙은 철저하게 통제된 색채와 여백, 활자 계층에 기반합니다. 가장 두드러진 특징은 컴퓨터 모니터의 차가운 순백색(#FFFFFF)을 단호히 배제한다는 점입니다. 실제 고급 서적에 쓰이는 양피지 느낌의 웜톤 캔버스를 기본 바탕으로 삼고, 시선을 분산시키는 다채색 팔레트를 차단합니다.

Kami 디자인 제약 매트릭스
조형 및 공간 규칙
색채 절제
  • #f5f4ed 웜톤 양피지 베이스
  • 단일 액센트 잉크 블루(#1B365D)
  • 형광·네온 색상 원천 금지
명도 통제
  • 순백색(#ffffff) 캔버스 배제
  • 모든 중간 톤 웜 그레이 통일
  • 쿨 블루-그레이 사용 제한
서체 계층
  • 세리프 본문 400 레귤러
  • 제목 500 미디엄 절제
  • 인위적 인조 볼드 사용 지양
공간 제약
  • 하드 드롭 섀도 전면 금지
  • 미세 Ring 효과 중심 외곽선
  • 인라인 SVG 데이터 차트 내장
색채 및 명도 체계
시각적 혼란을 억제하고 신뢰도를 극대화하는 4대 제약 축

2-1. 양피지 캔버스와 단일 액센트의 미학

Kami가 허용하는 캔버스 배경색은 웜톤의 은은한 질감을 지닌 #F5F4ED입니다. 이는 장시간 문서를 검토하는 독자의 눈에 가해지는 피로를 줄여줄 뿐 아니라, 무채색 디지털 텍스트 덤프와 명확히 구분되는 물리적 인쇄물의 정체성을 만들어냅니다.

더욱 인상적인 대목은 액센트 색상의 취급 방식입니다. 대다수 디자인 시스템이 서브 컬러와 하이라이트 컬러 등 다단계 색채 구조를 두는 것과 달리, Kami는 오직 '잉크 블루(#1B365D)' 단 하나의 강조색만을 허용합니다. 두 번째 액센트 색상은 시스템 차원에서 허용되지 않습니다. 모든 중립 계열 색상 또한 푸른빛이 도는 쿨 그레이를 금지하고 따뜻한 웜 그레이만을 적용하여, 문서 전체의 온도를 단단하게 결속합니다.

타이포그래피 역시 화려함보다는 가독성과 판형의 질서에 집중합니다. 본문은 세리프 계열 서체의 레귤러 두께(웨이트 400)를 표준으로 하며, 섹션 헤딩과 주요 제목은 미디엄(웨이트 500)으로 무게중심을 잡습니다. 소프트웨어가 글꼴을 억지로 굵게 만드는 '가상 볼드(Faux Bold)'를 엄격히 금지하여 글립 고유의 비례와 획 대비를 보호합니다. 요소의 입체감을 표현할 때도 인위적인 하드 드롭 섀도(Hard Drop Shadow)를 일절 배제하고, 얇은 경계 링(Ring)이나 극도로 미세한 블러 효과만을 사용합니다.

3. 지원 문서 템플릿과 인라인 다이어그램 구조

Kami는 추상적인 디자인 철학에 그치지 않고, 에이전트가 현실 업무에서 즉각 출력해 낼 수 있는 완성형 템플릿 규격을 내장하고 있습니다. 단순한 서식 모음이 아니라 페이지 경계, 격자(Grid) 구조, 텍스트와 그래픽 간격이 픽셀 단위로 사전 계산된 레이아웃 엔진입니다.

현재 Kami 시스템이 지원하는 대표적인 문서 템플릿 유형과 활용 목적은 아래와 같이 정밀하게 나뉩니다.

문서 유형 (Template) 주요 목적 및 구조적 특징 출력 형태
One-Pager 스타트업 소개, 신규 기능 요약, 단일 페이지 압축 보고 PDF, PNG
Long Doc 심층 연구 보고서, 리서치 페이퍼, 분기 실적 총괄 분석 PDF, PNG
Formal Letter 파트너십 제안서, 추천서, 최고경영자 비즈니스 서신 PDF, PNG
Portfolio 개발 프로젝트 모음집, 아키텍처 작품집, 쇼케이스 PDF, PNG
Resume 시니어 엔지니어·파운더용 2페이지 압축 이력서 PDF, PNG
Slides 키노트 및 콘퍼런스 발표용 덱 (8슬라이드 규격 등) PPT (편집 가능), PDF
Equity Report 종목 분석 및 재무 지표 리뷰 (Tesla Q1 실적 스타일) PDF, PNG
Changelog 소프트웨어 버전 릴리스 노트 및 마일스톤 정리 PDF, PNG

템플릿 외에도 엑스(X, 구 트위터)나 인스타그램 같은 소셜 미디어에 공유할 수 있는 소셜 카드 규격을 기본 제공합니다. 먹물(Ink), 소나무(Pine), 진홍(Crimson) 등 8가지 종이 색상을 바탕으로 텍스트와 카드 요소를 시각적으로 갈무리할 수 있습니다.

3-1. 외부 도구가 필요 없는 6종 SVG 인라인 시각화

문서 내부에 수치 데이터나 시스템 구조를 도식화할 때 외부 차트 생성 도구나 웹 렌더러를 경유하면 파이프라인이 복잡해지고 결과물이 깨지기 쉽습니다. Kami는 이 문제를 해결하기 위해 문서 렌더링 엔진 내부에서 직접 계산되어 그려지는 6가지 인라인 SVG 다이어그램을 기본 탑재했습니다.

  • 바 차트(Bar Chart): 카테고리별 실적 및 성능 지표 단순 비교
  • 선 그래프(Line Chart): 시간 흐름에 따른 시계열 지표 및 성장 추세
  • 도넛 차트(Donut Chart): 매출 구성비, 지분율, 예산 배분 구조 표현
  • 시스템 아키텍처(Architecture): 마이크로서비스 및 컴포넌트 간 연결 다이어그램
  • 플로우차트(Flowchart): 단계별 승인 절차, 알고리즘 분기 파이프라인
  • 사분면 매트릭스(Quadrant): 시장 포지셔닝 맵 및 2×2 우선순위 평가 격자

에이전트는 텍스트뿐만 아니라 수치 데이터를 해석한 뒤, 이 6종의 벡터 SVG 중 가장 적합한 양식을 골라 문서 안쪽에 한 치의 오차도 없이 삽입합니다. 이는 비트맵 이미지처럼 확대 시 글자가 흐려지지 않고, 인쇄 시에도 칼날 같은 선명도를 유지하는 원천이 됩니다.

4. 엔지니어링 에이전트 3부작: Kaku, Waza, Kami의 연계

Kami는 단독으로 튀어나온 유틸리티가 아닙니다. 오픈소스 개발자 tw93가 오랫동안 구축해 온 AI 엔지니어링 에이전트 3부작(Trilogy)의 최종 전달(Delivery) 레이어에 해당합니다. AI가 사람의 지시를 받아 소프트웨어를 구축하고 보고서를 작성하는 일련의 흐름을 기능별로 완전히 분리하여 전문화한 아키텍처입니다.

"좋은 내용은 좋은 종이를 누릴 자격이 있다(Good content deserves good paper). 논리적으로 빈틈없는 기술적 결과물이라도, 시각적으로 설득력을 갖추지 못하면 진정한 가치를 온전히 전달받지 못한다."

첫 번째 축인 Waza (技)는 엔지니어의 숙련된 습관과 디버깅 원칙, 문제 해결 패턴을 에이전트의 내부 행동 양식으로 훈련시키는 스킬입니다. 코드를 무작정 작성하기 전에 요구사항을 검증하고, 실패 테스트를 먼저 작성하도록 유도하는 엔지니어링 태도를 규정합니다.

두 번째 축인 Kaku (書く)는 실질적인 코드 작성 도구입니다. 엄격한 아키텍처 원칙과 타입 안정성을 유지하면서 복잡한 비즈니스 로직을 군더더기 없는 프로덕션 코드로 직조해 내는 역할을 맡습니다.

마지막 축인 Kami (紙)는 앞선 두 단계에서 도출된 방대한 지적 산출물과 통계, 아키텍처 명세를 실제 사람의 손에 쥐어지는 종이(또는 슬라이드)의 형태로 변환해 내는 조판 책임자입니다. 논리적 엄밀함(Waza)과 정교한 구현(Kaku) 위에 단정한 인쇄 미학(Kami)이 얹어짐으로써, AI 에이전트의 결과물은 비로소 완전한 프로페셔널 산출물로 완성됩니다.

자연어 프롬프트 기반 자동 조판 파이프라인
의도 분석자연어 요청을 감지해 이력서, 제안서, 보고서 등 문서 유형 판별
→
템플릿 매핑내장된 8~9종 레이아웃 규칙 및 페이지 격자 시스템 로드
→
인라인 시각화수치 데이터를 바·도넛·플로우차트 등 6종 SVG 그래픽으로 조립
→
최종 출력인쇄 규격 PDF, 공유용 PNG, 편집 가능한 PowerPoint 파일 렌더링
슬래시 명령어 없이 의도를 분석해 적합한 템플릿과 벡터 그래픽을 엮어내는 흐름

5. 설치 환경 및 에이전트 연동 실무

Kami는 복잡한 빌드 과정이나 데몬 실행을 요구하지 않습니다. 에이전트 스킬 생태계의 표준화된 패키지 관리 도구인 skills를 통해 단 한 줄의 명령어로 글로벌 환경에 설치할 수 있습니다. Claude Code, OpenAI Codex, Cursor 등 에이전트 실행 환경에 맞춰 옵션을 지정할 수 있으며, MIT 라이선스로 배포되어 상업적 프로젝트나 엔터프라이즈 환경에서도 제약 없이 통합 가능합니다.

5-1. 환경별 CLI 설치 명령어

에이전트 환경에 따라 터미널에서 다음 명령어를 입력하면 저장소 클론과 스킬 등록이 자동으로 이루어집니다.

# Claude Code 전용 설치
npx skills add tw93/kami -a claude-code -g -y

# OpenAI Codex 전용 설치
npx skills add tw93/kami -a codex -g -y

# Cursor 및 여러 도구를 동시에 지정하는 설치
npx skills add tw93/kami -a claude-code codex cursor -g -y

# ~/.agents/ 디렉터리를 참조하는 범용 에이전트 전체 등록
npx skills add tw93/kami -a '*' -g -y

GUI 환경인 Claude Desktop을 활용하는 경우에는 GitHub 릴리스 저장소에서 kami.zip 아카이브를 내려받은 뒤, Customize > Skills > + 메뉴를 통해 압축 파일을 업로드하여 활성화할 수 있습니다.

5-2. 자연어 프롬프트를 통한 자동 조판 작동 원리

설치가 완료된 이후 사용자는 별도의 특수 슬래시 명령어(/kami build 등)를 외워서 칠 필요가 없습니다. Kami의 스킬 인터페이스가 에이전트의 시스템 프롬프트 및 컨텍스트에 바인딩되어 있기 때문에, 일상적인 대화형 프롬프트만으로 레이아웃 엔진이 자동 호출됩니다.

  • "내 스타트업 프로젝트를 위한 원페이저 요약서를 만들어줘"
  • "지금까지 분석한 리서치 데이터를 단행본 롱독 형식으로 정리해줘"
  • "테슬라 1분기 실적을 바탕으로 주식 분석 리포트를 작성해줘"
  • "컨퍼런스 발표를 위해 8페이지 슬라이드 덱을 구성하고 매출 도넛 차트를 넣어줘"

에이전트는 사용자의 프롬프트에서 문서의 목표와 성격을 파악하고, 내장된 템플릿 중 가장 적절한 격자 규격을 스스로 선택합니다. 본문 텍스트를 구성한 후에는 양피지 캔버스 규격에 맞춰 인라인 SVG를 렌더링하고, 최종적으로 인쇄 가능한 PDF, 공유용 PNG, 그리고 키노트나 프레젠테이션용으로 직접 수정이 가능한 .pptx 파워포인트 파일 형태로 디스크에 안전하게 내려놓습니다.

6. 다국어 지원 현황과 한국어 폰트 대체 구조

Kami는 글로벌 오픈소스 프로젝트답게 영어(English), 중국어 간체(中文), 대만 번체(繁體), 일본어(日本語), 한국어, 독일어(Deutsch), 프랑스어(Français) 등 7개 언어권의 기본 현지화 문서를 지원합니다. 각 언어가 지닌 고유의 조판 전통과 글꼴 너비를 고려하여 레이아웃이 붕괴되지 않도록 미세 조정 규칙이 포함되어 있습니다.

한국어 환경의 경우 본명조(Noto Serif KR) 서체를 폰트 스택의 최우선 순위에 배치하도록 설계되어 있습니다. 국문 인쇄물 특유의 단정한 정서와 긴 호흡의 글 읽기에 최적화된 명조 계열을 기저에 둠으로써, 고딕 일색의 일반적인 웹 문서와는 확연히 다른 고전적인 인쇄물 질감을 연출합니다. 폰트 누락 시 시스템 기본 세리프 서체로 부드럽게 이어지는 대체(Fallback) 메커니즘과 자간·행간 점검 로직이 포함되어 있습니다.

다만 개발자 tw93가 명시했듯, 시각적 조판 완성도 측면에서는 원작자의 집중 검수가 이루어진 영어와 중국어 레이아웃이 한국어보다 상대적으로 더 정교하게 다듬어져 있습니다. 한글은 영문 대비 글자당 시각적 밀도가 높고 받침 구조로 인해 행간 여백이 좁아 보일 수 있으므로, 대량의 텍스트를 Long Doc으로 출력할 때는 줄바꿈 지점(Word Break)과 문단 간격이 의도대로 인쇄되었는지 육안으로 최종 검토하는 단계가 권장됩니다.

7. Kami 도입 시 고려해야 할 현실적 한계와 제약

Kami가 제공하는 고도의 제약 시스템은 문서의 품질 하한선을 보장하는 강력한 도구이지만, 반대로 모든 상황에 만능으로 들어맞는 은총알은 아닙니다. 실제 프로덕션 워크플로에 도입하기 전 반드시 고려해야 할 명확한 경계가 존재합니다.

  1. 브랜드 아이덴티티(BI) 커스터마이징의 엄격한 한계
    Kami의 철학은 '양피지 톤과 단 하나의 잉크 블루'라는 극단적인 절제에 기초합니다. 따라서 회사의 공식 CI/BI 색상이 마젠타, 옐로, 혹은 쿨 네온 블루인 경우, 이를 Kami 템플릿에 강제로 주입하면 시스템의 미학적 균형이 깨집니다. 기업 고유의 엄격한 디자인 가이드라인을 100% 충족해야 하는 대외 마케팅용 브로슈어로는 적합하지 않으며, 투자 제안서·엔지니어링 명세서·분석 보고서 등 신뢰도 중심의 실무 문서에 가장 최적화되어 있습니다.

  2. 편집 가능한 PPT 출력 시 서체 의존성
    PDF나 PNG 출력물은 폰트가 임베딩되거나 벡터 래스터화되어 전달되므로 수신자의 기기 환경에 영향을 받지 않습니다. 그러나 파워포인트(.pptx) 형태로 추출할 경우, 결과물을 열람하고 수정하는 로컬 PC에 해당 세리프 서체가 설치되어 있지 않으면 기본 시스템 서체(맑은 고딕, 에이리얼 등)로 강제 치환되어 레이아웃이 틀어질 수 있습니다. 최종 배포 전 로컬 환경의 서체 종속성을 반드시 점검해야 합니다.

  3. 에이전트 추론 비용과 콘텍스트 소비
    Kami는 템플릿 조판 규칙과 SVG 렌더링 명세를 에이전트의 프롬프트 컨텍스트에 적재합니다. 이는 매우 단순한 단답형 질의응답 대비 에이전트의 입력 토큰 소모량을 증가시키며, 초소형 온디바이스 모델보다는 Claude 3.5 Sonnet이나 GPT-4o 급의 정밀한 지시 이행 능력을 갖춘 상위 모델에서 최적의 조판 품질을 보장합니다.

8. 요약 및 실무 적용을 위한 제언

소프트웨어 엔지니어링과 데이터 분석 영역에서 AI 에이전트의 역할은 단순 조수를 넘어 실질적인 산출물을 납품하는 협업자로 격상되었습니다. 이러한 흐름 속에서 Kami(紙)의 등장은 시사하는 바가 큽니다. 에이전트가 만든 콘텐츠의 가치를 온전히 입증하는 마지막 열쇠는 더 많은 텍스트가 아니라, 사람이 신뢰하고 몰입할 수 있도록 빚어낸 시각적 완성도에 있기 때문입니다.

터미널 환경에서 일하는 개발자, AI를 활용해 분기 보고서를 정기적으로 발행해야 하는 애널리스트, 복잡한 시스템 아키텍처를 투자자에게 명료한 원페이저로 보여주어야 하는 창업자라면 Kami는 매우 실용적인 무기가 됩니다. npx skills add tw93/kami 한 줄로 로컬 에이전트 파이프라인에 조판 장인을 영입해 보십시오. 아무렇게나 흩뿌려지던 마크다운 텍스트가 단정한 양피지 위에 책처럼 내려앉는 변화를 즉시 체감할 수 있습니다.

자주 묻는 질문

Q. Kami를 사용하려면 별도의 유료 구독이나 라이선스 구매가 필요한가요?
A. 필요하지 않습니다. Kami는 MIT 라이선스로 공개된 오픈소스 프로젝트로, 개인 및 기업 환경에서 무료로 자유롭게 수정하고 배포할 수 있습니다.

Q. 기존 파워포인트나 캔바(Canva) 템플릿과 비교할 때 가장 큰 차별점은 무엇인가요?
A. 인간 디자이너가 마우스로 요소를 드래그하는 도구와 달리, AI 에이전트가 자연어 맥락을 이해하고 레이아웃 규칙에 맞춰 PDF, PNG, 편집 가능한 PPT 파일을 스스로 렌더링해 낸다는 점이 결정적인 차이입니다.

Q. 한국어 보고서를 작성할 때 폰트가 깨지거나 줄바꿈이 어색하지 않나요?
A. 기본적으로 본명조(Noto Serif KR)를 기반으로 하는 폰트 대체 및 레이아웃 점검 구조를 갖추고 있습니다. 다만 영어나 중국어에 비해 복합 단어 줄바꿈 처리가 빡빡할 수 있으므로 최종 출력물의 문단 여백을 확인하는 것을 권장합니다.

원본

https://github.com/tw93/Kami

https://discuss.pytorch.kr/t/kami-ai/10278

https://aisparkup.com/wiki/kami

함께 보면 좋은 글

댓글 0개