diff --git a/custom-skills/03-ourdigital-journal/shared/references/journal-style-guide.md b/custom-skills/03-ourdigital-journal/shared/references/journal-style-guide.md index c244a5a..e4efea7 100644 --- a/custom-skills/03-ourdigital-journal/shared/references/journal-style-guide.md +++ b/custom-skills/03-ourdigital-journal/shared/references/journal-style-guide.md @@ -1,7 +1,42 @@ + + # OurDigital Journal Style Guide 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 | Field | Value | @@ -10,6 +45,8 @@ Writing guidelines for journal.ourdigital.org - English essays and articles. | **Language** | English | | **Tone** | Conversational & Poetic, Reflective | | **Target** | Informed generalists with intellectual curiosity | +| **Default length** | 1,000–2,000 words | +| **Content focus** | Industry trends, tech–human intersection, reflective essays | ## Voice Characteristics @@ -20,11 +57,16 @@ Seamlessly blend technical analysis with existential questioning. Technology is **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? -### 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" - "In optimizing for efficiency, we optimize away meaning" - "The tools that connect us also isolate us" @@ -39,6 +81,10 @@ Favor interrogative engagement. Questions create intellectual partnership with r **Avoid:** > 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 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: -- [ ] Does the opening draw readers in? -- [ ] Are there rhetorical questions? -- [ ] Does technical content connect to human experience? -- [ ] Is there at least one paradox or tension? -- [ ] Does the closing leave an open question? -- [ ] Is the tone melancholic but not despairing? +- [ ] Does the opening draw readers in within the first paragraph? +- [ ] Does technical content connect to human experience (philosophy-tech fusion)? +- [ ] Is at least one of the following naturally present: tension, paradox, perspective shift, or open question? +- [ ] Are rhetorical questions used to create intellectual partnership (not overused)? +- [ ] Is analysis grounded in personal observation or experience? +- [ ] 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? +- [ ] 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). diff --git a/custom-skills/04-ourdigital-research/code/references/blog-style-guide.md b/custom-skills/04-ourdigital-research/code/references/blog-style-guide.md index 4b23ff4..bd355ba 100644 --- a/custom-skills/04-ourdigital-research/code/references/blog-style-guide.md +++ b/custom-skills/04-ourdigital-research/code/references/blog-style-guide.md @@ -1,38 +1,64 @@ + # 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 |