docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를 Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류. - 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로 자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거, 동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거. - 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming, Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business, Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로, 나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는 title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백). 원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지. - 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서. - 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는 지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지. - Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경. - 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
This commit is contained in:
Antigravity Agent
@@ -0,0 +1,188 @@
|
||||
---
|
||||
id: P-REINFORCE-AUTO-1FF145
|
||||
title: Blog Content Rules
|
||||
category: 10_Wiki/Topics
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: [Blogging Rules, Content Standards]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.9
|
||||
verification_status: applied
|
||||
tags: [writing, content, blogging, style]
|
||||
raw_sources: []
|
||||
last_reinforced: 2026-05-10
|
||||
github_commit: pending
|
||||
tech_stack:
|
||||
language: markdown
|
||||
framework: hugo-astro
|
||||
---
|
||||
|
||||
# Blog Content Rules
|
||||
|
||||
## 매 한 줄
|
||||
> **"매 Great blog post = ONE clear thesis + concrete evidence + minimal friction"**. 2026 zero-click search era에서는 first 50 words가 entire UX를 결정 — LLM AI overview가 이미 답을 미리 보여주기 때문. 매 핵심: 매 reader's time 의 ruthlessly respect, 매 SEO theater 의 최소화.
|
||||
|
||||
## 매 핵심
|
||||
|
||||
### 매 Structural rules
|
||||
- **One thesis per post**: 매 sub-thesis의 새 post로 split.
|
||||
- **Inverted pyramid**: 매 conclusion-first — TL;DR 의 top.
|
||||
- **Scannable hierarchy**: H2 마다 self-contained section, 매 reader 의 jump-in 가능.
|
||||
- **Concrete > abstract**: 매 example의 매 claim 의 precede.
|
||||
|
||||
### 매 Style rules
|
||||
- **Active voice default** — passive 매 deliberate choice.
|
||||
- **Sentence length variance**: short. 매 medium. 매 occasional longer sentence that establishes context and rhythm before snap.
|
||||
- **No hedging spirals**: "perhaps it might possibly seem that" → cut.
|
||||
- **Tech terms**: define on first use, 매 jargon 의 reader-respect.
|
||||
|
||||
### 매 응용
|
||||
1. Engineering blog post (technical deep-dive, 1500-3000 words).
|
||||
2. Changelog/release notes (factual, scannable, 200-500 words).
|
||||
3. Tutorial (step-by-step, runnable code, copy-paste friendly).
|
||||
4. Opinion/essay (single thesis, supporting evidence, counterargument acknowledged).
|
||||
|
||||
## 💻 패턴
|
||||
|
||||
### Frontmatter template (Astro/Hugo)
|
||||
```yaml
|
||||
---
|
||||
title: "Concrete claim, not 'Thoughts on X'"
|
||||
description: "1-sentence value proposition under 160 chars for SERP"
|
||||
publishDate: 2026-05-10
|
||||
updatedDate: 2026-05-10
|
||||
author: "Name"
|
||||
tags: [primary-tag, secondary-tag]
|
||||
draft: false
|
||||
canonical: "https://blog.example.com/post-slug"
|
||||
ogImage: "/og/post-slug.png"
|
||||
---
|
||||
```
|
||||
|
||||
### Lint rules (vale + textlint)
|
||||
```yaml
|
||||
# .vale.ini
|
||||
StylesPath = styles
|
||||
MinAlertLevel = warning
|
||||
|
||||
[*.md]
|
||||
BasedOnStyles = Vale, write-good, Microsoft
|
||||
|
||||
# styles/Custom/Hedges.yml
|
||||
extends: existence
|
||||
message: "Hedge word '%s' — cut or commit."
|
||||
level: warning
|
||||
tokens:
|
||||
- perhaps
|
||||
- maybe
|
||||
- somewhat
|
||||
- quite
|
||||
- rather
|
||||
- seems to
|
||||
```
|
||||
|
||||
### Reading-time + word-count check
|
||||
```python
|
||||
import re
|
||||
from pathlib import Path
|
||||
|
||||
def analyze_post(path: Path) -> dict:
|
||||
text = path.read_text()
|
||||
body = re.sub(r"^---.*?---", "", text, count=1, flags=re.S)
|
||||
words = re.findall(r"\w+", body)
|
||||
n = len(words)
|
||||
return {
|
||||
"words": n,
|
||||
"minutes": round(n / 230), # avg adult reading speed
|
||||
"h2_count": len(re.findall(r"^## ", body, flags=re.M)),
|
||||
"code_blocks": body.count("```") // 2,
|
||||
"links": len(re.findall(r"\[.+?\]\(.+?\)", body)),
|
||||
}
|
||||
```
|
||||
|
||||
### TL;DR generator (Claude 4.7)
|
||||
```python
|
||||
from anthropic import Anthropic
|
||||
|
||||
def generate_tldr(post_md: str) -> str:
|
||||
client = Anthropic()
|
||||
msg = client.messages.create(
|
||||
model="claude-opus-4-7",
|
||||
max_tokens=200,
|
||||
system=("Write a 2-3 sentence TL;DR. State the thesis, the key evidence, "
|
||||
"and one actionable takeaway. No hedging. No 'this post discusses'."),
|
||||
messages=[{"role": "user", "content": post_md[:6000]}],
|
||||
)
|
||||
return msg.content[0].text
|
||||
```
|
||||
|
||||
### SEO sanity check
|
||||
```python
|
||||
def seo_check(frontmatter: dict, body: str) -> list[str]:
|
||||
issues = []
|
||||
title = frontmatter.get("title", "")
|
||||
desc = frontmatter.get("description", "")
|
||||
if not (10 <= len(title) <= 60):
|
||||
issues.append(f"title length {len(title)} outside 10-60")
|
||||
if not (50 <= len(desc) <= 160):
|
||||
issues.append(f"description length {len(desc)} outside 50-160")
|
||||
if "## " not in body:
|
||||
issues.append("no H2 — flat structure hurts scannability")
|
||||
if body.count("](") < 2:
|
||||
issues.append("fewer than 2 links — orphan post")
|
||||
return issues
|
||||
```
|
||||
|
||||
### Image optimization (sharp)
|
||||
```javascript
|
||||
import sharp from "sharp";
|
||||
|
||||
async function optimize(input, slug) {
|
||||
await sharp(input)
|
||||
.resize(1200, 630, { fit: "cover" })
|
||||
.webp({ quality: 82 })
|
||||
.toFile(`public/og/${slug}.webp`);
|
||||
await sharp(input)
|
||||
.resize(800)
|
||||
.webp({ quality: 80 })
|
||||
.toFile(`public/img/${slug}.webp`);
|
||||
}
|
||||
```
|
||||
|
||||
## 매 결정 기준
|
||||
| 상황 | Approach |
|
||||
|---|---|
|
||||
| Tutorial | Step-numbered, runnable code, prereqs at top |
|
||||
| Opinion piece | Thesis in title, counter-argument paragraph required |
|
||||
| Release notes | Bulleted, version + date, breaking changes flagged |
|
||||
| Long-form essay | Add ToC, 1500+ words, 3-5 H2s |
|
||||
| News/timely | Publish date prominent, update date if revised |
|
||||
|
||||
**기본값**: 매 post 의 ship before perfect — 매 published-and-iterated 의 unpublished-and-perfect 의 superior.
|
||||
|
||||
## 🔗 Graph
|
||||
- 변형: [[Technical Writing]]
|
||||
- 응용: [[Engineering Blog]]
|
||||
- Adjacent: [[SEO]]
|
||||
|
||||
## 🤖 LLM 활용
|
||||
**언제**: TL;DR drafting, headline A/B variants, hedging-word detection, SEO description generation, outline scaffolding.
|
||||
**언제 X**: full-post ghostwriting (매 voice 의 lost), factual claims requiring expertise, opinion pieces (매 author voice required).
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **SEO keyword stuffing**: 매 2026 search era에 penalize됨, reader-trust 의 erode.
|
||||
- **Listicle without substance**: "10 ways to X" with shallow points.
|
||||
- **Buried lede**: 매 thesis 의 paragraph 5 — modern reader 의 already gone.
|
||||
- **Engagement-bait title**: "You won't believe..." — 매 trust-killer.
|
||||
- **Hedging spiral**: 매 every claim 의 qualifier — reader 의 actual position 의 unclear.
|
||||
|
||||
## 🧪 검증 / 중복
|
||||
- Verified (Strunk & White; Zinsser *On Writing Well*; Google Search Quality Rater Guidelines 2025).
|
||||
- 신뢰도 A.
|
||||
|
||||
## 🕓 Changelog
|
||||
| 날짜 | 변경 |
|
||||
|---|---|
|
||||
| 2026-04-20 | Auto-reinforced placeholder |
|
||||
| 2026-05-10 | Manual cleanup — full substantive content, 6 patterns |
|
||||
Reference in New Issue
Block a user