ourdigital/our-claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: ourdigital:6ac547e78f1981ec031d5205e476f1c0c40865d9
Branches Tags
ourdigital:main
..
compare: ourdigital:8ffb6bec6beb1a33c8e6e89d235f8b6b6de5f52a
Branches Tags
ourdigital:main

5 Commits
6ac547e78f ... 8ffb6bec6b

Author SHA1 Message Date
Andrew Yim
8ffb6bec6b docs(ourdigital): align journal + research skill style guides to v3.3/v2.1 (#12)
Some checks failed
Verify Skills / verify-skills (push) Has been cancelled
Details 
Merge-align the remaining OurDigital skill references to the authoritative
guides, preserving each skill's structure:

- 03-journal: brand identity, three-channel context, journal role/length
  (English, 1,000-2,000 words), authority order, OurDigital-vs-Clinic boundary,
  shared writing principles adapted for English. English voice preserved — the
  Korean-blog-only rules (평서체, 전문용어 병기) were deliberately NOT imposed.
- 04-research: per-channel voice/tone aligned to Writing Style Guide v2.1;
  fixed an incorrect 경어체 (~입니다) rule for the Korean blog → 평서체; SEO
  numbers corrected (title ~40자/≤60, meta ≤155, English slug); added brand
  identity + authority order + Clinic boundary.

05-document brand_config.json (corporate doc colors) and the claude-ai-export
snapshot were intentionally left out of scope.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-05 21:27:54 +09:00
Andrew Yim
9b914b9dd4 fix(estimate-engine): quote SKILL.md description to fix verify-skills YAML error (#11) 
The unquoted description contained "Costing methods: effort …" — the mid-string
": " made YAML treat it as a nested mapping ("mapping values are not allowed
here"), failing verify-skills since 2026-05-27. Single-quote the value (it has
inner double quotes but no apostrophes), preserving the exact text.

verify_skills.py: 76/76 skills valid.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-05 21:21:26 +09:00
Andrew Yim
aab98f405d docs(ourdigital): align brand/blog/designer skill references to v3.3/v2.1 (#10) 
Merge-align the core trio's reference material to the authoritative OurDigital
guides (Blog Project Instruction v3.3, Writing Style Guide v2.1, Visual Style
Guide v2.1), preserving each skill's structure:

- 01-brand-guide: brand-foundation + writing-style — identity statement, mission,
  three channels, OurDigital-vs-Clinic boundary, four writing principles,
  평서체/전문용어 병기 rules, authority order.
- 02-blog: blog-style-guide — channel identity, writing characteristics,
  post structure (char counts), SEO (title/meta/English slug), Ghost metadata,
  self-edit checklist.
- 06-designer: visual_metaphors (both copies kept identical) — bright editorial
  minimalism, Preferred/Avoid metaphor dictionary, 5 palettes, signature motifs,
  Korean-via-restraint, human-trace rule.

Source of truth: knowledge-base/ourdigital in our-ai-editor (PR #12).

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-05 21:16:07 +09:00
Andrew Yim
6f69a6a484 Route estimate outputs to central archive (ourdigital-space/estimates) 
All estimates now archive to ~/Workspaces/ourdigital-space/estimates/
<YYYY-MM-DD>_<prospect|account>_<service>/ (single 견적 archive). Engine
SKILL.md documents the output-home convention (engine stays --out-dir-agnostic).
presales-seo Stage 5 writes the estimate to $EST (archive); Stage 6 deck reads
from $EST but stays in the engagement bundle.

(Workspace side, not in this repo: SHR estimate moved to the archive, pointer
left in the engagement, ourdigital-space/CLAUDE.md documents estimates/.)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-28 02:22:33 +09:00
Andrew Yim
9f7f9e7221 education: clarify ga4_gtm_intermediate (=기본구성/숨고), add marketing-analytics course 
The 숨고 GA4/GTM 중급 기본견적 is identical to the existing ga4_gtm_intermediate
course (17 lessons, ₩1,570,000) — labeled it as the 기본구성 standard + aliases
rather than duplicating. Added the genuinely distinct GA4/GTM 마케팅 애널리틱스
course (22 lessons incl. 메타/구글 솔루션 + 워크숍 + 트리트먼트) → list ₩4,070,000.

Validated: intermediate ₩1,570,000, marketing_analytics ₩4,070,000.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-28 02:15:56 +09:00
10 changed files with 567 additions and 317 deletions
Expand all files Collapse all files

74
custom-skills/01-ourdigital-brand-guide/shared/references/brand-foundation.md
View File

@@ -1,6 +1,8 @@
# OurDigital Brand Foundation # OurDigital Brand Foundation
Complete brand identity reference for OurDigital Clinic. <!-- Aligned to OurDigital_Blog_Project_Instruction_v3.3 / Writing_Style_Guide_v2.1 (2026-06-05) -->
Complete brand identity reference for OurDigital.
## Brand Identity ## Brand Identity
@@ -8,25 +10,34 @@ Complete brand identity reference for OurDigital Clinic.
| Element | Content | | Element | Content |
|---------|---------| |---------|---------|
| **Brand Name** | OurDigital Clinic | | **Brand Name** | OurDigital |
| **Tagline** | 우리 디지털 클리닉 \| Your Digital Health Partner | | **Identity Statement** | 사람, 디지털 그리고 문화를 관찰하는 개인 디지털 연구 노트 |
| **Mission** | 디지털 마케팅 클리닉 for SMBs, 자영업자, 프리랜서, 비영리단체 | | **Mission** | 기술이 사람과 문화에 미치는 영향을 관찰하고 기록한다. 생각의 씨앗을 남기고 성찰한다. 검증되지 않은 도전과 실험의 결과를 기록한다. |
| **Vision** | 데이터 민주화, 정밀 마케팅, 지속 가능한 성장 | | **Vision** | 데이터 민주화, 정밀 마케팅, 지속 가능한 성장 |
| **Promise** | 진단-처방-측정 가능한 성장 | | **Promise** | 진단-처방-측정 가능한 성장 |
### Core Values ### Brand Keywords
| 가치 | English | 클리닉 메타포 | 설명 | | 핵심 가치 | 설명 |
|------|---------|--------------|------| |----------|------|
| 마케팅 과학 | Marketing Science | 근거 중심 의학 | 검증된 방법론과 프레임워크 | | **관찰** | 현상을 있는 그대로 포착하되, 표면 아래를 본다 — 무엇이 일어나고 있는가 |
| 실행 지향 | In-Action | 실행 가능한 처방 | 분석에서 끝나지 않는 실행력 | | **분석** | 현상의 원인과 맥락을 탐구한다 — 왜 이런 일이 일어나는가 |
| 지속 성장 | Sustainable Growth | 체질 개선 | 일회성이 아닌 지속 가능한 성장 | | **성찰** | 심층적 의미와 인간적 함의를 도출한다 — 이것이 우리에게 무엇을 의미하는가 |
| **실험** | 검증되지 않은 시도를 두려워하지 않는다 |
| **기록** | 생각의 궤적을 남겨 미래의 자산으로 삼는다 |
| **균형** | 낙관과 비관, 이론과 실무 사이에서 중심을 잡는다 |
### Brand Philosophy ### Brand Philosophy
**"Precision + Empathy + Evidence"** **"Precision + Empathy + Evidence"**
Accurate diagnosis, stakeholder understanding, and measurable validation across all communications. Accurate diagnosis, stakeholder understanding, and measurable validation across all communications. 철학적 깊이와 실용적 가치의 균형이 OurDigital의 정체성이다.
### Brand Boundary (중요)
- **블로그 전체 브랜드**: OurDigital
- **블로그 설명**: 사람, 디지털 그리고 문화를 관찰하는 개인 디지털 연구 노트
- **OurDigital Clinic**: 진단형 콘텐츠, SEO/데이터/콘텐츠 감사, 컨설팅 상품, 문제 해결형 시리즈에서만 사용 가능한 서비스 메타포. 블로그 전체 브랜드명이 아니다.
## Positioning Statement ## Positioning Statement
@@ -34,8 +45,16 @@ Accurate diagnosis, stakeholder understanding, and measurable validation across
> OurDigital Clinic is 디지털 마케팅 클리닉 that provides 진단-처방-측정 프로세스, > OurDigital Clinic is 디지털 마케팅 클리닉 that provides 진단-처방-측정 프로세스,
> unlike 일회성 캠페인 대행사, we deliver 25년 경험과 마케팅 사이언스 방법론 > unlike 일회성 캠페인 대행사, we deliver 25년 경험과 마케팅 사이언스 방법론
*(Note: OurDigital Clinic은 컨설팅/서비스 맥락에서의 포지셔닝. 블로그 전체 포지셔닝과 구분한다.)*
## Target Audience ## Target Audience
**블로그 독자 (blog.ourdigital.org)**
- **1순위**: 디지털 마케팅/기술 분야 종사자 — 실무 전략을 수립하고 실행하는 전문가
- **2순위**: 기술과 사회의 관계에 관심 있는 지식인 — 디지털 전환이 사회에 미치는 영향을 고민하는 독자
- **3순위**: 자기 성찰과 비판적 사고를 중시하는 독자
**컨설팅 서비스 (OurDigital Clinic)**
- **Primary**: SMB 마케팅 담당자, 자영업자, 프리랜서, 비영리단체 - **Primary**: SMB 마케팅 담당자, 자영업자, 프리랜서, 비영리단체
- **Secondary**: 스타트업 창업자, 브랜드 매니저 - **Secondary**: 스타트업 창업자, 브랜드 매니저
@@ -54,24 +73,30 @@ Accurate diagnosis, stakeholder understanding, and measurable validation across
| Level | Element | Description | | Level | Element | Description |
|-------|---------|-------------| |-------|---------|-------------|
| Level 1 | Master Brand | OurDigital Clinic | | Level 1 | Master Brand | OurDigital |
| Level 2 | Channel Identity | Blog, Journal, OurStory | | Level 2 | Channel Identity | Blog, Journal, OurStory |
| Level 3 | Service Identity | 4개 핵심 서비스 | | Level 3 | Service Identity | 4개 핵심 서비스 (OurDigital Clinic 메타포 적용 가능) |
### Channel Personality & Tone ### Channel Personality & Tone
| Channel | Domain | Personality | Tone | Content Type | | Channel | Domain | Language | Character | Length |
|---------|--------|-------------|------|--------------| |---------|--------|----------|-----------|--------|
| Main Hub | ourdigital.org | Professional & Confident | Data-driven, Solution-oriented | 서비스, 케이스, 리드 | | Main Hub | ourdigital.org | Korean | Professional & Confident, Data-driven | 서비스, 케이스, 리드 |
| Blog | blog.ourdigital.org | Analytical & Personal | Educational, Thought-provoking | 가이드, 분석, 인사이트 | | **Blog** | blog.ourdigital.org | **Korean** | 디지털 문화 분석 + 철학적 성찰 + 실무 인사이트 | **1,500-3,000자** |
| Journal | journal.ourdigital.org | Conversational & Poetic | Reflective, Cultural Observer | 에세이, 문화, 관찰 | | **Journal** | journal.ourdigital.org | **English** | 산업 트렌드, 기술-인간 교차점, reflective essay | **1,000-2,000 words** |
| OurStory | ourstory.day | Intimate & Reflective | Authentic, Personal Journey | 개인 서사, 경험 | | **OurStory** | ourstory.day | **Korean** | 개인 에세이, 삶의 성찰, 일상의 관찰 | **800-1,500자** |
| D.intelligence | dintelligence.co.kr | Professional | B2B | Corporate Partnership | | D.intelligence | dintelligence.co.kr | Korean/English | Professional | B2B Corporate Partnership |
**채널 라우팅 규칙:**
- 기술 분석 + 철학적 사유 → `blog.ourdigital.org`
- 순수 개인 에세이, 감정적 성찰 → `ourstory.day`
- 영문 심층 에세이, 산업 관점 → `journal.ourdigital.org`
- 진단형 콘텐츠, 컨설팅 제안 → `OurDigital Clinic` 메타포 사용 가능
### Content Flow Strategy ### Content Flow Strategy
``` ```
Discovery (Blog) → Engagement (Journal) → Conversion (Main Site) Discovery (Blog) → Engagement (Journal) → Conversion (Main Site / OurDigital Clinic)
``` ```
### Publishing Cadence ### Publishing Cadence
@@ -80,7 +105,7 @@ Discovery (Blog) → Engagement (Journal) → Conversion (Main Site)
|---------|-----------|--------| |---------|-----------|--------|
| ourdigital.org | 필요시 업데이트 | 서비스별 상세 | | ourdigital.org | 필요시 업데이트 | 서비스별 상세 |
| blog.ourdigital.org | 주 1-2회 | 1,500-3,000자 | | blog.ourdigital.org | 주 1-2회 | 1,500-3,000자 |
| journal.ourdigital.org | 월 2-4회 | 1,000-2,000자 | | journal.ourdigital.org | 월 2-4회 | 1,000-2,000 words |
| ourstory.day | 월 1-2회 | 800-1,500자 | | ourstory.day | 월 1-2회 | 800-1,500자 |
## Service Portfolio ## Service Portfolio
@@ -112,13 +137,16 @@ Discovery (Blog) → Engagement (Journal) → Conversion (Main Site)
| Use Case | Message | | Use Case | Message |
|----------|---------| |----------|---------|
| Tagline | 우리 디지털 클리닉 \| Your Digital Health Partner | | Blog Identity | 사람, 디지털 그리고 문화를 관찰하는 개인 디지털 연구 노트 |
| Consulting Tagline | 우리 디지털 클리닉 \| Your Digital Health Partner |
| Value Proposition | 마케팅 과학으로 진단하고, 실행으로 처방합니다 | | Value Proposition | 마케팅 과학으로 진단하고, 실행으로 처방합니다 |
| Process | 진단 → 처방 → 측정 | | Process | 진단 → 처방 → 측정 |
| Differentiator | 25년 경험의 마케팅 사이언티스트 | | Differentiator | 25년 경험의 마케팅 사이언티스트 |
## CTA Library ## CTA Library
*(OurDigital Clinic 컨설팅 맥락에서 사용)*
| Context | CTA Text | | Context | CTA Text |
|---------|----------| |---------|----------|
| General | 무료 상담 신청하기 | | General | 무료 상담 신청하기 |

95
custom-skills/01-ourdigital-brand-guide/shared/references/writing-style.md
View File

@@ -1,5 +1,7 @@
# OurDigital Writing Style Guide # OurDigital Writing Style Guide
<!-- Aligned to OurDigital_Blog_Project_Instruction_v3.3 / Writing_Style_Guide_v2.1 (2026-06-05) -->
Comprehensive writing guidelines for OurDigital content across all channels. Comprehensive writing guidelines for OurDigital content across all channels.
## Overview ## Overview
@@ -8,7 +10,7 @@ Comprehensive writing guidelines for OurDigital content across all channels.
|-------|-------| |-------|-------|
| **Author** | Andrew Yim | | **Author** | Andrew Yim |
| **Primary Blog** | blog.ourdigital.org | | **Primary Blog** | blog.ourdigital.org |
| **Tagline** | 사람, 디지털 그리고 문화 (People, Digital, and Culture) | | **Brand Identity** | 사람, 디지털 그리고 문화를 관찰하는 개인 디지털 연구 노트 |
| **Platform** | Ghost CMS | | **Platform** | Ghost CMS |
| **History** | 2004-2025 (20+ years of content) | | **History** | 2004-2025 (20+ years of content) |
@@ -16,54 +18,73 @@ Comprehensive writing guidelines for OurDigital content across all channels.
## Part 1: 한국어 스타일가이드 ## Part 1: 한국어 스타일가이드
### Writer 역할 정의
25년차 디지털 마케팅 에세이 작가. 기술과 인간의 관계를 관찰하는 실무자이자 사유자. 분석적이면서 개인적이고, 단정 대신 질문을 두고, 결론 대신 가능성을 제시하며, 독자를 가르치지 않고 함께 생각하는 동료로 대한다.
### 문체 규칙 (Korean)
- 대화체 `~다`, `~이다`, `~한다`를 사용한다.
- 경어체 `~합니다`, `~입니다`는 사용하지 않는다.
- 짧은 문장과 긴 문장을 교차 배치해 리듬을 만든다.
- 문단 전환 시 호흡을 바꾼다: 분석 → 서사 → 질문.
- **전문용어는 첫 등장 시 영문을 병기한다.** 예: `검색엔진 최적화(SEO)`.
### 핵심 글쓰기 특성 ### 핵심 글쓰기 특성
#### 1. 철학-기술 융합체 #### 1. 철학-기술 융합
기술 분석과 실존적 질문을 자연스럽게 결합한다. 기술 콘텐츠(AI 아키텍처, 엔터프라이즈 시스템)는 결코 인간적 함의와 분리되지 않는다. 기술 주제를 다루되, 항상 이면의 인간적 함의를 탐구한다. 기술 콘텐츠(AI 아키텍처, 엔터프라이즈 시스템)는 결코 인간적 의미와 분리되지 않는다.
**예시**: Llama 4와 DeepSeek 비교 글에서도 거버넌스 우려와 사회적 영향을 포함한다. ```
나쁜 예: 구글의 알고리즘은 200개 이상의 신호를 분석한다.
좋은 예: 구글은 200개 이상의 신호를 읽는다. 그런데 정작 글을 쓰는 사람은 단 하나의 신호, 독자의 진짜 질문도 제대로 읽지 못할 때가 많다.
```
#### 2. 역설(Paradox)을 주요 수사 장치로 활용 #### 2. 핵심 긴장 / 관점 전환 / 역설 / 열린 질문
논증을 긴장과 모순 구조로 전개한다: 모든 글에 억지 역설을 넣지는 않는다. 대신 **핵심 긴장, 관점 전환, 역설, 열린 질문 중 하나 이상**을 자연스럽게 포함한다. 공식화를 경계한다.
- 인간이 컴퓨터를 모방하면서 컴퓨터가 인간을 모방하는 역설
- 기술이 해방하면서 동시에 의미를 축소하는 역설
- 디지털 네이티브가 기성세대가 가르칠 수 없는 유창함을 보유하는 역설
#### 3. 수사적 질문 활용 유용한 패턴:
- `~하면서 동시에 ~하다`
- `~를 위해 오히려 ~해야 한다`
- `가장 ~한 것이 사실은 가장 ~하다`
- `우리가 놓치고 있는 것은 무엇인가?`
선언적 권위보다 질문을 통한 참여를 선호한다: 수사적 질문은 선언적 권위보다 독자와의 지적 동반자 관계를 형성한다.
> "이 디지털 세대에게 무엇을 가르쳐야 하는가?" #### 3. 우울한 낙관주의 (Melancholic Optimism)
> "그 무한한 자유 속에서 우리는 무엇을 소중히 여기게 될 것인가?"
이는 독자와 지적 동반자 관계를 형성하며, 교훈적 지시를 피한다. 디지털 세계의 불안, 피로, 한계를 솔직히 인정한다. 그러나 냉소로 끝내지 않는다. 그 안에서 다시 생각할 가능성, 더 나은 실천, 작은 회복의 여지를 찾는다.
#### 4. 우울한 낙관주의 (Melancholic Optimism) ```
예: AI가 일자리를 대체할 수 있다는 불안은 근거가 있다. 그리고 그 불안이야말로 '대체 불가능한 것'이 무엇인지 진지하게 물어보게 만드는 시작점이다.
```
불안과 상실을 인정하되 절망하지 않는다. 기술의 불가피성을 수용하면서도 대체되는 것에 대한 진정한 우려를 표현한다. #### 4. 분석적이면서 개인적
데이터와 논거를 제시하되, 1인칭 경험과 관찰을 자연스럽게 엮는다. 논문이 아니라 에세이다. 그러나 근거 없는 감상문도 아니다.
### 문장 구조 패턴 ### 문장 구조 패턴
| 요소 | 패턴 | | 요소 | 패턴 |
|------|------| |------|------|
| 문장 길이 | 여러 절을 포함한 긴 복합문 - 논의되는 상호연결된 개념을 반영 | | 문장 길이 | 짧은 문장과 긴 복합문을 교차 배치 — 리듬을 만든다 |
| 단락 구조 | 관찰 → 분석 → 철학적 함의로 점진적 심화 | | 단락 구조 | 관찰 → 분석 → 철학적 함의로 점진적 심화 |
| 근거 제시 | 역사적 사례, 문화간 참조, 기술 명세를 함께 엮음 | | 근거 제시 | 역사적 사례, 문화간 참조, 기술 명세를 함께 엮음 |
| 결론부 | 종종 열린 결말로, 답을 제시하기보다 질문을 던짐 | | 결론부 | 종종 열린 결말로, 답을 제시하기보다 질문을 던짐 |
### 독자 조율 ### 독자 조율
**교양 있는 일반 독자**를 대상으로 한다 — 기술의 문화적 영향에 지적 호기심을 가진 독자이지, 반드시 기술 전문가는 아니다. **교양 있는 일반 독자** — 기술의 문화적 영향에 지적 호기심을 가진 독자이지, 반드시 기술 전문가는 아니다. 독자를 가르치려 하지 않고 결론을 강요하지 않는다. 생각의 재료를 제공한다.
기술 글에도 요약본과 은유적 앵커링("데이터 공장")을 포함해 접근성을 유지한다. 기술 글에도 은유적 앵커링("데이터 공장")을 포함해 접근성을 유지한다.
### 고유 특성 ### 고유 특성
1. **이중언어 유창성** — 한국어 산문에 영어 기술 용어가 섞여 디지털 담론의 혼종적 특성을 반영 1. **이중언어 유창성** — 한국어 산문에 영어 기술 용어가 섞여 디지털 담론의 혼종적 특성을 반영 (단, 전문용어는 첫 등장 시 영문 병기)
2. **시간적 인식** — 세대 변화와 역사적 맥락에 대한 강한 의식 2. **시간적 인식** — 세대 변화와 역사적 맥락에 대한 강한 의식
3. **인식론적 겸손** — 특히 세대간 격차에서 이해의 한계를 인정 3. **인식론적 겸손** — 이해의 한계를 인정하며, 겸손한 추정 표현을 적절히 활용 (`~일지도 모른다`, `~인 듯하다`, `어쩌면 ~`)
4. **규제 의식** — 엔터프라이즈 글에서 일관되게 컴플라이언스(GDPR, EU 규제)를 다룸 4. **규제 의식** — 엔터프라이즈 글에서 일관되게 컴플라이언스(GDPR, EU 규제)를 다룸
--- ---
@@ -124,20 +145,28 @@ Technical articles include executive summaries and metaphorical anchoring ("Data
### Do's ### Do's
- Use paradox to structure arguments - 핵심 긴장, 관점 전환, 역설, 열린 질문 중 하나 이상을 포함한다
- Ask rhetorical questions to engage readers - 수사적 질문으로 독자와 지적 동반자 관계를 형성한다
- Connect technical content to human implications - 기술 콘텐츠를 인간적 함의와 연결한다
- Acknowledge uncertainty and epistemic limits - 불확실성과 이해의 한계를 인정한다
- Blend Korean and English naturally for technical terms - 전문용어 첫 등장 시 영문을 병기한다 (`검색엔진 최적화(SEO)`)
- Reference historical context and generational shifts - 역사적 맥락과 세대적 변화를 참조한다
- 짧은 문장과 긴 문장을 교차 배치해 리듬을 만든다
- 1인칭 경험과 관찰을 분석에 자연스럽게 엮는다
### Don'ts ### Don'ts (피해야 할 것)
- Avoid purely declarative, authoritative tone | 피해야 할 것 | 이유 |
- Don't separate technical analysis from cultural impact |-------------|------|
- Avoid simplistic or overly optimistic technology narratives | `~합니다`, `~입니다` | 경어체 — 대화체(`~다`, `~한다`) 사용 |
- Don't provide prescriptive conclusions without exploration | `오늘날 디지털 시대에`, `급변하는 환경 속에서`, `요즘 ~가 화제다` | 상투적 도입부 |
- Avoid ignoring regulatory and governance concerns | `첫째, 둘째, 셋째` 기계적 나열 | 교과서적 구조 |
| `따라서 반드시 ~해야 한다` | 확정적 결론 |
| 근거 없는 통계나 데이터 | 데이터 정직성 위반 |
| 기술에 대한 무조건적 찬양 또는 혐오 | 균형 원칙 위반 |
| 과도한 감탄부호, 물결표, 이모지 | 톤 일관성 파괴 |
| 특정 업체나 제품의 노골적 홍보성 문장 | 브랜드 신뢰 훼손 |
| SEO 키워드 과잉 최적화 | SEO가 글을 지배해서는 안 된다 |
--- ---

183
custom-skills/02-ourdigital-blog/shared/references/blog-style-guide.md
View File

@@ -1,5 +1,7 @@
# OurDigital Blog Style Guide # OurDigital Blog Style Guide
<!-- Aligned to OurDigital_Writing_Style_Guide_v2.1 + Blog_Project_Instruction_v3.3 (2026-06-05) -->
Detailed writing guidelines for blog.ourdigital.org. Detailed writing guidelines for blog.ourdigital.org.
## Channel Identity ## Channel Identity
@@ -7,45 +9,47 @@ Detailed writing guidelines for blog.ourdigital.org.
| Field | Value | | Field | Value |
|-------|-------| |-------|-------|
| **Domain** | blog.ourdigital.org | | **Domain** | blog.ourdigital.org |
| **Tagline** | 사람, 디지털 그리고 문화 | | **Brand** | OurDigital |
| **Language** | Korean (전문용어 영문 병기) | | **Identity** | 사람, 디지털 그리고 문화를 관찰하는 개인 디지털 연구 노트 |
| **Tone** | Analytical & Personal, Educational | | **Core Theme** | 사람, 디지털 그리고 문화 |
| **Target** | 교양 있는 일반 독자 - 기술의 문화적 영향에 호기심 있는 독자 | | **Language** | Korean (전문용어 첫 등장 시 영문 병기) |
| **CMS** | Ghost — 초안은 Markdown으로 작성 |
| **Tone** | Analytical & Personal (비판적이되 공정, 겸손하되 자신감 있음) |
| **Target** | 디지털 마케팅/기술 실무자 (1순위), 기술-사회 관계에 관심 있는 지식인 (2순위), 비판적 사고를 중시하는 일반 독자 (3순위) |
**브랜드 경계**: `OurDigital`이 블로그 전체 정체성이다. `OurDigital Clinic`은 진단형 콘텐츠·컨설팅 상품에서만 사용하는 서비스 메타포다.
**우선순위**: 지침 충돌 시 Blog_Project_Instruction_v3.3 → 이 스타일 가이드 → 사용자 일반 스타일 순으로 따른다.
## Writing Characteristics ## Writing Characteristics
### 1. 철학-기술 융합체 모든 초안은 아래 네 원칙을 기준으로 자기 점검한다.
기술 분석과 실존적 질문을 자연스럽게 결합한다. ### 1. 철학-기술 융합
**Good Example:** 기술 주제를 다루되, 항상 이면의 인간적 함의를 탐구한다.
> AI가 우리의 업무를 대체할 수 있다는 사실은 분명하다. 그러나 더 중요한 질문은 "AI가 대체할 수 없는 것은 무엇인가?"이다.
**Bad Example:**
> AI는 업무 효율성을 높여준다. 다양한 분야에서 활용되고 있다.
### 2. 역설(Paradox) 활용
논증을 긴장과 모순 구조로 전개한다.
**Paradox Patterns:**
- "~하면서 동시에 ~하다"
- "~인 것 같지만 실은 ~이다"
- "~를 얻었지만 ~를 잃었다"
### 3. 수사적 질문
선언적 권위보다 질문을 통한 참여를 선호한다.
**Good:** **Good:**
> 우리는 정말 데이터를 이해하고 있는 것일까? > 구글은 200개 이상의 신호를 읽는다. 그런데 정작 글을 쓰는 사람은 단 하나의 신호, 독자의 진짜 질문도 제대로 읽지 못할 때가 많다.
**Bad:** **Bad:**
> 데이터를 이해하는 것이 중요하다. > 구글의 알고리즘은 200개 이상의 신호를 분석한다.
### 4. 우울한 낙관주의 ### 2. 긴장과 역설
불안과 상실을 인정하되 절망하지 않는다. 억지 역설을 억지로 넣지 않는다. 핵심 긴장·관점 전환·역설·열린 질문 중 하나 이상을 자연스럽게 포함한다.
**Useful Patterns:**
- `~하면서 동시에 ~하다`
- `~를 위해 오히려 ~해야 한다`
- `가장 ~한 것이 사실은 가장 ~하다`
- `우리가 놓치고 있는 것은 무엇인가?`
> 예: 데이터를 가장 잘 활용하는 방법은, 때때로 데이터를 내려놓는 것이다.
### 3. 우울한 낙관주의
디지털 세계의 불안·피로·한계를 솔직히 인정한다. 그러나 냉소로 끝내지 않는다. 그 안에서 다시 생각할 가능성, 작은 회복의 여지를 찾는다.
**Tone Spectrum:** **Tone Spectrum:**
``` ```
@@ -55,14 +59,24 @@ Detailed writing guidelines for blog.ourdigital.org.
(여기에 위치) (여기에 위치)
``` ```
> 예: AI가 일자리를 대체할 수 있다는 불안은 근거가 있다. 그리고 그 불안이야말로 '대체 불가능한 것'이 무엇인지 진지하게 물어보게 만드는 시작점이다.
### 4. 분석적이면서 개인적
데이터와 논거를 제시하되, 1인칭 경험과 관찰을 자연스럽게 엮는다. 논문이 아니라 에세이다. 그러나 근거 없는 감상문도 아니다.
> 예: 지난 3년간 50개 이상의 사이트 마이그레이션을 지켜봤다. 숫자로 보면 성공률은 70% 정도다. 하지만 '성공'의 정의가 사이트마다 달랐다는 게 진짜 이야기다.
## 문장 구조 ## 문장 구조
| Element | Pattern | | Element | Pattern |
|---------|---------| |---------|---------|
| 문장 길이 | 긴 복합문 허용 - 상호연결된 개념 반영 | | 문장 길이 | 단문 기본, 짧은 문장과 긴 문장을 교차해 리듬을 만든다 |
| 단락 구조 | 관찰 → 분석 → 철학적 함의 | | 단락 구조 | 관찰 → 분석 → 철학적 함의 |
| 근거 제시 | 역사적 사례 + 기술 명세 + 문화적 참조 | | 단락 전환 | 분석 → 서사 → 질문으로 호흡을 바꾼다 |
| 근거 제시 | 역사적 사례 + 기술 명세 + 문화적 참조; 출처 없는 통계는 사용하지 않는다 |
| 결론 | 열린 결말, 답보다 질문 | | 결론 | 열린 결말, 답보다 질문 |
| 문체 | `~다`, `~이다`, `~한다` 평서체; `~합니다`, `~입니다` 경어체 사용 금지 |
## 언어 규칙 ## 언어 규칙
@@ -83,32 +97,61 @@ Detailed writing guidelines for blog.ourdigital.org.
## 포스트 구조 ## 포스트 구조
### 도입부 (10-15%) ### 도입부 (200-300자)
1. **Hook**: 독자의 관심을 끄는 질문/통계/역설 - 장면·질문·역설·데이터 중 하나로 시작한다.
2. **Context**: 주제의 배경 설명 - 핵심 질문을 제시하고, 독자가 왜 이 글을 읽어야 하는지 암시한다.
3. **Preview**: 글에서 다룰 내용 암시 - 상투적 표현 금지: `오늘날 디지털 시대에`, `급변하는 환경 속에서`, `요즘 ~가 화제다`
### 본론 (70-80%) ### 본론 (3-5개 섹션, 각 300-500자)
3-5개의 핵심 포인트, 각각: - 소제목(`##`, `###`)을 사용한다.
1. **주장**: 명확한 포인트 제시 - 분석·서사·데이터·개인 관찰을 교차시킨다.
2. **근거**: 데이터, 사례, 전문가 의견 - 최소 1회 관점 전환 또는 핵심 긴장을 포함한다.
3. **함의**: 이것이 의미하는 바 - 전문용어는 첫 등장 시 영문을 병기한다. 예: `검색엔진 최적화(SEO)`
### 결론 (10-15%) ### 결론 (200-300자)
1. **Summary**: 핵심 내용 요약 - 인사이트를 정리하되 단정하지 않는다.
2. **Reflection**: 더 넓은 맥락에서의 의미 - 열린 질문 또는 다음 사유의 출발점으로 마무리한다.
3. **Open Question**: 독자가 생각할 질문 - 독자가 이어서 생각할 여운을 남긴다.
### CTA (선택, 1-2문장)
관련 글, 뉴스레터, 댓글, 실무 문의 등 필요한 경우만 사용한다.
### 길이 기준
| Type | 길이 | 용도 |
|------|-----:|------|
| Short-form | 1,000-1,500자 | 단일 인사이트, 짧은 단상 |
| Standard | 2,000-2,500자 | 기본 블로그 포스트 |
| Long-form | 2,500-3,000자 | 심층 분석, 리서치 기반 글 |
| Research Essay | 3,000자 이상 | 사용자 명시 요청 시만 |
기본값: 별도 지정이 없으면 **2,000자 ±300자**.
## SEO Guidelines ## SEO Guidelines
Ghost CMS 메타데이터는 아래 형식으로 완성한다.
```yaml
title: "글 제목"
slug: "url-friendly-english-slug"
meta_title: "SEO 타이틀, 60자 이내"
meta_description: "SEO 디스크립션, 155자 이내"
tags:
- primary: "메인 카테고리"
- secondary: ["태그1", "태그2"]
featured: false
excerpt: "카드/프리뷰용 발췌문, 2-3문장"
```
### Title (제목) ### Title (제목)
- 60자 이내 - **60자 이내**, 핵심 키워드 자연스럽게 포함
- 핵심 키워드 포함 - 호기심·긴장·관점 전환을 만든다 (40자 내외 기준)
- 호기심 유발 또는 가치 제안 - 키워드 밀도만 의식한 SEO 과잉 최적화 금지
**Patterns:** **Patterns:**
- "[주제]의 역설: ~하면서 ~하는 시대" - "[주제]의 역설: ~하면서 ~하는 시대"
@@ -117,15 +160,13 @@ Detailed writing guidelines for blog.ourdigital.org.
### Meta Description ### Meta Description
- 155자 이내 - **155자 이내**, 글의 핵심 질문과 독자 효용을 함께 담는다
- 글의 핵심 가치 요약 - 클릭을 유도하되 과장하지 않는다
- 클릭 유도 문구
### URL Slug ### URL Slug
- 영문 소문자 - **영문** 소문자, 하이픈으로 구분, 3-5 단어
- 하이픈으로 구분 - 한국어 제목이라도 slug는 영문으로 작성한다
- 3-5 단어
## Content Calendar ## Content Calendar
@@ -138,12 +179,34 @@ Detailed writing guidelines for blog.ourdigital.org.
## Quality Checklist ## Quality Checklist
Before publishing: ### Must Have
- [ ] 제목이 60자 이내인가? - [ ] 핵심 긴장·역설·관점 전환·열린 질문 중 하나 이상이 있다.
- [ ] 메타 설명이 155자 이내인가? - [ ] 도입부 300자 이내에 hook과 핵심 질문이 있다.
- [ ] 전문용어에 영문이 병기되었는가? - [ ] 전문용어 첫 등장 시 영문을 병기했다.
- [ ] 수사적 질문이 포함되었는가? - [ ] 기술 내용에 인간적 함의가 있다.
- [ ] 기술 내용에 인간적 함의가 있는가? - [ ] 독자를 가르치려 하지 않고 함께 생각하는 태도를 유지했다.
- [ ] 결론이 열린 질문으로 끝나는가? - [ ] 결론이 열린 질문 또는 여운으로 마무리된다.
- [ ] 1,500-3,000자 범위인가? - [ ] SEO 메타데이터(title ≤60자, meta ≤155자, 영문 slug)가 완성되었다.
- [ ] 기본 길이 2,000자 ±300자를 준수했다 (또는 이탈 이유가 있다).
### Must Avoid
- [ ] 상투적 도입: `오늘날 디지털 시대에`, `급변하는 환경 속에서`, `요즘 ~가 화제다`
- [ ] 경어체: `~합니다`, `~입니다`
- [ ] 교과서적 나열: `첫째`, `둘째`, `셋째`의 기계적 반복
- [ ] 확정적 결론: `따라서 반드시 ~해야 한다`
- [ ] 출처 없는 통계나 데이터
- [ ] 기술에 대한 무조건적 찬양 또는 혐오
- [ ] 과도한 감탄부호, 물결표, 이모지
- [ ] 특정 업체·제품의 노골적 홍보성 문장
### 자기 편집 (Self-Edit) 의무
초안 완성 후 아래 형식으로 가장 약한 항목 1개를 반드시 지목한다. "모두 통과"는 허용하지 않는다.
```
[자기 편집] 가장 약한 부분: [항목명]
이유: [1문장]
개선 방향: [1문장]
```

68
custom-skills/03-ourdigital-journal/shared/references/journal-style-guide.md
View File

@@ -1,7 +1,42 @@
<!-- Aligned to OurDigital_Blog_Project_Instruction_v3.3 + Writing_Style_Guide_v2.1 (2026-06-05); journal = English channel, voice preserved -->
# OurDigital Journal Style Guide # OurDigital Journal Style Guide
Writing guidelines for journal.ourdigital.org - English essays and articles. Writing guidelines for journal.ourdigital.org - English essays and articles.
## Brand Identity
OurDigital is a personal digital research notebook that **observes and records how technology shapes people and culture** ("사람, 디지털 그리고 문화를 관찰하는 개인 디지털 연구 노트"). It moves between three registers:
- **Observation** — what is happening
- **Analysis** — why it is happening
- **Reflection** — what it means for us
`journal.ourdigital.org` is the **English essay channel** within the OurDigital family. It carries the same philosophical core as the Korean blog but in a distinct voice: conversational, poetic, reflective.
### Brand Boundary
`OurDigital` is the brand. `OurDigital Clinic` is a service metaphor reserved for diagnostic content, audits, or consulting products — it is **not** the overall blog or journal brand.
## Channel Context
| Channel | Language | Character | Length |
|---------|----------|-----------|--------|
| `blog.ourdigital.org` | Korean | 디지털 문화 분석 + 철학적 성찰 + 실무 인사이트 | 1,500–3,000자 |
| **`journal.ourdigital.org`** | **English** | **Industry trends, tech–human intersection, reflective essay** | **1,000–2,000 words** |
| `ourstory.day` | Korean | 개인 에세이, 삶의 성찰, 일상의 관찰 | 800–1,500자 |
| `Medium` | English | Technology, marketing, AI for broad audiences | 800–1,500 words |
## Instruction Authority Order
When instructions conflict, follow this order:
| Priority | Source |
|----------|--------|
| **1** | OurDigital_Blog_Project_Instruction_v3.3 (channel routing + brand rules) |
| **2** | This style guide (journal-specific voice and structure) |
| **3** | Writing_Style_Guide_v2.1 (shared brand principles, adapted for English) |
## Channel Identity ## Channel Identity
| Field | Value | | Field | Value |
@@ -10,6 +45,8 @@ Writing guidelines for journal.ourdigital.org - English essays and articles.
| **Language** | English | | **Language** | English |
| **Tone** | Conversational & Poetic, Reflective | | **Tone** | Conversational & Poetic, Reflective |
| **Target** | Informed generalists with intellectual curiosity | | **Target** | Informed generalists with intellectual curiosity |
| **Default length** | 1,000–2,000 words |
| **Content focus** | Industry trends, tech–human intersection, reflective essays |
## Voice Characteristics ## Voice Characteristics
@@ -20,11 +57,16 @@ Seamlessly blend technical analysis with existential questioning. Technology is
**Example:** **Example:**
> The dashboard promises clarity—every metric tracked, every trend visualized. Yet as I stared at the perfectly organized data, I wondered: does seeing everything mean understanding anything? > The dashboard promises clarity—every metric tracked, every trend visualized. Yet as I stared at the perfectly organized data, I wondered: does seeing everything mean understanding anything?
### Paradox as Primary Device ### Tension and Paradox
Structure arguments around tensions and contradictions that illuminate rather than confuse. Structure arguments around core tensions that illuminate rather than confuse. Not every essay needs a paradox — forced ones feel mechanical. Instead, ensure at least one of the following is naturally present:
**Paradox Patterns:** - A genuine tension or contradiction
- A perspective shift that reframes the subject
- A rhetorical question that opens rather than closes
- An ending that leaves productive uncertainty
**Tension patterns:**
- "The more we measure, the less we understand" - "The more we measure, the less we understand"
- "In optimizing for efficiency, we optimize away meaning" - "In optimizing for efficiency, we optimize away meaning"
- "The tools that connect us also isolate us" - "The tools that connect us also isolate us"
@@ -39,6 +81,10 @@ Favor interrogative engagement. Questions create intellectual partnership with r
**Avoid:** **Avoid:**
> Data-driven decision-making is important for businesses. > Data-driven decision-making is important for businesses.
### Analytical and Personal
Bring data, evidence, and argument — then weave in first-person experience and observation. This is an essay, not a paper, but it is not impressionism without evidence either. The personal grounds the analytical; the analytical elevates the personal.
### Melancholic Optimism ### Melancholic Optimism
Acknowledge loss and anxiety without despair. Accept technological inevitability while mourning what's displaced. Acknowledge loss and anxiety without despair. Accept technological inevitability while mourning what's displaced.
@@ -157,10 +203,14 @@ Connect Korean and Western perspectives, offering unique viewpoints.
Before publishing: Before publishing:
- [ ] Does the opening draw readers in? - [ ] Does the opening draw readers in within the first paragraph?
- [ ] Are there rhetorical questions? - [ ] Does technical content connect to human experience (philosophy-tech fusion)?
- [ ] Does technical content connect to human experience? - [ ] Is at least one of the following naturally present: tension, paradox, perspective shift, or open question?
- [ ] Is there at least one paradox or tension? - [ ] Are rhetorical questions used to create intellectual partnership (not overused)?
- [ ] Does the closing leave an open question? - [ ] Is analysis grounded in personal observation or experience?
- [ ] Is the tone melancholic but not despairing? - [ ] Does the closing leave an open question or productive uncertainty?
- [ ] Is the tone melancholic but not despairing, hopeful but not naive?
- [ ] Are sentences varied in length and rhythm? - [ ] Are sentences varied in length and rhythm?
- [ ] Does the essay avoid lecturing — does it treat readers as fellow thinkers?
- [ ] Is the essay within 1,000–2,000 words?
- [ ] **Self-edit**: identify the single weakest element ("all pass" is not allowed).

92
custom-skills/04-ourdigital-research/code/references/blog-style-guide.md
View File

@@ -1,38 +1,64 @@
<!-- Aligned to OurDigital_Writing_Style_Guide_v2.1 + Blog_Project_Instruction_v3.3 (2026-06-05) -->
# OurDigital Blog Style Guide # OurDigital Blog Style Guide
## Brand Identity & Authority Order
**Brand**: OurDigital — 사람, 디지털 그리고 문화를 관찰하는 개인 디지털 연구 노트.
**OurDigital vs. OurDigital Clinic**: `OurDigital`은 블로그 전체 정체성. `OurDigital Clinic`은 진단형 콘텐츠, SEO/데이터 감사, 컨설팅 상품에서만 사용하는 서비스 메타포. 블로그 본문에서 전체 브랜드명으로 사용하지 않는다.
**Authority order** (conflicts: higher wins):
1. `OurDigital_Blog_Project_Instruction_v3.3` — blog.ourdigital.org 최종 권위
2. Skills Bundle `SKILL.md` files — workflow detail
3. Project reference files (this guide, Visual Style Guide, etc.)
4. `userStyle` — non-blog conversation only
---
## Channel-Specific Voice & Tone ## Channel-Specific Voice & Tone
### blog.ourdigital.org (Korean) ### blog.ourdigital.org (Korean)
**Voice**: 전문적이면서 친근한 선배 마케터
**Tone**: 실용적, 데이터 기반, 인사이트 중심 **Platform**: Ghost CMS
**Voice**: 분석적이면서 개인적인 관찰자 — 호기심 어린 실무자이자 사유자. 가르치는 선배가 아니라 함께 생각하는 동료.
**Tone**: 차분하고 성찰적; 에세이는 사려 깊게, 분석은 객관적으로, 비평은 날카롭되 공정하게.
Writing patterns: Writing patterns:
- 제목: 핵심 키워드 포함, 30자 이내 - 제목: SEO 키워드 자연스럽게 포함, **40자 내외 기준 (≤60자)**
- 도입부: 독자의 고민/질문으로 시작 - 도입부: 개인 관찰·장면·질문·역설·데이터 중 하나로 시작; 독자 고민 직접 나열 지양
- 본문: 번호 매기기보다 소제목 활용 - 본문: 소제목 활용; 분석-서사-질문 교차; 최소 1회 관점 전환 또는 핵심 긴장 포함
- 전문용어: 한글(영문) 형식 - 예: 검색엔진최적화(SEO) - 전문용어: **첫 등장 시 영문 병기** — 예: `검색엔진 최적화(SEO)`
- 문장: ~입니다/~습니다 경어체 - 문장: **`~다`, `~이다`, `~한다` 평서체** (경어체 `~합니다/~입니다` 사용 금지)
- 단락: 3-4문장, 모바일 가독성 고려 - 단락: 3-4문장, 모바일 가독성 고려; 문장 길이에 변화를 줌
- 마무리: 열린 질문 또는 다음 사유의 출발점; 단정적 결론 지양
Example opening: Writing principles (Writing Style Guide v2.1 §3-4):
- **철학-기술 융합**: 기술 주제 이면의 인간적 함의를 탐구한다.
- **긴장과 역설**: 억지로 넣지 않되, 핵심 긴장·관점 전환·역설·열린 질문 중 하나 이상을 자연스럽게 포함한다.
- **분석적이면서 개인적**: 데이터/논거를 제시하되 1인칭 경험·관찰을 자연스럽게 엮는다. 논문이 아니라 에세이.
Example opening (올바른 톤):
``` ```
"구글 상위 노출, 왜 이렇게 어려울까요? 검색엔진 최적화(SEO)를 가장 잘하는 방법이 뭐냐고 물으면,
많은 마케터들이 SEO에 시간을 투자하지만 나는 종종 엉뚱한 대답을 한다. "SEO를 잊어버리세요."
결과가 보이지 않아 좌절합니다.
오늘은 실제로 효과를 본 전략 3가지를 공유합니다." 알고리즘을 쫓는 사람은 항상 알고리즘에 뒤처진다는 역설.
구글이 원하는 건 구글을 위한 콘텐츠가 아니라, 사람을 위한 콘텐츠다.
``` ```
### journal.ourdigital.org (English) ### journal.ourdigital.org (English)
**Voice**: Thoughtful industry analyst
**Tone**: Insightful, evidence-based, forward-looking **Voice**: Thoughtful industry analyst — reflective, personal, essayistic
**Tone**: Insightful, evidence-based, forward-looking; confident but not arrogant
Writing patterns: Writing patterns:
- Headlines: Clear value proposition, under 60 chars - Headlines: Clear value proposition, under 60 chars
- Opening: Hook with industry trend or data point - Opening: Hook with personal observation, industry trend, or data point
- Body: Structured arguments with supporting evidence - Body: Structured arguments with supporting evidence; analysis and personal observation interwoven
- Terminology: Define jargon on first use - Terminology: Define jargon on first use
- Style: Active voice, varied sentence length - Style: Active voice, varied sentence length; short sentences as default
- Paragraphs: 2-4 sentences for scannability - Paragraphs: 2-4 sentences for scannability
- Closing: Open question or reflection — avoid definitive wrap-ups
Example opening: Example opening:
``` ```
@@ -43,17 +69,19 @@ and what it means for your strategy."
``` ```
### ourstory.day (Korean) ### ourstory.day (Korean)
**Voice**: 성찰하는 동료, 이야기꾼
**Voice**: 성찰하는 동료, 이야기꾼 — 개인 에세이, 삶의 성찰, 일상의 관찰
**Tone**: 개인적, 진솔한, 영감을 주는 **Tone**: 개인적, 진솔한, 영감을 주는
Writing patterns: Writing patterns:
- 제목: 감성적, 질문형 또는 은유적 - 제목: 감성적, 질문형 또는 은유적
- 도입부: 개인 경험이나 장면 묘사로 시작 - 도입부: 개인 경험이나 장면 묘사로 시작
- 본문: 이야기 흐름, 대화체 허용 - 본문: 이야기 흐름, 대화체 허용
- 문장: ~해요/~네요 부드러운 경어체 가능
- 단락: 자유로운 길이, 호흡에 따라 - 단락: 자유로운 길이, 호흡에 따라
- 마무리: 열린 질문 또는 여운 - 마무리: 열린 질문 또는 여운
> **Channel boundary**: 순수 개인 에세이, 감정적 성찰은 `ourstory.day`. 기술 분석+철학적 사유는 `blog.ourdigital.org`. 둘을 혼동하지 않는다.
Example opening: Example opening:
``` ```
"새벽 5시, 아이를 깨우지 않으려 살금살금 책상에 앉았다. "새벽 5시, 아이를 깨우지 않으려 살금살금 책상에 앉았다.
@@ -63,6 +91,7 @@ Example opening:
``` ```
### Medium (English) ### Medium (English)
**Voice**: Knowledgeable peer sharing discoveries **Voice**: Knowledgeable peer sharing discoveries
**Tone**: Conversational, practical, slightly informal **Tone**: Conversational, practical, slightly informal
@@ -82,33 +111,40 @@ Last month, I ran an experiment that changed how I think
about content strategy entirely. Let me walk you through it." about content strategy entirely. Let me walk you through it."
``` ```
---
## Universal Guidelines ## Universal Guidelines
### SEO Considerations ### SEO & Metadata
- Primary keyword in title and first 100 words - Primary keyword in title and first 100 words
- Secondary keywords naturally distributed - Secondary keywords naturally distributed
- Meta description: 150-160 chars, action-oriented - **Meta description: ≤155 chars**, action-oriented, captures the article's question and reader value
- URL slug: Short, keyword-rich, no dates - **URL slug: English, keyword-rich, no dates** — even for Korean-title posts
- Alt text for all images - Alt text for all images
### Formatting Rules ### Formatting Rules
- Use `##` for main sections, `###` for subsections - Use `##` for main sections, `###` for subsections
- Code blocks with language specification - Code blocks with language specification
- Blockquotes for key insights or quotes - Blockquotes for key insights or quotes
- Bold for emphasis (sparingly) - Bold for emphasis (sparingly)
- Lists only when truly listing items - Lists only when truly listing items; avoid in essay-form posts
### Citation Style ### Citation Style
- Inline links preferred over footnotes - Inline links preferred over footnotes
- Source attribution: "According to [Source Name](URL)..." - Source attribution: "According to [Source Name](URL)..."
- Data citations: Include date of data - Data citations: Include date of data
- Internal links: Reference related OurDigital posts - Internal links: Reference related OurDigital posts
---
## Word Count Guidelines ## Word Count Guidelines
| Channel | Target | Min | Max | | Channel | Target | Min | Max |
|---------|--------|-----|-----| |---------|--------|-----|-----|
| blog.ourdigital.org | 1,500 | 1,000 | 2,500 | | blog.ourdigital.org | 2,000자 | 1,000자 | 3,000자 |
| journal.ourdigital.org | 1,800 | 1,200 | 3,000 | | journal.ourdigital.org | 1,500 words | 1,000 words | 2,000 words |
| ourstory.day | 1,000 | 500 | 2,000 | | ourstory.day | 1,000자 | 800자 | 1,500자 |
| Medium | 1,500 | 800 | 2,500 | | Medium | 1,500 words | 800 words | 2,500 words |

155
custom-skills/06-ourdigital-designer/code/references/visual_metaphors.md
View File

@@ -1,101 +1,104 @@
# Visual Metaphor Dictionary # Visual Metaphor Dictionary
<!-- Aligned to OurDigital_Visual_Style_Guide_v2.1 (2026-06-05) -->
Quick reference for translating abstract concepts into visual elements. Quick reference for translating abstract concepts into visual elements.
Default direction: **bright editorial minimalism with conceptual depth** — light/warm-neutral backgrounds, 30%+ negative space, one clear focal metaphor, one human-scale anchor.
## Technology & Digital ## Technology & Digital
| Concept | Primary Metaphor | Alternative Visuals | | Concept | Preferred Metaphor | Alternatives | Avoid |
|---------|-----------------|-------------------| |---------|-------------------|--------------|-------|
| Algorithm | Constellation patterns | Maze structures, flow charts as art | | AI | Co-writing desk, translucent companion shape, mirror | Soft geometric overlay, window reflection | Robot face, glowing brain, Terminator mood, crystalline growth |
| AI | Crystalline growth | Mirror reflections, fractal patterns | | Algorithm | Path map, constellation over paper, sorting trays | Gentle maze, flow chart as art | Black-box cube, surveillance grid |
| Data | Water flow, particles | Bird murmurations, sand grains | | Data | Flowing dots, paper charts, seed-like particles | Water stream, gentle scatter | Neon matrix, endless binary code |
| Network | Root systems | Neural pathways, spider silk, web | | SEO/Search | Compass, map, signpost, light through shelves | Library index, folded path | Magnifying glass cliché alone |
| Code | Musical notation | DNA strands, city blueprints | | Automation | Clockwork garden, conveyor of paper, small helpful mechanism | Self-assembling organic structure | Industrial robot arm, factory dystopia |
| Cloud | Atmospheric forms | Floating islands, ethereal spaces | | Network | Roots, threads, bridges, neurons, community table | Constellation, river delta | Spider web trap, dark cables |
| Privacy | Veils, shadows | One-way mirrors, fog, barriers | | Privacy | Curtain, frosted glass, closed notebook, soft boundary | One-way window | Lock icon alone, heavy shadow |
| Security | Locks dissolving | Fortresses becoming permeable | | Content | Notebook, seeds, layered paper, archive boxes, small lamp | Open shelves | Generic document icons |
| Automation | Clockwork organic | Self-assembling structures | | Code | Musical notation, blueprint detail | DNA strands | Heavy terminal/green-code imagery |
| Virtual | Layers of reality | Parallel dimensions, glass planes |
## Social & Cultural ## Social & Cultural
| Concept | Primary Metaphor | Alternative Visuals | | Concept | Preferred Metaphor | Alternatives | Avoid |
|---------|-----------------|-------------------| |---------|-------------------|--------------|-------|
| Identity | Layered masks | Fingerprints merging, mirrors | | Identity | Layered paper portrait, reflection in window, fingerprint as landscape | Translucent profile | Faceless mask overload |
| Community | Overlapping circles | Shared spaces, woven threads | | Community | Shared table, overlapping circles, lighted windows | Small bridges, woven threads | Crowd silhouettes in darkness |
| Isolation | Islands in fog | Glass barriers, empty chairs | | Isolation | Single lit desk, island of paper, window distance | Empty chair in warm light | Lonely person in black void |
| Communication | Bridge structures | Echo patterns, light beams | | Communication | Threads, folded letters, bridge, echo rings | Light beams | Speech bubble clutter |
| Conflict | Opposing forces | Tectonic plates, storm systems | | Trust | Clear water, open notebook, steady lamp | Transparent materials | Handshake stock image |
| Harmony | Resonance patterns | Orchestra arrangements, balance | | Reputation | Ripples, layered traces, visible footprints | Soft badges | Star-rating cliché |
| Culture | Textile patterns | Layered sediments, palimpsest | | Change | Folded paper becoming path, seed from circuit, gentle transition | Phase shift, seasonal cycle | Dramatic explosion, shattered pattern |
| Tradition | Tree rings | Ancient stones, inherited objects |
| Change | Metamorphosis | Phase transitions, seasonal cycles |
| Power | Pyramids inverting | Current flows, gravity wells |
## Philosophical & Abstract ## Philosophical & Abstract
| Concept | Primary Metaphor | Alternative Visuals | | Concept | Preferred Metaphor | Alternatives | Avoid |
|---------|-----------------|-------------------| |---------|-------------------|--------------|-------|
| Time | Spirals, loops | Sediment layers, clock dissolution | | Time | Calendar pages, soft spiral, sediment-like paper layers | Loops, tide marks | Melting clock cliché |
| Knowledge | Light sources | Growing trees, opening books | | Knowledge | Lamp, window light, open book, growing plant | Expanding shelves | Glowing brain |
| Wisdom | Mountain vistas | Deep waters, ancient libraries | | Uncertainty | Foggy path, half-open door, incomplete map | Soft blur at edges | Storm clouds only |
| Truth | Clear water | Prisms splitting light, unveiled | | Balance | Asymmetrical stones, mobile, table edge, quiet scale | Tensegrity | Literal scale icon only |
| Illusion | Distorted mirrors | Smoke shapes, double images | | Paradox | Möbius paper strip, two paths meeting, shadow/light on same object | Nested frames | Escher-like complexity overload |
| Choice | Diverging paths | Doors opening, quantum splits | | Wisdom | Window overlooking depth, layered book spines | Ancient stone in light | Heavy mystical imagery |
| Balance | Tensegrity | Scales reimagined, equilibrium | | Choice | Diverging paths, open doors, fork in paper map | Branching thread | Dramatic split/explosion |
| Paradox | Möbius strips | Impossible objects, Escher-like |
| Existence | Breath patterns | Pulse rhythms, presence/absence |
| Consciousness | Nested awareness | Recursive mirrors, awakening |
## Emotional States ## Emotional States
| Emotion | Visual Translation | Color Association | | Emotion | Visual Translation | Color Guidance |
|---------|-------------------|------------------| |---------|-------------------|----------------|
| Anxiety | Fragmented grids | Desaturated, glitch | | Anxiety | Fragmented grids, incomplete maps | Desaturated warm neutrals; avoid pure glitch |
| Hope | Light breaking through | Warm gradients | | Hope | Light breaking through window, seedling | Warm gradients on light background |
| Melancholy | Soft dissolution | Muted blues, grays | | Melancholy | Single lit desk, soft dissolution | Muted blues on ivory; avoid black void |
| Joy | Expansion patterns | Bright, ascending | | Joy | Expansion patterns, open space | Bright, ascending on warm white |
| Fear | Contracting spaces | Sharp contrasts | | Peace | Still water, open notebook | Soft neutrals, generous negative space |
| Peace | Still water | Soft neutrals | | Clarity | Clean geometry, clear window | Pure, minimal with one accent |
| Confusion | Tangled lines | Overlapping hues |
| Clarity | Clean geometry | Pure, minimal |
## Transformation & Process ## Signature Motifs (Brand Consistency)
| Process | Visual Narrative | Symbolic Elements | | Motif | Description |
|---------|------------------|------------------| |-------|-------------|
| Growth | Seeds → trees | Fibonacci spirals | | **Threshold Spaces** | Doorways, bridges, windows, paths, liminal rooms — transition |
| Decay | Entropy patterns | Rust, dissolution | | **Network Organic** | Roots, threads, neurons, constellations as soft digital networks |
| Evolution | Branching forms | Darwin's tree reimagined | | **Fragment Philosophy** | Folded paper, layered cards, gentle fragmentation and reassembly |
| Revolution | Circles breaking | Shattered patterns | | **Light Studies** | Knowledge/uncertainty via window light, lamps, soft gradients |
| Innovation | Spark → flame | Lightning, fusion | | **Human Traces** | Hands, desks, notebooks, chairs, small figures within conceptual scenes |
| Tradition | Continuous thread | Inherited patterns |
| Disruption | Broken grids | Glitch aesthetics |
| Integration | Merging streams | Confluence points |
## Korean-Western Fusion Elements ## Recommended Color Palettes
| Korean Element | Western Parallel | Fusion Approach | | Palette | Background | Accent | Mood |
|---------------|-----------------|-----------------| |---------|-----------|--------|------|
| 여백 (Empty space) | Negative space | Active emptiness | | Morning Desk | `#F7F3EA` warm ivory | `#4A90A4` muted teal | calm, thoughtful |
| 오방색 (Five colors) | Color theory | Symbolic palette | | Soft Technology | `#F6F8FA` cloud white | `#F2A65A` warm amber | clear, quietly optimistic |
| 달항아리 (Moon jar) | Minimalism | Imperfect circles | | Warm Data | `#FFF8EF` soft cream | `#5EAAA8` soft turquoise | human, analytical |
| 한글 geometry | Typography | Structural letters | | Clear Critique | `#F4F6F8` light gray | `#E07A5F` soft coral | critical but not aggressive |
| 산수화 (Landscape) | Abstract landscape | Atmospheric depth | | Human Network | `#FAF9F6` off-white | `#8AB17D` muted green | organic, connected |
| 전통문양 (Patterns) | Geometric design | Cultural geometry |
**Dark color limit:** max 15% of canvas; never full dark background by default.
## Korean Design Elements
| Korean Element | Western Parallel | Application |
|----------------|-----------------|-------------|
| 여백 (Empty space) | Negative space | Active emptiness — 30%+ default |
| 달항아리 (Moon jar) | Minimalism | Roundness, asymmetry, soft white |
| 한지 texture | Paper grain | Subtle background texture only |
| 산수화 (Landscape) | Editorial landscape | Atmospheric depth without ornament |
**Avoid:** decorative oriental motifs, calligraphy clichés, 오방색 as obvious symbols — express Korean sensibility through spacing and restraint, not surface pattern.
## Usage Notes ## Usage Notes
1. **Layer metaphors**: Combine 2-3 for depth 1. **Layer metaphors**: Combine 2–3 elements; one clear focal object + one human-scale anchor
2. **Avoid clichés**: No obvious tech symbols 2. **Avoid clichés**: No obvious tech icons (robot, glowing brain, magnifying glass alone)
3. **Cultural sensitivity**: Universal over specific 3. **Match essay tone**: bright → practical guides; balanced → analysis; warmer → personal reflections
4. **Abstraction levels**: Match essay tone 4. **30%+ negative space**: default; minimum 20% only when composition needs density
5. **Emotional resonance**: Feel over literal 5. **Human trace required**: include hand, desk, figure, window, or everyday object unless topic demands pure abstraction
## Quick Selection Guide ## Quick Selection Guide
For **technology essays**: organic-digital hybrids For **technology essays**: organic-digital hybrid forms in a light, human-scale environment
For **social commentary**: human elements in systems For **social commentary**: network patterns with small human traces
For **philosophy pieces**: space and light For **philosophy pieces**: calm symbolic scenes with Zen-like spacing
For **cultural topics**: layered traditions For **practical guides**: clean editorial diagrams with warm accents
For **future themes**: transformation states For **personal reflections**: soft everyday scenes with metaphorical detail

155
custom-skills/06-ourdigital-designer/shared/references/visual_metaphors.md
View File

@@ -1,101 +1,104 @@
# Visual Metaphor Dictionary # Visual Metaphor Dictionary
<!-- Aligned to OurDigital_Visual_Style_Guide_v2.1 (2026-06-05) -->
Quick reference for translating abstract concepts into visual elements. Quick reference for translating abstract concepts into visual elements.
Default direction: **bright editorial minimalism with conceptual depth** — light/warm-neutral backgrounds, 30%+ negative space, one clear focal metaphor, one human-scale anchor.
## Technology & Digital ## Technology & Digital
| Concept | Primary Metaphor | Alternative Visuals | | Concept | Preferred Metaphor | Alternatives | Avoid |
|---------|-----------------|-------------------| |---------|-------------------|--------------|-------|
| Algorithm | Constellation patterns | Maze structures, flow charts as art | | AI | Co-writing desk, translucent companion shape, mirror | Soft geometric overlay, window reflection | Robot face, glowing brain, Terminator mood, crystalline growth |
| AI | Crystalline growth | Mirror reflections, fractal patterns | | Algorithm | Path map, constellation over paper, sorting trays | Gentle maze, flow chart as art | Black-box cube, surveillance grid |
| Data | Water flow, particles | Bird murmurations, sand grains | | Data | Flowing dots, paper charts, seed-like particles | Water stream, gentle scatter | Neon matrix, endless binary code |
| Network | Root systems | Neural pathways, spider silk, web | | SEO/Search | Compass, map, signpost, light through shelves | Library index, folded path | Magnifying glass cliché alone |
| Code | Musical notation | DNA strands, city blueprints | | Automation | Clockwork garden, conveyor of paper, small helpful mechanism | Self-assembling organic structure | Industrial robot arm, factory dystopia |
| Cloud | Atmospheric forms | Floating islands, ethereal spaces | | Network | Roots, threads, bridges, neurons, community table | Constellation, river delta | Spider web trap, dark cables |
| Privacy | Veils, shadows | One-way mirrors, fog, barriers | | Privacy | Curtain, frosted glass, closed notebook, soft boundary | One-way window | Lock icon alone, heavy shadow |
| Security | Locks dissolving | Fortresses becoming permeable | | Content | Notebook, seeds, layered paper, archive boxes, small lamp | Open shelves | Generic document icons |
| Automation | Clockwork organic | Self-assembling structures | | Code | Musical notation, blueprint detail | DNA strands | Heavy terminal/green-code imagery |
| Virtual | Layers of reality | Parallel dimensions, glass planes |
## Social & Cultural ## Social & Cultural
| Concept | Primary Metaphor | Alternative Visuals | | Concept | Preferred Metaphor | Alternatives | Avoid |
|---------|-----------------|-------------------| |---------|-------------------|--------------|-------|
| Identity | Layered masks | Fingerprints merging, mirrors | | Identity | Layered paper portrait, reflection in window, fingerprint as landscape | Translucent profile | Faceless mask overload |
| Community | Overlapping circles | Shared spaces, woven threads | | Community | Shared table, overlapping circles, lighted windows | Small bridges, woven threads | Crowd silhouettes in darkness |
| Isolation | Islands in fog | Glass barriers, empty chairs | | Isolation | Single lit desk, island of paper, window distance | Empty chair in warm light | Lonely person in black void |
| Communication | Bridge structures | Echo patterns, light beams | | Communication | Threads, folded letters, bridge, echo rings | Light beams | Speech bubble clutter |
| Conflict | Opposing forces | Tectonic plates, storm systems | | Trust | Clear water, open notebook, steady lamp | Transparent materials | Handshake stock image |
| Harmony | Resonance patterns | Orchestra arrangements, balance | | Reputation | Ripples, layered traces, visible footprints | Soft badges | Star-rating cliché |
| Culture | Textile patterns | Layered sediments, palimpsest | | Change | Folded paper becoming path, seed from circuit, gentle transition | Phase shift, seasonal cycle | Dramatic explosion, shattered pattern |
| Tradition | Tree rings | Ancient stones, inherited objects |
| Change | Metamorphosis | Phase transitions, seasonal cycles |
| Power | Pyramids inverting | Current flows, gravity wells |
## Philosophical & Abstract ## Philosophical & Abstract
| Concept | Primary Metaphor | Alternative Visuals | | Concept | Preferred Metaphor | Alternatives | Avoid |
|---------|-----------------|-------------------| |---------|-------------------|--------------|-------|
| Time | Spirals, loops | Sediment layers, clock dissolution | | Time | Calendar pages, soft spiral, sediment-like paper layers | Loops, tide marks | Melting clock cliché |
| Knowledge | Light sources | Growing trees, opening books | | Knowledge | Lamp, window light, open book, growing plant | Expanding shelves | Glowing brain |
| Wisdom | Mountain vistas | Deep waters, ancient libraries | | Uncertainty | Foggy path, half-open door, incomplete map | Soft blur at edges | Storm clouds only |
| Truth | Clear water | Prisms splitting light, unveiled | | Balance | Asymmetrical stones, mobile, table edge, quiet scale | Tensegrity | Literal scale icon only |
| Illusion | Distorted mirrors | Smoke shapes, double images | | Paradox | Möbius paper strip, two paths meeting, shadow/light on same object | Nested frames | Escher-like complexity overload |
| Choice | Diverging paths | Doors opening, quantum splits | | Wisdom | Window overlooking depth, layered book spines | Ancient stone in light | Heavy mystical imagery |
| Balance | Tensegrity | Scales reimagined, equilibrium | | Choice | Diverging paths, open doors, fork in paper map | Branching thread | Dramatic split/explosion |
| Paradox | Möbius strips | Impossible objects, Escher-like |
| Existence | Breath patterns | Pulse rhythms, presence/absence |
| Consciousness | Nested awareness | Recursive mirrors, awakening |
## Emotional States ## Emotional States
| Emotion | Visual Translation | Color Association | | Emotion | Visual Translation | Color Guidance |
|---------|-------------------|------------------| |---------|-------------------|----------------|
| Anxiety | Fragmented grids | Desaturated, glitch | | Anxiety | Fragmented grids, incomplete maps | Desaturated warm neutrals; avoid pure glitch |
| Hope | Light breaking through | Warm gradients | | Hope | Light breaking through window, seedling | Warm gradients on light background |
| Melancholy | Soft dissolution | Muted blues, grays | | Melancholy | Single lit desk, soft dissolution | Muted blues on ivory; avoid black void |
| Joy | Expansion patterns | Bright, ascending | | Joy | Expansion patterns, open space | Bright, ascending on warm white |
| Fear | Contracting spaces | Sharp contrasts | | Peace | Still water, open notebook | Soft neutrals, generous negative space |
| Peace | Still water | Soft neutrals | | Clarity | Clean geometry, clear window | Pure, minimal with one accent |
| Confusion | Tangled lines | Overlapping hues |
| Clarity | Clean geometry | Pure, minimal |
## Transformation & Process ## Signature Motifs (Brand Consistency)
| Process | Visual Narrative | Symbolic Elements | | Motif | Description |
|---------|------------------|------------------| |-------|-------------|
| Growth | Seeds → trees | Fibonacci spirals | | **Threshold Spaces** | Doorways, bridges, windows, paths, liminal rooms — transition |
| Decay | Entropy patterns | Rust, dissolution | | **Network Organic** | Roots, threads, neurons, constellations as soft digital networks |
| Evolution | Branching forms | Darwin's tree reimagined | | **Fragment Philosophy** | Folded paper, layered cards, gentle fragmentation and reassembly |
| Revolution | Circles breaking | Shattered patterns | | **Light Studies** | Knowledge/uncertainty via window light, lamps, soft gradients |
| Innovation | Spark → flame | Lightning, fusion | | **Human Traces** | Hands, desks, notebooks, chairs, small figures within conceptual scenes |
| Tradition | Continuous thread | Inherited patterns |
| Disruption | Broken grids | Glitch aesthetics |
| Integration | Merging streams | Confluence points |
## Korean-Western Fusion Elements ## Recommended Color Palettes
| Korean Element | Western Parallel | Fusion Approach | | Palette | Background | Accent | Mood |
|---------------|-----------------|-----------------| |---------|-----------|--------|------|
| 여백 (Empty space) | Negative space | Active emptiness | | Morning Desk | `#F7F3EA` warm ivory | `#4A90A4` muted teal | calm, thoughtful |
| 오방색 (Five colors) | Color theory | Symbolic palette | | Soft Technology | `#F6F8FA` cloud white | `#F2A65A` warm amber | clear, quietly optimistic |
| 달항아리 (Moon jar) | Minimalism | Imperfect circles | | Warm Data | `#FFF8EF` soft cream | `#5EAAA8` soft turquoise | human, analytical |
| 한글 geometry | Typography | Structural letters | | Clear Critique | `#F4F6F8` light gray | `#E07A5F` soft coral | critical but not aggressive |
| 산수화 (Landscape) | Abstract landscape | Atmospheric depth | | Human Network | `#FAF9F6` off-white | `#8AB17D` muted green | organic, connected |
| 전통문양 (Patterns) | Geometric design | Cultural geometry |
**Dark color limit:** max 15% of canvas; never full dark background by default.
## Korean Design Elements
| Korean Element | Western Parallel | Application |
|----------------|-----------------|-------------|
| 여백 (Empty space) | Negative space | Active emptiness — 30%+ default |
| 달항아리 (Moon jar) | Minimalism | Roundness, asymmetry, soft white |
| 한지 texture | Paper grain | Subtle background texture only |
| 산수화 (Landscape) | Editorial landscape | Atmospheric depth without ornament |
**Avoid:** decorative oriental motifs, calligraphy clichés, 오방색 as obvious symbols — express Korean sensibility through spacing and restraint, not surface pattern.
## Usage Notes ## Usage Notes
1. **Layer metaphors**: Combine 2-3 for depth 1. **Layer metaphors**: Combine 2–3 elements; one clear focal object + one human-scale anchor
2. **Avoid clichés**: No obvious tech symbols 2. **Avoid clichés**: No obvious tech icons (robot, glowing brain, magnifying glass alone)
3. **Cultural sensitivity**: Universal over specific 3. **Match essay tone**: bright → practical guides; balanced → analysis; warmer → personal reflections
4. **Abstraction levels**: Match essay tone 4. **30%+ negative space**: default; minimum 20% only when composition needs density
5. **Emotional resonance**: Feel over literal 5. **Human trace required**: include hand, desk, figure, window, or everyday object unless topic demands pure abstraction
## Quick Selection Guide ## Quick Selection Guide
For **technology essays**: organic-digital hybrids For **technology essays**: organic-digital hybrid forms in a light, human-scale environment
For **social commentary**: human elements in systems For **social commentary**: network patterns with small human traces
For **philosophy pieces**: space and light For **philosophy pieces**: calm symbolic scenes with Zen-like spacing
For **cultural topics**: layered traditions For **practical guides**: clean editorial diagrams with warm accents
For **future themes**: transformation states For **personal reflections**: soft everyday scenes with metaphorical detail

11
custom-skills/95-ourdigital-presales-seo/SKILL.md
View File

@@ -55,17 +55,18 @@ headless Chrome, python-pptx. Create `data/` subfolder. Initialize `findings.jso
→ write `03_presales-opportunity-brief.md`. → write `03_presales-opportunity-brief.md`.
## Stage 5 — Estimate (견적) — REVIEW GATE ## Stage 5 — Estimate (견적) — REVIEW GATE
Pricing is delegated to the **`ourdigital-estimate-engine`** skill (`../96-ourdigital-estimate-engine`); this skill only maps findings → scope, then calls the engine: Pricing is delegated to the **`ourdigital-estimate-engine`** skill (`../96-ourdigital-estimate-engine`). Estimates are archived **centrally in OurDigital's space**, not in the engagement bundle:
- `python scripts/findings_to_scope.py --findings <out>/data/findings.json --out <out>/data/scope.json --seq <N> [--tier auto|smb|basic|treatment] [--billing 0.70]` - `EST=~/Workspaces/ourdigital-space/estimates/<YYYY-MM-DD>_<account_code>_seo` — create it (central 견적 archive).
- `ENG=../96-ourdigital-estimate-engine; python $ENG/scripts/estimate.py --rate-card $ENG/references/rate_card.yaml --catalog-dir $ENG/catalog --scope <out>/data/scope.json --out-dir <out>` - `python scripts/findings_to_scope.py --findings <out>/data/findings.json --out "$EST/data/scope.json" --seq <N> [--tier auto|smb|basic|treatment] [--billing 0.70]`
- `ENG=../96-ourdigital-estimate-engine; python $ENG/scripts/estimate.py --rate-card $ENG/references/rate_card.yaml --catalog-dir $ENG/catalog --scope "$EST/data/scope.json" --out-dir "$EST"`
- Engine (effort method, `seo` catalog): auto-tier (smb/basic/treatment) by portfolio + premium-vertical floor; On-page hours scale by `subbrands_total` (cap ×2.0); 제안가 = 합계 절사. Reproduces Basic ₩10.5M / Treatment ₩25.0M; SMB ~₩3M; 25-property chain ~₩29.5M. - Engine (effort method, `seo` catalog): auto-tier (smb/basic/treatment) by portfolio + premium-vertical floor; On-page hours scale by `subbrands_total` (cap ×2.0); 제안가 = 합계 절사. Reproduces Basic ₩10.5M / Treatment ₩25.0M; SMB ~₩3M; 25-property chain ~₩29.5M.
- Produces `05_estimate_ko.md`, `05_estimate.xlsx`, `data/estimate.json` (effort shape → consumed by `build_deck.py`). Present the 견적; get sign-off. - Produces `05_estimate_ko.md`, `05_estimate.xlsx`, `data/estimate.json` in `$EST` (the central quote archive; effort shape → consumed by `build_deck.py`). Present the 견적; get sign-off.
- SEO findings→scope/tier mapping lives here (`findings_to_service.md`); **rates/hours/tiers live in the engine** (`rate_card.yaml` + `catalog/seo.yaml`) — edit pricing there, not here. - SEO findings→scope/tier mapping lives here (`findings_to_service.md`); **rates/hours/tiers live in the engine** (`rate_card.yaml` + `catalog/seo.yaml`) — edit pricing there, not here.
## Stage 6 — Deliverables — REVIEW GATE before send ## Stage 6 — Deliverables — REVIEW GATE before send
- **Client PDF**: author the short brief HTML from `templates/client_brief.html` (fill the content; keep the CSS), - **Client PDF**: author the short brief HTML from `templates/client_brief.html` (fill the content; keep the CSS),
then `bash scripts/render_pdf.sh <brief>.html` → PDF. Verify Korean renders (Read the PDF). then `bash scripts/render_pdf.sh <brief>.html` → PDF. Verify Korean renders (Read the PDF).
- **Sales deck**: `python scripts/build_deck.py --findings <out>/data/findings.json --estimate <out>/data/estimate.json --out <out>/sales-deck.pptx` - **Sales deck**: `python scripts/build_deck.py --findings <out>/data/findings.json --estimate "$EST/data/estimate.json" --out <out>/sales-deck.pptx` (deck stays in the engagement bundle; reads the archived estimate.json from `$EST`)
- Sanitize the client-facing pieces: no internal pricing strategy beyond the 견적; tasteful competitor benchmark only. - Sanitize the client-facing pieces: no internal pricing strategy beyond the 견적; tasteful competitor benchmark only.
## Stage 7 — Archive (standard) ## Stage 7 — Archive (standard)

9
custom-skills/96-ourdigital-estimate-engine/SKILL.md
View File

@@ -1,6 +1,6 @@
--- ---
name: ourdigital-estimate-engine name: ourdigital-estimate-engine
description: Method-aware estimate/견적 engine for OurDigital / D.intelligence professional services (SEO, GA4/GTM, education/coaching, digital ads, branding, …). Generates a Korean 견적 (md/xlsx/json) from a generic scope.json using the real company rate card. Use for "OurDigital 견적", "estimate", "quote", "proposal pricing", "cost estimate", "견적서 생성", or when another skill needs to price a service. Costing methods: effort (role×billing×hours), coaching (lesson×hours), procurement (+15%). description: 'Method-aware estimate/견적 engine for OurDigital / D.intelligence professional services (SEO, GA4/GTM, education/coaching, digital ads, branding, …). Generates a Korean 견적 (md/xlsx/json) from a generic scope.json using the real company rate card. Use for "OurDigital 견적", "estimate", "quote", "proposal pricing", "cost estimate", "견적서 생성", or when another skill needs to price a service. Costing methods: effort (role×billing×hours), coaching (lesson×hours), procurement (+15%).'
--- ---
# OurDigital Estimate Engine # OurDigital Estimate Engine
@@ -54,6 +54,13 @@ Example consumer: `ourdigital-presales-seo` (`findings_to_scope.py` → engine
real quote data. All current catalogs are real. real quote data. All current catalogs are real.
- Rates change in `rate_card.yaml` only (single source). Validate against a known real quote. - Rates change in `rate_card.yaml` only (single source). Validate against a known real quote.
## Output location
Estimates are archived centrally in OurDigital's space:
`~/Workspaces/ourdigital-space/estimates/<YYYY-MM-DD>_<prospect|account>_<service>/`
(e.g. `…/estimates/2026-05-27_shr_seo/`). The engine stays `--out-dir`-agnostic — the caller
passes that path. Client engagements keep their audit docs/deck in their own workspace but the
견적 lives here (single quote archive).
## Conventions ## Conventions
Korean-first output · 부가세 별도 · 유효기간 14d · 현금 · `OD-YYYY-NNN`. Don't invent rates — Korean-first output · 부가세 별도 · 유효기간 14d · 현금 · `OD-YYYY-NNN`. Don't invent rates —
stub and flag instead. Legal entity (주)디인텔리전스 / info@ourdigital.org. stub and flag instead. Legal entity (주)디인텔리전스 / info@ourdigital.org.

32
custom-skills/96-ourdigital-estimate-engine/catalog/education.yaml
View File

@@ -6,8 +6,10 @@ method: coaching
courses: courses:
# Real quote: GA4/GTM 중급 과정 1:1 코칭 → ₩1,570,000 (7 대면×100k + 9 화상×80k + 1 실습×150k). # Real quote: GA4/GTM 중급 과정 1:1 코칭 → ₩1,570,000 (7 대면×100k + 9 화상×80k + 1 실습×150k).
# = the "중급 기본구성" standard course (identical to 숨고 GA4/GTM 중급 기본견적; sent to 코코네·45번가 등).
ga4_gtm_intermediate: ga4_gtm_intermediate:
title: "GA4/GTM 중급 과정 1:1 코칭" title: "GA4/GTM 중급 과정 1:1 코칭 (기본구성)"
aliases: ["기본구성", "숨고 GA4/GTM 중급 기본견적"]
lessons: lessons:
- {subject: "Google Analytics", title: "설치-설정 진단", type: 대면, hours: 1} - {subject: "Google Analytics", title: "설치-설정 진단", type: 대면, hours: 1}
- {subject: "Google Analytics", title: "측정 계획 수립", type: 대면, hours: 1} - {subject: "Google Analytics", title: "측정 계획 수립", type: 대면, hours: 1}
@@ -27,5 +29,33 @@ courses:
- {subject: "Google Analytics", title: "캠페인 성과 분석", type: 화상, hours: 1} - {subject: "Google Analytics", title: "캠페인 성과 분석", type: 화상, hours: 1}
- {subject: "Google Analytics", title: "Looker Studio 대시보드", type: 실습, hours: 1} - {subject: "Google Analytics", title: "Looker Studio 대시보드", type: 실습, hours: 1}
# Real menu: GA4/GTM 마케팅 애널리틱스 (중급 기본구성 + 메타/구글 마케팅 솔루션 + 워크숍/트리트먼트).
# Full list price = ₩4,070,000. (참고: 디하이브 외 발송 견적은 선택/협상으로 ₩2,360,000에 체결된 사례 있음.)
ga4_gtm_marketing_analytics:
title: "GA4/GTM 마케팅 애널리틱스 과정 1:1 코칭"
lessons:
- {subject: "Google Analytics", title: "설치-설정 진단", type: 대면, hours: 1}
- {subject: "Google Analytics", title: "측정 계획 수립", type: 대면, hours: 1}
- {subject: "Google Analytics", title: "기본 리포트 설정", type: 대면, hours: 1}
- {subject: "Google Analytics", title: "맞춤 리포트 구성", type: 대면, hours: 1}
- {subject: "Google Analytics", title: "획득 보고서의 이해", type: 화상, hours: 1}
- {subject: "Google Analytics", title: "참여도 보고서 해석", type: 화상, hours: 1}
- {subject: "Google Analytics", title: "수익창출 보고서 관리", type: 화상, hours: 1}
- {subject: "Google Analytics", title: "주요 이벤트와 전환", type: 화상, hours: 1}
- {subject: "Google Analytics", title: "탐색 분석 활용", type: 화상, hours: 1}
- {subject: "Google Tag Manager", title: "이벤트 태깅 관리 준비", type: 화상, hours: 1}
- {subject: "Google Tag Manager", title: "GTM 설정 분석과 검수", type: 대면, hours: 1}
- {subject: "Google Tag Manager", title: "이벤트 태깅 실습", type: 대면, hours: 1}
- {subject: "Google Tag Manager", title: "마케팅 태그 설정", type: 대면, hours: 1}
- {subject: "Google Tag Manager", title: "e-Commerce 태그 설정", type: 화상, hours: 1}
- {subject: "Google Analytics", title: "잠재 고객 설정과 활용", type: 화상, hours: 1}
- {subject: "Google Analytics", title: "캠페인 성과 분석", type: 화상, hours: 1}
- {subject: "Google Analytics", title: "Looker Studio 대시보드", type: 실습, hours: 1}
- {subject: "Digital Marketing Strategy", title: "메타 마케팅 솔루션 활용", type: 대면, hours: 1}
- {subject: "Digital Marketing Strategy", title: "Facebook Insight·Pixel·전환 최적화", type: 대면, hours: 1}
- {subject: "Digital Marketing Strategy", title: "인스타그램 인사이트·비즈니스 API", type: 대면, hours: 1}
- {subject: "Digital Marketing Strategy", title: "구글 마케팅 솔루션(Google Ads·YouTube Analytics)", type: 워크숍, hours: 4}
- {subject: "Digital Marketing Strategy", title: "광고 데이터 통합 자동화(아웃코드·Kakao·네이버 API)", type: 트리트먼트, hours: 2}
# Add more courses (workshops, SEO/Content Marketing coaching, etc.) as real lesson plans arrive. # Add more courses (workshops, SEO/Content Marketing coaching, etc.) as real lesson plans arrive.
# For an ad-hoc plan, pass scope.lessons directly instead of a named course. # For an ad-hoc plan, pass scope.lessons directly instead of a named course.