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
Some checks failed
Verify Skills / verify-skills (push) Has been cancelled
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>
This commit is contained in:
Andrew Yim
@@ -1,38 +1,64 @@
|
||||
<!-- 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)
|
||||
**Voice**: 전문적이면서 친근한 선배 마케터
|
||||
**Tone**: 실용적, 데이터 기반, 인사이트 중심
|
||||
|
||||
**Platform**: Ghost CMS
|
||||
**Voice**: 분석적이면서 개인적인 관찰자 — 호기심 어린 실무자이자 사유자. 가르치는 선배가 아니라 함께 생각하는 동료.
|
||||
**Tone**: 차분하고 성찰적; 에세이는 사려 깊게, 분석은 객관적으로, 비평은 날카롭되 공정하게.
|
||||
|
||||
Writing patterns:
|
||||
- 제목: 핵심 키워드 포함, 30자 이내
|
||||
- 도입부: 독자의 고민/질문으로 시작
|
||||
- 본문: 번호 매기기보다 소제목 활용
|
||||
- 전문용어: 한글(영문) 형식 - 예: 검색엔진최적화(SEO)
|
||||
- 문장: ~입니다/~습니다 경어체
|
||||
- 단락: 3-4문장, 모바일 가독성 고려
|
||||
- 제목: SEO 키워드 자연스럽게 포함, **40자 내외 기준 (≤60자)**
|
||||
- 도입부: 개인 관찰·장면·질문·역설·데이터 중 하나로 시작; 독자 고민 직접 나열 지양
|
||||
- 본문: 소제목 활용; 분석-서사-질문 교차; 최소 1회 관점 전환 또는 핵심 긴장 포함
|
||||
- 전문용어: **첫 등장 시 영문 병기** — 예: `검색엔진 최적화(SEO)`
|
||||
- 문장: **`~다`, `~이다`, `~한다` 평서체** (경어체 `~합니다/~입니다` 사용 금지)
|
||||
- 단락: 3-4문장, 모바일 가독성 고려; 문장 길이에 변화를 줌
|
||||
- 마무리: 열린 질문 또는 다음 사유의 출발점; 단정적 결론 지양
|
||||
|
||||
Example opening:
|
||||
Writing principles (Writing Style Guide v2.1 §3-4):
|
||||
- **철학-기술 융합**: 기술 주제 이면의 인간적 함의를 탐구한다.
|
||||
- **긴장과 역설**: 억지로 넣지 않되, 핵심 긴장·관점 전환·역설·열린 질문 중 하나 이상을 자연스럽게 포함한다.
|
||||
- **분석적이면서 개인적**: 데이터/논거를 제시하되 1인칭 경험·관찰을 자연스럽게 엮는다. 논문이 아니라 에세이.
|
||||
|
||||
Example opening (올바른 톤):
|
||||
```
|
||||
"구글 상위 노출, 왜 이렇게 어려울까요?
|
||||
많은 마케터들이 SEO에 시간을 투자하지만
|
||||
결과가 보이지 않아 좌절합니다.
|
||||
오늘은 실제로 효과를 본 전략 3가지를 공유합니다."
|
||||
검색엔진 최적화(SEO)를 가장 잘하는 방법이 뭐냐고 물으면,
|
||||
나는 종종 엉뚱한 대답을 한다. "SEO를 잊어버리세요."
|
||||
|
||||
알고리즘을 쫓는 사람은 항상 알고리즘에 뒤처진다는 역설.
|
||||
구글이 원하는 건 구글을 위한 콘텐츠가 아니라, 사람을 위한 콘텐츠다.
|
||||
```
|
||||
|
||||
### 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:
|
||||
- Headlines: Clear value proposition, under 60 chars
|
||||
- Opening: Hook with industry trend or data point
|
||||
- Body: Structured arguments with supporting evidence
|
||||
- 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
|
||||
- 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:
|
||||
```
|
||||
@@ -43,17 +69,19 @@ and what it means for your strategy."
|
||||
```
|
||||
|
||||
### ourstory.day (Korean)
|
||||
**Voice**: 성찰하는 동료, 이야기꾼
|
||||
|
||||
**Voice**: 성찰하는 동료, 이야기꾼 — 개인 에세이, 삶의 성찰, 일상의 관찰
|
||||
**Tone**: 개인적, 진솔한, 영감을 주는
|
||||
|
||||
Writing patterns:
|
||||
- 제목: 감성적, 질문형 또는 은유적
|
||||
- 도입부: 개인 경험이나 장면 묘사로 시작
|
||||
- 본문: 이야기 흐름, 대화체 허용
|
||||
- 문장: ~해요/~네요 부드러운 경어체 가능
|
||||
- 단락: 자유로운 길이, 호흡에 따라
|
||||
- 마무리: 열린 질문 또는 여운
|
||||
|
||||
> **Channel boundary**: 순수 개인 에세이, 감정적 성찰은 `ourstory.day`. 기술 분석+철학적 사유는 `blog.ourdigital.org`. 둘을 혼동하지 않는다.
|
||||
|
||||
Example opening:
|
||||
```
|
||||
"새벽 5시, 아이를 깨우지 않으려 살금살금 책상에 앉았다.
|
||||
@@ -63,6 +91,7 @@ Example opening:
|
||||
```
|
||||
|
||||
### Medium (English)
|
||||
|
||||
**Voice**: Knowledgeable peer sharing discoveries
|
||||
**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."
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Universal Guidelines
|
||||
|
||||
### SEO Considerations
|
||||
### SEO & Metadata
|
||||
|
||||
- Primary keyword in title and first 100 words
|
||||
- Secondary keywords naturally distributed
|
||||
- Meta description: 150-160 chars, action-oriented
|
||||
- URL slug: Short, keyword-rich, no dates
|
||||
- **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
|
||||
- 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 | 1,500 | 1,000 | 2,500 |
|
||||
| journal.ourdigital.org | 1,800 | 1,200 | 3,000 |
|
||||
| ourstory.day | 1,000 | 500 | 2,000 |
|
||||
| Medium | 1,500 | 800 | 2,500 |
|
||||
| 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 |
|
||||
|
||||
Reference in New Issue
Block a user