블로그로 돌아가기Agentic Coding
astory-blog-writers 완벽 가이드: DNA 기반 하이브리드 저자 시스템과 7인 협업 Crew Mode
27.52분
Claude CodePluginAI WritingCrew ModeBlog WritingMODU AIHybrid Author SystemDNA Traits
Claude Code 플러그인 astory-blog-writers의 DNA 트레잇 시스템, 8개 AI 저자 페르소나, 3가지 작성 모드를 상세히 분석한다. 16개 트레잇 조합으로 256가지 이상의 글쓰기 스타일을 구현하는 하이브리드 저자 시스템의 설계 철학과 실전 활용법을 다룬다.

이 포스트는 astory-blog-writers 플러그인의 Crew Mode로 작성되었다. Creative
Director가 콘텐츠 각도를 설정하고, Research Analyst가 플러그인 아키텍처를 분석하
고, Lead Writer가 초안을 작성하고, Technical Reviewer가 코드와 명령어의 정확성을
검증하고, Reader Advocate가 가독성을 점검하고, Devil's Advocate가 빈틈을 찾아내
고, Editor-in-Chief가 최종 품질을 보증하는 7단계 협업 프로세스를 거쳤다. Crew
Mode가 실제로 어떤 결과물을 만들어내는지 이 포스트 자체가 증명한다.
모두의AI Claude Code Plugin Marketplace
Claude Code는 Anthropic의 공식 CLI 도구다. 터미널에서 Claude와 대화하며 코딩 작
업을 수행할 수 있다. 파일 읽기, 수정, 명령어 실행까지 가능하다. 2024년 말 정식출
시 이후 개발자 커뮤니티에서 빠르게 확산되고 있다.
Claude Code의 플러그인 시스템은 기능을 확장하는 표준화된 방법을 제공한다. 에이전
트, 커맨드, 스킬을 패키지로 묶어 배포할 수 있다. 모두의AI(@MODU-AI)는 이러한 플
러그인들을 한곳에 모아 관리하는 마켓플레이스를 운영한다.
Bash
# 마켓플레이스 등록/plugin marketplace add modu-ai/cc-plugins
이 명령어로 modu-ai/cc-plugins 저장소를 신뢰할 수 있는 플러그인 소스로 등록한다.
마켓플레이스에 등록된 플러그인들은 품질 검증 과정을 거친다.
astory-blog-writers 플러그인 개요
astory-blog-writers는 AI 글쓰기의 고질적 문제를 해결하기 위해 설계된 플러그인이
다. ChatGPT나 Claude로 글을 작성하면 반복되는 AI 문체, 단일 관점의 한계, 번역투
표현이라는 세 가지 문제가 발생한다.
플러그인은 이 문제들을 정면으로 해결한다.
- DNA 기반 페르소나 시스템: 16개 트레잇 조합으로 256가지 이상의 글쓰기 스타일을 구현한다
- Crew Mode: 7명의 전문가가 순차적으로 협업하여 다양한 관점을 반영한다
- Anti-AI Pattern System: 기계적인 표현을 자동으로 탐지하고 수정한다
- 한국어 최적화: 한다체, 해요체, 서사체 등 한국어 문체를 정확히 구현한다
설치 방법
Bash
# 1. 마켓플레이스 등록 (최초 1회)/plugin marketplace add modu-ai/cc-plugins# 2. 플러그인 설치/plugin install astory-blog-writers@moai-cc-plugins --scope project
설치 범위(scope)는 세 가지 옵션을 제공한다.
| Scope | 설명 | 사용 사례 |
|---|---|---|
| user | 본인만 사용 (기본값) | 개인 실험 및 테스트 |
| project | 저장소의 모든 협업자가 사용 | 팀 블로그, 공동 프로젝트 (권장) |
| local | 본인만, 이 저장소에서만 사용 | 특정 프로젝트 전용 설정 |
팀 블로그나 공동 프로젝트에서는
--scope project 옵션을 권장한다. 저장소를 클론
한 모든 협업자가 동일한 글쓰기 도구를 사용할 수 있다.플러그인 구조
Plain Text
astory-blog-writers/├── agents/ # 9개 에이전트│ ├── researcher.md # 리서치 전문 에이전트│ ├── writer-architect.md # Architect 페르소나│ ├── writer-developer.md # Developer 페르소나│ ├── writer-storyteller.md # Storyteller 페르소나│ ├── writer-mentor.md # Mentor 페르소나│ ├── writer-analyst.md # Analyst 페르소나│ ├── writer-reviewer.md # Reviewer 페르소나│ ├── writer-curator.md # Curator 페르소나│ └── writer-columnist.md # Columnist 페르소나├── commands/│ └── post.md # 5단계 워크플로우 커맨드├── skills/│ ├── traits/ # 16개 DNA 트레잇│ ├── personas/ # 8개 프리셋 페르소나│ ├── protocols/ # 3가지 작성 모드│ ├── crew-roles/ # 7개 협업 역할│ ├── research/ # 리서치 시스템│ ├── writing-standards/ # 작성 표준│ └── anti-ai-validator/ # AI 탐지 방지├── CHANGELOG.md├── LICENSE (COPYLEFT)└── README.md
Hybrid Author System 상세 분석
Hybrid Author System은 astory-blog-writers 플러그인의 핵심 아키텍처다. 고정된 프
롬프트 대신 조합 가능한 특성(Trait)을 사용하여 다양한 저자 페르소나를 생성한다.
DNA 트레잇 시스템
시스템은 16개의 원자적 트레잇(Atomic Trait)을 4개 카테고리로 분류한다. 각 카테고
리에서 하나씩 선택하면 독특한 저자 페르소나가 생성된다.
Loading diagram...
Trait DNA Structure - 16개 트레잇이 4개 카테고리로 구성된다
조합 가능한 페르소나 수는 4 x 4 x 4 x 4 = 256가지 이상이다. 실제로는 트레잇 간시
너지와 충돌을 고려하여 8개의 프리셋 페르소나를 제공한다.
트레잇 카테고리 상세
Voice (문체)
| 트레잇 | 한국어 문체 | 특징 | 적합한 콘텐츠 |
|---|---|---|---|
| Formal | 한다체 | 객관적, 권위적 | 기술 문서, 분석 리포트 |
| Conversational | 해요체 | 친근함, 접근성 | 튜토리얼, 입문 가이드 |
| Narrative | 서사체 | 스토리텔링 | 경험담, 케이스 스터디 |
| Technical | 기술체 | 정밀함, 명확성 | API 문서, 레퍼런스 |
Expertise (전문 분야)
| 트레잇 | 초점 영역 | 강점 |
|---|---|---|
| Architecture | 시스템 설계, 구조 | 전체 그림, 설계 철학 |
| Implementation | 실제 구현, 코드 | 실무 팁, 코드 예제 |
| Industry | 시장 동향, 트렌드 | 비즈니스 맥락, 전략 |
| Education | 학습, 교육 | 단계별 설명, 개념 정리 |
Perspective (관점)
| 트레잇 | 접근 방식 | 결과물 특성 |
|---|---|---|
| Analytical | 데이터 기반 분석 | 객관적 평가, 비교 분석 |
| Experiential | 경험 기반 서술 | 실제 사례, 교훈 |
| Critical | 비판적 검토 | 장단점, 대안 제시 |
| Visionary | 미래 전망 | 트렌드 예측, 방향성 |
Tone (어조)
| 트레잇 | 느낌 | 독자 관계 |
|---|---|---|
| Authoritative | 권위적, 확신 | 전문가-학습자 |
| Empathetic | 공감적, 이해 | 동료-동료 |
| Provocative | 도발적, 자극 | 비평가-독자 |
| Nurturing | 격려, 지지 | 멘토-멘티 |
8개 프리셋 페르소나
자주 사용되는 트레잇 조합을 8개 프리셋으로 정의했다.
| 페르소나 | Voice | Expertise | Perspective | Tone | 최적 콘텐츠 |
|---|---|---|---|---|---|
| Architect (아키텍트) | Formal (한다체) | Architecture (설계) | Analytical (분석적) | Authoritative (권위적) | 시스템 설계서, 아키텍처 문서 |
| Developer (개발자) | Conversational (해요체) | Implementation (구현) | Experiential (경험적) | Empathetic (공감적) | 실무 가이드, 코딩 튜토리얼 |
| Storyteller (스토리텔러) | Narrative (서사체) | Implementation (구현) | Experiential (경험적) | Empathetic (공감적) | 경험담, 회고록, 케이스 스터디 |
| Mentor (멘토) | Conversational (해요체) | Education (교육) | Experiential (경험적) | Nurturing (양육적) | 입문 가이드, 초보자 튜토리얼 |
| Analyst (분석가) | Formal (한다체) | Industry (산업) | Analytical (분석적) | Authoritative (권위적) | 트렌드 분석, 기술 리포트 |
| Reviewer (리뷰어) | Conversational (해요체) | Implementation (구현) | Critical (비판적) | Authoritative (권위적) | 도구 리뷰, 비교 분석 |
| Curator (큐레이터) | Formal (한다체) | Industry (산업) | Analytical (분석적) | Authoritative (권위적) | 뉴스 요약, 주간 동향 |
| Columnist (칼럼니스트) | Mixed (혼합체) | Industry (산업) | Critical (비판적) | Provocative (도발적) | 오피니언, 칼럼 |
이 포스트는 Architect 페르소나를 기반으로 작성되었다. Formal(한다체) 문체로 객관
적 서술을 유지하고, Architecture(설계) 관점에서 시스템 구조를 분석하며,
Analytical(분석적) 시각으로 데이터를 제시하고, Authoritative(권위적) 어조로 전문
성을 전달한다.
3가지 작성 모드 비교
플러그인은 상황에 맞는 세 가지 글쓰기 모드를 제공한다.
Solo Mode
특징: 단일 페르소나가 처음부터 끝까지 일관되게 작성한다.
소요 시간: 5-10분
적합한 상황:
- 짧은 글 (1,000-3,000자)
- 빠른 초안 작성
- 일관된 톤 유지가 중요한 콘텐츠
장점:
- 빠른 결과물
- 일관된 문체
- 토큰 사용량 최소화
단점:
- 단일 관점만 반영
- 깊이 있는 분석 어려움
- 자기 검증 부재
Bash
/astory:post --mode solo --persona developer
Crew Mode
특징: 7개 역할이 순차적으로 협업하여 고품질 콘텐츠를 생성한다.
소요 시간: 20-40분
적합한 상황:
- 긴 글 (5,000자 이상)
- 기술 문서, 심층 분석
- 다양한 관점이 필요한 콘텐츠
Loading diagram...
Crew Mode Workflow - 7개 역할이 순차적으로 협업하는 프로세스
7개 역할의 책임:
- Creative Director: 아이디어 발굴, 콘텐츠 각도 결정, 전체 방향성 수립
- Research Analyst: 심층 리서치, 소스 수집, 데이터 검증
- Lead Writer: 주요 콘텐츠 초안 작성, 구조화
- Technical Reviewer: 기술적 정확성 검증, 코드 예제 확인
- Reader Advocate: 가독성 검토, 명확성 개선, 독자 관점 피드백
- Devil's Advocate: 반론 제기, 빈틈 찾기, 완성도 검증
- Editor-in-Chief: 최종 편집, 품질 보증, 일관성 확인
장점:
- 다양한 관점 반영
- 자기 검증 시스템 내장
- 높은 완성도
단점:
- 시간 소요 증가
- 토큰 사용량 증가
- 짧은 글에는 과도함
Adaptive Mode
특징: 글의 섹션마다 가장 적합한 페르소나를 자동으로 선택한다.
소요 시간: 15-25분
적합한 상황:
- 중간 길이 글 (3,000-5,000자)
- 섹션별 문체 변화가 필요한 콘텐츠
- 도입-본론-결론의 톤이 달라야 하는 경우
예시 설정:
- 도입부: Storyteller (흥미 유발)
- 본론: Developer (실무 정보)
- 결론: Columnist (통찰 제공)
장점:
- 섹션별 최적화된 문체
- 자동 페르소나 전환
- Crew Mode보다 빠름
단점:
- 섹션 간 톤 전환 어색할 수 있음
- 설정 복잡성
모드 선택 가이드
Loading diagram...
Mode Selection Guide - 콘텐츠 특성에 따른 모드 선택 흐름도
설치 및 사용 가이드
사전 요구사항
astory-blog-writers 플러그인을 사용하려면 Claude Code가 설치되어 있어야 한다.
Claude Code 설치:
Bash
# npm으로 설치npm install -g @anthropic-ai/claude-code# 또는 Homebrew로 설치 (macOS)brew install claude-code
설치 확인:
Bash
claude --version
Node.js 18 이상이 필요하다.
node --version으로 확인할 수 있다.프로젝트 설정
먼저 블로그 프로젝트 폴더를 생성하고 Claude Code를 실행한다.
Bash
# 프로젝트 폴더 생성 및 이동mkdir my-blog && cd my-blog# Claude Code 실행claude
Claude Code가 실행되면 대화창에서 플러그인을 설치할 수 있다.
플러그인 설치
1단계: 마켓플레이스 등록
Bash
/plugin marketplace add modu-ai/cc-plugins
2단계: 플러그인 설치
Bash
/plugin install astory-blog-writers@moai-cc-plugins --scope project
3단계: 설치 확인
Bash
/plugin list
출력 결과에
astory-blog-writers가 표시되면 설치 완료다./astory:post 커맨드
플러그인 설치 후
/astory:post 커맨드를 사용할 수 있다. 커맨드는 5단계 워크플로
우를 실행한다.Phase 0: 리서치 (선택)
--research 옵션 없이 /astory:post만 실행해도 된다. 커맨드가 시작되면 "참고할
URL이나 주제에 대한 심층 조사가 필요하신가요?"라고 물어본다. 여기서 "심층 조사필
요"를 선택하면 astory-researcher 에이전트가 관련 자료를 수집하고 분석한다. "직접
작성"을 선택하면 리서치 단계를 건너뛴다.Bash
# 기본 사용 (리서치 여부를 대화형으로 선택)/astory:post# 리서치 주제를 미리 지정하는 경우/astory:post "Claude Code 플러그인 시스템"
Phase 1: 작성 모드 선택
- Solo Mode: 단일 페르소나
- Crew Mode: 7인 협업
- Adaptive Mode: 섹션별 자동 선택
Phase 2: 콘텐츠 세부정보
- 제목 및 슬러그
- 카테고리 및 태그
- 대상 독자층
- 예상 길이
Phase 3: 작성
선택한 모드와 페르소나에 따라 에이전트가 콘텐츠를 생성한다.
Phase 4: 품질 검증 및 게시
Anti-AI Pattern System이 3단계 검증을 수행한다.
실전 예제: Crew Mode 워크플로우
이 포스트의 실제 작성 과정을 예시로 설명한다.
Creative Director 단계
"astory-blog-writers 플러그인 기술 가이드를 작성합니다.
- 타겟 독자: Claude Code 경험이 있는 중급자
- 핵심 각도: 'DNA 기반 시스템의 설계 철학과 실전 활용'
- 차별화 포인트: 이 포스트 자체가 Crew Mode로 작성된 사례
- 예상 독자 질문: '기존 AI 글쓰기와 뭐가 다른가?', '실제로 쓸만한가?'"
Research Analyst 단계
"플러그인 저장소를 분석했습니다.
- 9개 에이전트 구조 확인
- 16개 트레잇 시스템 문서화
- 8개 프리셋 페르소나 정의
- Crew Mode 7개 역할 사양
- Anti-AI Pattern System 규칙"
Lead Writer 단계
초안이 작성된다. 섹션별 구조와 내용이 정의된다.
Technical Reviewer 단계
"기술적 검증 완료:
- 설치 명령어 정확성 확인:
/plugin install astory-blog-writers@moai-cc-plugins- 저장소 URL 확인:
modu-ai/cc-plugins- 코드 예제 문법 검증 완료
- Mermaid 다이어그램 렌더링 테스트 통과"
Reader Advocate 단계
"가독성 개선 제안:
- 표 형식으로 트레잇 비교 정리
- 코드 블록에 설명 주석 추가
- FAQ 섹션 추가 권장
- 긴 문단 분리 필요"
Devil's Advocate 단계
"반론 및 보완 포인트:
- 토큰 사용량에 대한 정량적 데이터 부족
- Adaptive Mode 예제가 부족함
- 실패 케이스에 대한 언급 없음
- 커스터마이징 방법 설명 필요"
Editor-in-Chief 단계
최종 편집이 완료되고 품질 검증을 통과한다.
Anti-AI Pattern System
astory-blog-writers의 차별화된 기능 중 하나는 Anti-AI Pattern System이다. AI가생
성한 글에서 흔히 나타나는 패턴을 자동으로 탐지하고 수정한다.
3단계 탐지 시스템
Loading diagram...
Anti-AI Detection Flow - 3단계 검증으로 자연스러운 글을 생성한다
Critical Pattern (자동 수정)
AI 글쓰기에서 가장 빈번하게 나타나는 패턴을 자동으로 수정한다.
- "~를 넘어 ~하다" 패턴
- "~에 있어서", "~를 통해"
- "다양한 관점에서 살펴보면"
Forbidden Vocabulary (대안 제안)
금지어 사용 시 대안을 제안한다.
| 금지어 | 대안 |
|---|---|
| 패러다임 | 방식, 접근법 |
| 혁신적인 | 새로운, 효과적인 |
| 획기적인 | 주목할 만한 |
| 시너지 | 상승효과, 협력효과 |
Empty Intensifiers (강조어 필터)
의미 없는 강조어를 필터링한다.
- "매우", "아주", "정말" 등 빈 강조어
- 과도한 수식어 체인
- 불필요한 감탄사
Structural Issues (구조 재구성)
- 같은 접속사 반복 사용
- 단문/장문 불균형
- 기계적인 리스트 나열
- 동일 패턴 문장 연속
플러그인 아키텍처
Loading diagram...
Plugin Architecture - 커맨드, 에이전트, 스킬 3계층 구조
계층별 역할
Command Layer:
/astory:post커맨드가 전체 워크플로우를 오케스트레이션한다- 사용자 입력을 받아 적절한 에이전트를 호출한다
Agent Layer:
- 9개 에이전트가 각자의 역할을 수행한다
- researcher: 리서치 전담
- writer-*: 8개 페르소나별 글쓰기 에이전트
Skill Layer:
- traits/: 16개 DNA 트레잇 정의
- personas/: 8개 프리셋 페르소나 설정
- protocols/: Solo, Crew, Adaptive 모드 프로토콜
- crew-roles/: Crew Mode 7개 역할 정의
- research/: 리서치 방법론 및 소스 관리
- writing-standards/: 작성 표준 및 스타일 가이드
- anti-ai-validator/: AI 패턴 탐지 규칙
독립 실행 구조
astory-blog-writers는 MoAI-ADK에 대한 의존성이 없다. Claude Code만 설치되어 있으
면 단독으로 동작한다. 이는 다음을 의미한다.
- 설치 과정 단순화
- 버전 충돌 가능성 제거
- 다른 플러그인과의 호환성 보장
- 가벼운 설치 용량
커스터마이징 가이드
커스텀 페르소나 생성
8개 프리셋 페르소나 외에 직접 트레잇을 조합할 수 있다.
Bash
/astory:post --traits voice:technical,expertise:implementation,perspective:critical,tone:authoritative
이 조합은 기술 문서 스타일로 구현 세부사항을 비판적으로 분석하는 권위 있는 어조
의 글을 생성한다.
트레잇 조합 옵션 입력이 복잡하게 느껴진다면 옵션 없이
/astory:post만 실행하면
된다. 커맨드가 "어떤 방식으로 작성할까요?"라고 물어보고, 원하는 스타일을 한글로
설명하면 자동으로 적절한 트레잇 조합을 선택한다. 예를 들어 "친근하게 초보자에게
설명하는 튜토리얼"이라고 입력하면 Mentor 페르소나가 선택된다.트레잇 조합 권장 사항
기술 문서 작성 시:
- Voice: Technical 또는 Formal
- Expertise: Architecture 또는 Implementation
- Perspective: Analytical
- Tone: Authoritative
튜토리얼 작성 시:
- Voice: Conversational
- Expertise: Education
- Perspective: Experiential
- Tone: Nurturing
리뷰/비교 작성 시:
- Voice: Conversational
- Expertise: Implementation
- Perspective: Critical
- Tone: Authoritative
Crew Mode 역할 스킵
시간 절약이 필요하면 일부 역할을 건너뛸 수 있다.
Bash
/astory:post --mode crew --skip-roles devil-advocate,reader-advocate
단, 품질 저하 가능성을 감수해야 한다.
FAQ
설치 관련
Q: 플러그인 설치가 실패한다
A: 다음을 확인한다.
- Claude Code 최신 버전 확인:
claude --version - 마켓플레이스 등록 확인:
/plugin marketplace list - 네트워크 연결 상태 확인
Q:
--scope project 옵션이 동작하지 않는다A: Git 저장소 내에서 실행해야 한다.
.git 디렉토리가 있는지 확인한다.사용 관련
Q: Crew Mode가 너무 오래 걸린다
A: 7개 역할이 순차 실행되므로 시간이 소요된다. 대안:
--skip-roles옵션으로 일부 역할 스킵- 짧은 글은 Solo Mode 사용
- Adaptive Mode로 중간 지점 선택
Q: 특정 페르소나가 마음에 들지 않는다
A: 두 가지 방법이 있다.
- 다른 프리셋 페르소나 시도
--traits옵션으로 직접 트레잇 조합
Q: Anti-AI Pattern이 너무 많이 수정한다
A: 현재 버전에서는 탐지 민감도 조절이 불가능하다. 다음 버전에서
--ai-detection-level 옵션 추가 예정이다.성능 관련
Q: 토큰 사용량은 얼마나 되나?
A: 모드별 대략적인 토큰 사용량:
- Solo Mode: 3,000-5,000 토큰
- Adaptive Mode: 8,000-15,000 토큰
- Crew Mode: 20,000-40,000 토큰
Q: 한글 1자는 몇 토큰인가?
A: 한글 1자는 평균 2-3 토큰이다. Claude의 토큰화 방식에 따라 다소 차이가 있다.
마무리
astory-blog-writers는 AI 글쓰기의 고질적 문제를 체계적으로 해결한다.
핵심 차별화 요소:
- DNA 기반 16개 트레잇으로 256가지 이상의 페르소나 조합
- Crew Mode 7인 협업으로 다각적 관점 반영
- Anti-AI Pattern System으로 자연스러운 문체 유지
- 한국어 문체(한다체, 해요체, 서사체) 정확한 구현
- MoAI-ADK 의존성 없는 독립 실행
이 포스트 자체가 Crew Mode의 결과물이다. 7개 역할이 순차적으로 협업하여 기술
적 정확성, 가독성, 완성도를 검증했다. 플러그인이 실제로 어떤 품질의 콘텐츠를 생
성할 수 있는지 이 글이 증명한다.
설치 후 간단한 Solo Mode 테스트로 시작하고, 중요한 콘텐츠에는 Crew Mode를 적용하
는 점진적 접근을 권장한다.
모두의AI는 modu-ai/cc-plugins 저장소를
통해 지속적으로 다양한 Claude Code 플러그인을 추가할 예정이다. 개발 생산성 향상,
문서화 자동화, 코드 품질 관리 등 다양한 영역의 플러그인이 계획되어 있다. 저장소
를 Star하거나 Watch하면 새로운 플러그인 출시 소식을 받을 수 있다.
참고 자료: