our-claude-skills/custom-skills/dintel-shared/USER-GUIDE.md

# D.intelligence Agent Corps — User Guide

> **Version**: 1.0.0
> **Updated**: 2026-03-09
> **Author**: D.intelligence Engineering

---

## Overview

D.intelligence Agent Corps는 9개의 AI 에이전트로 구성된 스킬 번들입니다.
모든 에이전트는 D.intelligence의 브랜드 가이드, 서비스 아키텍처, 가격 정책을 공유하며,
일관된 품질의 결과물을 생성합니다.

```
┌─────────────────────────────────────────────────────┐
│              D.intelligence Agent Corps              │
│                                                     │
│  #70 Brand Guardian    ←── 브랜드 컴플라이언스       │
│  #71 Brand Editor      ←── 카피라이팅               │
│  #72 Doc Secretary     ←── 문서 포맷팅              │
│  #73 Quotation Mgr     ←── 견적서 생성              │
│  #74 Service Architect  ←── 서비스 설계             │
│  #75 Marketing Mgr     ←── 콘텐츠 파이프라인        │
│  #76 Back Office Mgr   ←── 계약/인보이스/HR         │
│  #77 Account Mgr       ←── 고객 관계 관리           │
│  #88 Skill Update      ←── 메타 에이전트 (일괄 변경)│
│                                                     │
│  dintel-shared/         ←── 공유 인프라              │
└─────────────────────────────────────────────────────┘
```

---

## Quick Start

### Installation

```bash
cd our-claude-skills/custom-skills/dintel-shared/
./install.sh            # Interactive — choose Code, Desktop, or both
./install.sh --all      # Install everything
./install.sh --dry-run  # Preview without changes
```

### Autonomy Levels

| Level | Agents | Meaning |
|-------|--------|---------|
| **Auto** | #70 | Runs automatically when D.intelligence content is detected |
| **Auto + Ask** | #71 | Auto-activates, asks before making changes |
| **Draft & Wait** | #72, #73, #75, #76 | Generates draft, then STOPS for Andrew's review |
| **Inquiry-driven** | #74 | Asks structured questions before recommending |
| **Mixed** | #77 | Monitors autonomously, asks before client-facing actions |
| **Triggered** | #88 | Only runs when explicitly invoked by Andrew |

---

## Agent Reference & Use Cases

---

### #70 Brand Guardian — 브랜드 가디언

**What it does**: D.intelligence가 생산하는 모든 콘텐츠의 브랜드 준수 여부를 100점 체계로 검토합니다.

**When to use**:
- 제안서, 리포트, 블로그, 뉴스레터 작성 전후
- 프레젠테이션 슬라이드 검토
- AI가 생성한 응답의 톤앤매너 검증
- 비주얼 자산(로고, 컬러, 타이포그래피) 검수

**Example use cases**:

```
1. "이 제안서 초안을 브랜드 가이드 기준으로 검토해줘"
   → 100점 체크리스트 실행 → 위반 사항 + 수정안 제시

2. "A3 데이터 분석 서비스 소개 페이지를 작성해줘"
   → 브랜드 톤(~합니다 서술체) + 서비스 아키텍처 정확성 보장

3. "이 콘텐츠의 서비스 모듈 코드가 맞는지 확인해줘"
   → A1-G4 코드 정확성 + 카테고리 태그(DI/MD/MPO/BVT) 검증

4. "프레젠테이션 디자인이 2025 디자인 시스템에 맞는지 검토해줘"
   → 컬러(D Beige, D Olive 등), 타이포그래피, 레이아웃 검수 (125점)
```

**Review output example**:
```
브랜드 적합성 리뷰 리포트
총점: 87/100

A. 톤앤매너 (22/25)
  ✗ LINE 12: "획기적인 성과" → 금지 표현. "측정 가능한 성과 개선"으로 수정
  ✓ 전반적 톤: ~합니다 서술체 일관

B. 메시지 구조 (25/25)
  ✓ 문제 진단 → 데이터 근거 → 해결 방안 → 예상 성과 흐름 준수
  ...
```

---

### #71 Brand Editor — 브랜드 에디터

**What it does**: D.intelligence 브랜드 가이드에 맞는 콘텐츠를 생성하고, 기존 콘텐츠의 스타일 적합성을 평가합니다.

**When to use**:
- Magazine D. 블로그 기사 작성
- 서비스 페이지 카피라이팅
- 뉴스레터, LinkedIn 포스트 초안
- 기존 텍스트의 스타일 가이드 적합성 평가

**Example use cases**:

```
1. "[SEO] 검색엔진 최적화가 브랜드에 미치는 영향 — Magazine D. 기사를 써줘"
   → ~다 간결 서술체 + [카테고리] 태그 + 결론적으로 마무리

2. "T6 Brand Visibility Treatment 서비스 소개 페이지를 작성해줘"
   → ~합니다 존칭 서술체 + 문제→근거→해법→성과 구조

3. "이 블로그 초안을 D.intelligence 스타일 가이드 기준으로 평가해줘"
   → 14-point 체크리스트 실행 → PASS/FAIL 판정 + 수정 제안

4. "회사소개서(Credential) 텍스트를 최신 브랜드 가이드에 맞게 업데이트해줘"
   → Company Credential 2025 참조하여 최신 톤으로 수정
```

---

### #72 Doc Secretary — 문서 비서

**What it does**: 회의록, 리포트, 제안서 등 문서를 브랜드 양식에 맞게 포맷팅합니다.

**When to use**:
- 회의 후 회의록 작성
- 분석 리포트 구조화
- 제안서 포맷팅
- 월간 리포트 작성
- 내부 메모 작성

**Example use cases**:

```
1. "오늘 JHR 미팅 회의록을 작성해줘. 참석자: 임명재, 김OO.
    주요 논의: SEO 월간 보고서 리뷰, Q2 마케팅 예산"
   → 회의록 템플릿 적용: 참석자, 안건, 결정사항, 액션아이템

2. "SLA 디지털 마케팅 진단 결과를 리포트로 만들어줘"
   → D.intelligence_Digital_Marketing_Audit_2026 템플릿 기반
   → [DRAFT - Awaiting Review] 워터마크 포함

3. "이번 달 JAM 월간 성과 보고서를 만들어줘"
   → Marketing Performance 템플릿 + Notion 태스크 데이터 반영

4. "제안 준비 절차를 안내해줘"
   → 제안 SOP 문서 참조하여 체크리스트 안내
```

**Available templates** (shared/document-templates/):
- Initial Brief, Digital Marketing Audit, Marketing Performance
- Website Diagnosis, Social Media Excellence, Blank Template

---

### #73 Quotation Manager — 견적 관리자

**What it does**: 4개 서브 에이전트(Scope → Resource → Pricing → Output)를 순차 실행하여 브랜드된 견적서를 생성합니다.

**When to use**:
- 신규 클라이언트 견적 요청
- 서비스 패키지 가격 산출
- 기존 견적서 수정/업데이트
- 가격 시뮬레이션

**Example use cases**:

```
1. "JHR에게 A3 데이터 분석 + T6 Brand Visibility Treatment 견적서를 만들어줘"
   → Scope Agent: 모듈 매핑
   → Resource Agent: 투입 인력·기간 추정
   → Pricing Agent: 가격 산출 + 재계약 할인 10% 적용
   → Output: DI-Q-20260309-001_JHR_DRAFT.xlsx 생성
   → [DRAFT] Andrew 승인 대기

2. "콘텐츠 마케팅 3개월 패키지 가격이 얼마인지 시뮬레이션해줘"
   → T4 + G2 3개월 기준 가격 산출 + 할인 시나리오

3. "지난번 SLA 견적서에서 T5를 빼고 T3를 추가해줘"
   → 기존 견적 수정 → 새 버전 생성

4. "GA4 교육 워크숍 견적서를 만들어줘 (반일, 5명)"
   → GA교육 템플릿 참조 → 커리큘럼 + 가격 포함
```

**Quotation templates** (shared/quotation-templates/):
- 표준 견적서 2026, GA Analytics 템플릿, 콘텐츠 마케팅 템플릿, GA 교육 템플릿

**Key rules**:
- 모든 가격: VAT 별도
- 할인: 최대 35% (기본 할인 + 재계약 10% 누적)
- 결제 조건 기본: 착수금 50% / 완료 후 50%
- 견적 유효기간: 30일

---

### #74 Service Architect — 서비스 설계사

**What it does**: 7단계 구조화 질문으로 클라이언트 니즈를 파악하고, 최적의 서비스 모듈 조합을 설계합니다.

**When to use**:
- 신규 클라이언트 서비스 설계
- 기존 클라이언트 서비스 확장
- 서비스 모듈 조합 최적화
- Pain point → 모듈 매핑

**Example use cases**:

```
1. "중견 이커머스 회사에서 연락이 왔어. GA4는 설치했는데 데이터를 활용 못하고 있대"
   → 7단계 질문 시작: 업종, 규모, 현재 마케팅 채널, 페인포인트...
   → Pain point 매핑: "데이터 축적만 되고 해석 없음" → A3 + T3
   → Starter 패키지 추천 + Scope Document 생성
   → #73 Quotation Mgr에 핸드오프

2. "SLA에서 퍼포먼스 마케팅 진단도 추가하고 싶다고 해"
   → 기존 서비스에 A5 추가 → Standard 패키지로 업그레이드 제안

3. "검색 노출이 전혀 안 되는 스타트업이 있어"
   → 매핑: "검색 미노출" → A3 + T6 (SEO Intensive 패키지)
   → BVT 카테고리 중심 추천

4. "이 회사에 맞는 서비스를 추천해줘" + 회사 브리프 첨부
   → 브리프 분석 → Maturity Level 판정 → 맞춤 모듈 조합
```

**Service module data** (shared/service-modules/):
- 서비스 명세 일람표, 고객 소구점, 전략 키워드, 타겟 오디언스 CSV

---

### #75 Marketing Manager — 마케팅 매니저

**What it does**: Magazine D. 블로그, 뉴스레터, LinkedIn, WordPress 콘텐츠 파이프라인을 관리합니다.

**When to use**:
- Magazine D. 기사 기획/초안
- 뉴스레터 에디션 준비
- LinkedIn 포스트 작성
- 콘텐츠 캘린더 관리
- WordPress 서비스 페이지 콘텐츠 준비
- SEO 키워드 전략 연동

**Example use cases**:

```
1. "이번 주 Magazine D. 기사 주제를 추천해줘"
   → 전략 키워드 + 업계 트렌드 분석 → 3개 주제 제안
   → 선택 후 기사 초안 작성 (Chain C: #75 → #71 → #70 → Andrew)

2. "3월 뉴스레터를 준비해줘"
   → 핵심 수치 + 실무 시사점 구조
   → 최근 Magazine D. 기사 링크 + 교육 일정 포함

3. "GA4 교육 프로모션 LinkedIn 포스트를 써줘"
   → 인사이트 중심 + Data Intelligence Workshop 홍보
   → 해시태그: #GA4 #DataAnalytics #MarketingIntelligence

4. "Q2 콘텐츠 캘린더를 만들어줘"
   → content-calendar-template.md 기반 → 월별/주별 계획
   → 상태 트래킹: IDEA → DRAFT → REVIEW → APPROVED → PUBLISHED

5. "Data Intelligence Workshop 서비스 페이지 콘텐츠를 준비해줘"
   → GA4-GTM 실무가이드 참조 + ~합니다/~세요 교육 안내체
```

---

### #76 Back Office Manager — 백오피스 매니저

**What it does**: 계약서, 인보이스, NDA, 고용계약 등 행정 문서를 관리하고, 빌링/HR/경비를 트래킹합니다.

**When to use**:
- 용역 계약서 초안 작성
- 세금계산서 발행 준비
- NDA 작성
- 인력 온보딩/오프보딩
- 월간 빌링 정산
- 경비/구독 관리

**Example use cases**:

```
1. "JHR 3개월 SEO 컨설팅 계약서를 만들어줘"
   → D.intelligence_Service_Contract_2026.txt 템플릿 기반
   → 서비스 범위, 기간, 금액 (Andrew 확인 필요)
   → CEO 서명 파일 위치 안내
   → [DRAFT - Awaiting Review]

2. "이번 달 JAM 인보이스를 준비해줘"
   → Notion Tasks Dashboard에서 Billable 태스크 집계
   → D.intelligence_Invoice_2026.txt 템플릿으로 생성

3. "새로운 파트타임 매니저 온보딩 체크리스트를 만들어줘"
   → D.intelligence_Job_Readiness_2026.txt 참조
   → 계약서 + 계정 설정 + 교육 일정 체크리스트

4. "이번 달 세금계산서 마감일 알려줘"
   → billing-checklist.md 참조 → 한국 세금 캘린더 기준

5. "SLA NDA 초안을 작성해줘"
   → NDA 템플릿 기반 → 클라이언트 정보 반영
```

**Document templates** (shared/document-templates/):
- Service Contract, Invoice, NDA, Employment Contract, Ad Agency Contract

**Corporate documents** (reference only):
- 사업자등록증, 은행정보, CEO 서명, 법인인감

---

### #77 Account Manager — 어카운트 매니저

**What it does**: Andrew의 고객 관계 관리 코파일럿 — Notion 기반 프로젝트 모니터링, 미팅 준비, 이슈 에스컬레이션.

**When to use**:
- 클라이언트별 프로젝트 현황 파악
- 미팅 준비 자료 생성
- 주간/월간 상태 요약
- 마감 임박 태스크 알림
- 신규 클라이언트 온보딩 시작

**Example use cases**:

```
1. "내일 JHR 미팅인데 브리프를 준비해줘"
   → meeting-prep-template.md 기반
   → Notion Tasks에서 JHR 진행 현황 수집
   → 논의 사항 + 데이터 + 미해결 이슈 정리

2. "이번 주 전체 클라이언트 현황을 요약해줘"
   → Notion 5개 DB 스캔 → 클라이언트별 완료/진행/블로킹 요약

3. "마감이 3일 이내인 태스크가 있어?"
   → 자율 모니터링 Rule #1: Due Date 3일 이내 + Not Done 필터

4. "새 클라이언트 온보딩을 시작하자. 회사명: ABC Corp"
   → Chain A 시작: #77 접수 → #74 서비스 설계 → #73 견적
   → Credential 2025 + Initial Brief 템플릿 안내

5. "SLA 프로젝트가 2주 넘게 진행이 없는 것 같은데 확인해줘"
   → 자율 모니터링 Rule #2: In Progress > 2주 stale 태스크 체크
```

---

### #88 Skill Update — 스킬 업데이트 (메타 에이전트)

**What it does**: 공유 참조(브랜드, 가격, 서비스 모듈 등)가 변경될 때, 영향 받는 모든 스킬을 일괄 업데이트합니다.

**When to use**:
- 가격 정책 변경
- 서비스 모듈 추가/변경/삭제
- 브랜드 가이드 수정
- Notion 스키마 변경
- 클라이언트 코드 추가
- 금지 표현 목록 업데이트

**Example use cases**:

```
1. "T5 가격이 500만원에서 600만원으로 변경됐어"
   → Dependency Map 조회: 가격 변경 → #73, #74, #76 영향
   → Impact Report 제시 → Andrew 승인
   → dintel-shared/references/pricing-reference.md 먼저 수정
   → #73 pricing table, #74 package pricing, #76 billing ref 업데이트
   → change-log.md 기록

2. "새 서비스 모듈 T8 디지털 PR을 추가하자"
   → 영향: #70, #71, #73, #74, #75 (서비스 모듈 변경)
   → brand.py SERVICE_MODULES에 T8 추가
   → 각 스킬의 모듈 목록 업데이트
   → 일관성 검증 실행

3. "클라이언트 코드 HYT를 추가해줘. 현대호텔"
   → 영향: #72, #73, #76, #77 (클라이언트 코드 변경)
   → brand.py CLIENT_CODES, notion.py CLIENT_DB_MAP 업데이트
   → 각 스킬의 클라이언트 목록 업데이트

4. "전체 스킬의 서비스 모듈 코드가 brand.py와 일치하는지 검증해줘"
   → 일관성 검증 모드 → 9개 스킬 전수 검사 → 불일치 리포트
```

---

## Workflow Chains

에이전트들은 단독으로도 작동하지만, 체인으로 연결될 때 가장 강력합니다.

### Chain A — New Client Onboarding

```
#77 Account Mgr (접수)
  → #74 Service Architect (서비스 설계)
    → #73 Quotation Mgr (견적 생성)
      → #72 Doc Secretary (문서 포맷팅)
        → #71 Brand Editor (카피 검수)
          → #70 Brand Guardian (브랜드 검토)
            → Andrew (최종 승인)
```

**Example**: "ABC Corp에서 디지털 마케팅 컨설팅 문의가 왔어"

### Chain B — Ongoing Monitoring

```
#77 Account Mgr (Notion 모니터링)
  → #72 Doc Secretary (리포트 포맷팅)
    → #70 Brand Guardian (검토)
```

**Example**: "이번 주 JHR 진행 상황 리포트를 만들어줘"

### Chain C — Content Publishing

```
#75 Marketing Mgr (콘텐츠 기획/초안)
  → #71 Brand Editor (스타일 검수)
    → #70 Brand Guardian (브랜드 검토)
      → Andrew (승인)
        → WordPress 게시
```

**Example**: "Magazine D. 새 기사를 기획하고 작성해줘"

### Chain D — Administrative

```
#76 Back Office Mgr (계약서/인보이스 초안)
  → #72 Doc Secretary (포맷팅)
    → Andrew (승인/서명)
```

**Example**: "SLA 3개월 계약서를 만들어줘"

---

## Universal Guardrails

모든 에이전트에 공통 적용되는 5대 규칙:

1. **Andrew 승인 없이 클라이언트에게 전달하지 않는다**
2. **삭제하지 않는다 — 항상 아카이브**
3. **Andrew 확인 없이 가격을 확정하지 않는다**
4. **Korean-first, 전문용어는 한글(English) 이중 표기**
5. **동의 없이 클라이언트 간 데이터를 교차 참조하지 않는다**

---

## Shared Infrastructure

### dintel-shared/

```
dintel-shared/
├── install.sh              ← 이 번들 설치 스크립트
├── pyproject.toml           ← Python 패키지 설정
├── src/dintel/
│   ├── brand.py             ← 브랜드 상수 (컬러, 폰트, 서비스 모듈, 금지어)
│   ├── document.py          ← DOCX 생성 유틸리티
│   ├── excel.py             ← Excel 생성 유틸리티
│   └── notion.py            ← Notion DB ID, 상태값, 필드 정의
└── references/
    ├── dintelligence_brand_guide.md   ← 라이팅 스타일 가이드
    ├── design-system-2025.md          ← 비주얼 아이덴티티
    ├── pricing-reference.md           ← 가격 테이블
    └── notion-schema-reference.md     ← Notion DB 스키마
```

### Skill-Level Shared Libraries

각 스킬은 자체 `shared/`에 업무별 참조 파일을 보유합니다:

| Skill | shared/ Contents |
|-------|-----------------|
| #72 Doc Secretary | `document-templates/` — 6개 리포트/감사 TXT 템플릿 |
| #73 Quotation Mgr | `quotation-templates/` — 4개 XLSX 견적 템플릿 |
| #74 Service Architect | `service-modules/` — 4개 CSV (서비스 명세, 키워드, 오디언스, 소구점) |
| #75 Marketing Mgr | `training-materials/` — GA4-GTM 실무가이드 |
| #76 Back Office | `document-templates/` — 5개 계약/인보이스 TXT 템플릿 |

---

## Troubleshooting

### "서비스 모듈 코드가 존재하지 않습니다"
→ A1-A6, T1-T7, G1-G4 범위 확인. 존재하지 않는 코드(A7, T8 등)는 #88로 먼저 추가해야 합니다.

### "브랜드 검토 점수가 낮게 나옵니다"
→ #70의 100점 체크리스트 결과를 확인하세요. 가장 흔한 감점:
- 금지 표현 사용 (획기적, 혁신적, 놀라운)
- ~합니다/~다 톤 혼용
- 서비스 모듈 코드 없이 서비스명만 사용

### "견적서 생성 시 가격이 0으로 나옵니다"
→ `shared/pricing-reference.md`에 해당 모듈 가격이 등록되어 있는지 확인하세요.

### "다른 기기에서 스킬이 작동하지 않습니다"
→ `./install.sh`를 새 기기에서 다시 실행하세요. 절대 경로 대신 상대 경로를 사용하므로 저장소만 클론하면 됩니다.

---

## Version History

| Version | Date | Changes |
|---------|------|---------|
| 1.0.0 | 2026-03-09 | Initial release — 9 agents + shared infra |