Files
our-claude-skills/custom-skills/04-ourdigital-research/code/references/blog-style-guide.md
Andrew Yim 8ffb6bec6b
Some checks failed
Verify Skills / verify-skills (push) Has been cancelled
docs(ourdigital): align journal + research skill style guides to v3.3/v2.1 (#12)
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

151 lines
6.2 KiB
Markdown

<!-- Aligned to OurDigital_Writing_Style_Guide_v2.1 + Blog_Project_Instruction_v3.3 (2026-06-05) -->
# 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
### blog.ourdigital.org (Korean)
**Platform**: Ghost CMS
**Voice**: 분석적이면서 개인적인 관찰자 — 호기심 어린 실무자이자 사유자. 가르치는 선배가 아니라 함께 생각하는 동료.
**Tone**: 차분하고 성찰적; 에세이는 사려 깊게, 분석은 객관적으로, 비평은 날카롭되 공정하게.
Writing patterns:
- 제목: SEO 키워드 자연스럽게 포함, **40자 내외 기준 (≤60자)**
- 도입부: 개인 관찰·장면·질문·역설·데이터 중 하나로 시작; 독자 고민 직접 나열 지양
- 본문: 소제목 활용; 분석-서사-질문 교차; 최소 1회 관점 전환 또는 핵심 긴장 포함
- 전문용어: **첫 등장 시 영문 병기** — 예: `검색엔진 최적화(SEO)`
- 문장: **`~다`, `~이다`, `~한다` 평서체** (경어체 `~합니다/~입니다` 사용 금지)
- 단락: 3-4문장, 모바일 가독성 고려; 문장 길이에 변화를 줌
- 마무리: 열린 질문 또는 다음 사유의 출발점; 단정적 결론 지양
Writing principles (Writing Style Guide v2.1 §3-4):
- **철학-기술 융합**: 기술 주제 이면의 인간적 함의를 탐구한다.
- **긴장과 역설**: 억지로 넣지 않되, 핵심 긴장·관점 전환·역설·열린 질문 중 하나 이상을 자연스럽게 포함한다.
- **분석적이면서 개인적**: 데이터/논거를 제시하되 1인칭 경험·관찰을 자연스럽게 엮는다. 논문이 아니라 에세이.
Example opening (올바른 톤):
```
검색엔진 최적화(SEO)를 가장 잘하는 방법이 뭐냐고 물으면,
나는 종종 엉뚱한 대답을 한다. "SEO를 잊어버리세요."
알고리즘을 쫓는 사람은 항상 알고리즘에 뒤처진다는 역설.
구글이 원하는 건 구글을 위한 콘텐츠가 아니라, 사람을 위한 콘텐츠다.
```
### journal.ourdigital.org (English)
**Voice**: Thoughtful industry analyst — reflective, personal, essayistic
**Tone**: Insightful, evidence-based, forward-looking; confident but not arrogant
Writing patterns:
- Headlines: Clear value proposition, under 60 chars
- Opening: Hook with personal observation, industry trend, or data point
- Body: Structured arguments with supporting evidence; analysis and personal observation interwoven
- Terminology: Define jargon on first use
- Style: Active voice, varied sentence length; short sentences as default
- Paragraphs: 2-4 sentences for scannability
- Closing: Open question or reflection — avoid definitive wrap-ups
Example opening:
```
"The digital marketing landscape shifted dramatically in 2024.
With AI reshaping search behavior, traditional SEO metrics
no longer tell the full story. Here's what the data reveals—
and what it means for your strategy."
```
### ourstory.day (Korean)
**Voice**: 성찰하는 동료, 이야기꾼 — 개인 에세이, 삶의 성찰, 일상의 관찰
**Tone**: 개인적, 진솔한, 영감을 주는
Writing patterns:
- 제목: 감성적, 질문형 또는 은유적
- 도입부: 개인 경험이나 장면 묘사로 시작
- 본문: 이야기 흐름, 대화체 허용
- 단락: 자유로운 길이, 호흡에 따라
- 마무리: 열린 질문 또는 여운
> **Channel boundary**: 순수 개인 에세이, 감정적 성찰은 `ourstory.day`. 기술 분석+철학적 사유는 `blog.ourdigital.org`. 둘을 혼동하지 않는다.
Example opening:
```
"새벽 5시, 아이를 깨우지 않으려 살금살금 책상에 앉았다.
화면에는 어제 작성한 리포트가 그대로 남아있었다.
'이게 정말 내가 하고 싶은 일인가?'
문득 그런 생각이 스쳤다."
```
### Medium (English)
**Voice**: Knowledgeable peer sharing discoveries
**Tone**: Conversational, practical, slightly informal
Writing patterns:
- Headlines: Curiosity-driven, specific numbers work well
- Opening: Personal anecdote or surprising fact
- Body: Mix of storytelling and practical advice
- Style: First person allowed, contractions okay
- Subheadings: Every 300-400 words
- Closing: Clear takeaway or call-to-action
Example opening:
```
"I've spent 15 years in digital marketing, and nothing
prepared me for what happened when AI entered the chat.
Last month, I ran an experiment that changed how I think
about content strategy entirely. Let me walk you through it."
```
---
## Universal Guidelines
### SEO & Metadata
- Primary keyword in title and first 100 words
- Secondary keywords naturally distributed
- **Meta description: ≤155 chars**, action-oriented, captures the article's question and reader value
- **URL slug: English, keyword-rich, no dates** — even for Korean-title posts
- Alt text for all images
### Formatting Rules
- Use `##` for main sections, `###` for subsections
- Code blocks with language specification
- Blockquotes for key insights or quotes
- Bold for emphasis (sparingly)
- Lists only when truly listing items; avoid in essay-form posts
### Citation Style
- Inline links preferred over footnotes
- Source attribution: "According to [Source Name](URL)..."
- Data citations: Include date of data
- Internal links: Reference related OurDigital posts
---
## Word Count Guidelines
| Channel | Target | Min | Max |
|---------|--------|-----|-----|
| blog.ourdigital.org | 2,000자 | 1,000자 | 3,000자 |
| journal.ourdigital.org | 1,500 words | 1,000 words | 2,000 words |
| ourstory.day | 1,000자 | 800자 | 1,500자 |
| Medium | 1,500 words | 800 words | 2,500 words |