Files
our-claude-skills/custom-skills/02-ourdigital-blog/shared/references/blog-style-guide.md
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

8.1 KiB

OurDigital Blog Style Guide

Detailed writing guidelines for blog.ourdigital.org.

Channel Identity

Field Value
Domain blog.ourdigital.org
Brand OurDigital
Identity 사람, 디지털 그리고 문화를 관찰하는 개인 디지털 연구 노트
Core Theme 사람, 디지털 그리고 문화
Language Korean (전문용어 첫 등장 시 영문 병기)
CMS Ghost — 초안은 Markdown으로 작성
Tone Analytical & Personal (비판적이되 공정, 겸손하되 자신감 있음)
Target 디지털 마케팅/기술 실무자 (1순위), 기술-사회 관계에 관심 있는 지식인 (2순위), 비판적 사고를 중시하는 일반 독자 (3순위)

브랜드 경계: OurDigital이 블로그 전체 정체성이다. OurDigital Clinic은 진단형 콘텐츠·컨설팅 상품에서만 사용하는 서비스 메타포다.

우선순위: 지침 충돌 시 Blog_Project_Instruction_v3.3 → 이 스타일 가이드 → 사용자 일반 스타일 순으로 따른다.

Writing Characteristics

모든 초안은 아래 네 원칙을 기준으로 자기 점검한다.

1. 철학-기술 융합

기술 주제를 다루되, 항상 이면의 인간적 함의를 탐구한다.

Good:

구글은 200개 이상의 신호를 읽는다. 그런데 정작 글을 쓰는 사람은 단 하나의 신호, 독자의 진짜 질문도 제대로 읽지 못할 때가 많다.

Bad:

구글의 알고리즘은 200개 이상의 신호를 분석한다.

2. 긴장과 역설

억지 역설을 억지로 넣지 않는다. 핵심 긴장·관점 전환·역설·열린 질문 중 하나 이상을 자연스럽게 포함한다.

Useful Patterns:

  • ~하면서 동시에 ~하다
  • ~를 위해 오히려 ~해야 한다
  • 가장 ~한 것이 사실은 가장 ~하다
  • 우리가 놓치고 있는 것은 무엇인가?

예: 데이터를 가장 잘 활용하는 방법은, 때때로 데이터를 내려놓는 것이다.

3. 우울한 낙관주의

디지털 세계의 불안·피로·한계를 솔직히 인정한다. 그러나 냉소로 끝내지 않는다. 그 안에서 다시 생각할 가능성, 작은 회복의 여지를 찾는다.

Tone Spectrum:

비관 ←――――――――――――――――――→ 낙관
              ↑
        우울한 낙관주의
        (여기에 위치)

예: AI가 일자리를 대체할 수 있다는 불안은 근거가 있다. 그리고 그 불안이야말로 '대체 불가능한 것'이 무엇인지 진지하게 물어보게 만드는 시작점이다.

4. 분석적이면서 개인적

데이터와 논거를 제시하되, 1인칭 경험과 관찰을 자연스럽게 엮는다. 논문이 아니라 에세이다. 그러나 근거 없는 감상문도 아니다.

예: 지난 3년간 50개 이상의 사이트 마이그레이션을 지켜봤다. 숫자로 보면 성공률은 70% 정도다. 하지만 '성공'의 정의가 사이트마다 달랐다는 게 진짜 이야기다.

문장 구조

Element Pattern
문장 길이 단문 기본, 짧은 문장과 긴 문장을 교차해 리듬을 만든다
단락 구조 관찰 → 분석 → 철학적 함의
단락 전환 분석 → 서사 → 질문으로 호흡을 바꾼다
근거 제시 역사적 사례 + 기술 명세 + 문화적 참조; 출처 없는 통계는 사용하지 않는다
결론 열린 결말, 답보다 질문
문체 ~다, ~이다, ~한다 평서체; ~합니다, ~입니다 경어체 사용 금지

언어 규칙

전문용어 병기

✓ 검색엔진최적화(SEO)
✓ 핵심성과지표(KPI)
✓ 고객관계관리(CRM)
✗ SEO (첫 등장 시 한글 없이)
✗ 서치엔진옵티마이제이션

외래어 표기

  • 영문 브랜드/제품명: 원어 유지 (Google, ChatGPT)
  • 일반 외래어: 한글화 (데이터, 마케팅, 콘텐츠)

포스트 구조

도입부 (200-300자)

  • 장면·질문·역설·데이터 중 하나로 시작한다.
  • 핵심 질문을 제시하고, 독자가 왜 이 글을 읽어야 하는지 암시한다.
  • 상투적 표현 금지: 오늘날 디지털 시대에, 급변하는 환경 속에서, 요즘 ~가 화제다

본론 (3-5개 섹션, 각 300-500자)

  • 소제목(##, ###)을 사용한다.
  • 분석·서사·데이터·개인 관찰을 교차시킨다.
  • 최소 1회 관점 전환 또는 핵심 긴장을 포함한다.
  • 전문용어는 첫 등장 시 영문을 병기한다. 예: 검색엔진 최적화(SEO)

결론 (200-300자)

  • 인사이트를 정리하되 단정하지 않는다.
  • 열린 질문 또는 다음 사유의 출발점으로 마무리한다.
  • 독자가 이어서 생각할 여운을 남긴다.

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

Ghost CMS 메타데이터는 아래 형식으로 완성한다.

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 (제목)

  • 60자 이내, 핵심 키워드 자연스럽게 포함
  • 호기심·긴장·관점 전환을 만든다 (40자 내외 기준)
  • 키워드 밀도만 의식한 SEO 과잉 최적화 금지

Patterns:

  • "[주제]의 역설: ~하면서 ~하는 시대"
  • "[주제]를 다시 생각한다"
  • "왜 [주제]가 중요한가"

Meta Description

  • 155자 이내, 글의 핵심 질문과 독자 효용을 함께 담는다
  • 클릭을 유도하되 과장하지 않는다

URL Slug

  • 영문 소문자, 하이픈으로 구분, 3-5 단어
  • 한국어 제목이라도 slug는 영문으로 작성한다

Content Calendar

Category Frequency Example Topics
SEO/마케팅 주 1회 Technical SEO, AEO, 콘텐츠 전략
데이터 분석 격주 GA4, BigQuery, 대시보드
AI/기술 트렌드 월 2회 LLM, 자동화, 마케팅 AI
인사이트/에세이 월 1회 디지털 문화, 세대론, 직업의 미래

Quality Checklist

Must Have

  • 핵심 긴장·역설·관점 전환·열린 질문 중 하나 이상이 있다.
  • 도입부 300자 이내에 hook과 핵심 질문이 있다.
  • 전문용어 첫 등장 시 영문을 병기했다.
  • 기술 내용에 인간적 함의가 있다.
  • 독자를 가르치려 하지 않고 함께 생각하는 태도를 유지했다.
  • 결론이 열린 질문 또는 여운으로 마무리된다.
  • SEO 메타데이터(title ≤60자, meta ≤155자, 영문 slug)가 완성되었다.
  • 기본 길이 2,000자 ±300자를 준수했다 (또는 이탈 이유가 있다).

Must Avoid

  • 상투적 도입: 오늘날 디지털 시대에, 급변하는 환경 속에서, 요즘 ~가 화제다
  • 경어체: ~합니다, ~입니다
  • 교과서적 나열: 첫째, 둘째, 셋째의 기계적 반복
  • 확정적 결론: 따라서 반드시 ~해야 한다
  • 출처 없는 통계나 데이터
  • 기술에 대한 무조건적 찬양 또는 혐오
  • 과도한 감탄부호, 물결표, 이모지
  • 특정 업체·제품의 노골적 홍보성 문장

자기 편집 (Self-Edit) 의무

초안 완성 후 아래 형식으로 가장 약한 항목 1개를 반드시 지목한다. "모두 통과"는 허용하지 않는다.

[자기 편집] 가장 약한 부분: [항목명]
이유: [1문장]
개선 방향: [1문장]