# 한국어 기술 블로그 작업 공간

이 저장소는 한국어 기술 블로그를 쓰고 보관하는 곳입니다. 글쓰기 능력은 `.agents/skills/`의
Agent Skill 세 개가 담당하고, 완성된 글과 근거 자료는 `.run/` 아래에 런 단위로 보관합니다.

## 스킬

| 스킬 | 역할 |
|---|---|
| `writing-korean-technical-blogs` | 자료를 문제·제약·선택·구현·결과·한계 구조로 작성하거나 재구성합니다 |
| `reducing-ai-like-korean-writing` | 상투성, 추상화, 반복, 과잉 구조화를 줄이되 사실과 기술 의미는 보존합니다 |
| `editing-korean-grammar-and-expression` | 맞춤법, 띄어쓰기, 문법, 호응을 보수적으로 검수합니다 |

출처는 `korean-technical-blog-skills-bundle-v1` 번들이고 상류를 수정하지 않고 그대로 씁니다.
`.claude/skills/`는 위 세 폴더를 가리키는 상대 경로 심링크입니다.

## 실행 순서

```text
원자료·초안
→ writing-korean-technical-blogs
→ reducing-ai-like-korean-writing
→ editing-korean-grammar-and-expression
→ 사실·수치·코드·인용 최종 대조
```

작업 규칙은 `CLAUDE.md`에 있습니다.

## 보관 중인 문서

| 런 | 제목 | 분량 |
|---|---|---:|
| `executable-clean-architecture` | 실행 가능한 클린 아키텍처 — 선언이 아니라 빌드가 지키는 경계 | 1,759줄 |
| `keycloak-four-patterns` | 브라우저 토큰에서 엣지 세션까지: Keycloak 인증 패턴 네 가지의 경계 설계 | 1,532줄 |
| `n+1liner` | 하이라이트 피드 조회 성능 — N+1 진단과 조회 전략의 진화 | 1,764줄 |

각 런의 구조는 다음과 같습니다.

```text
.run/<slug>/
├── final/
│   ├── document.md      완성된 글
│   ├── assets/          다이어그램 (svg, drawio, d2, mmd, dot)
│   └── evidence/        측정 자료 (실행계획, csv)
└── (런에 따라) brief.json, sources.json, outline.json
```

`keycloak-four-patterns`의 `brief.json`, `sources.json`, `outline.json`은 제거된 하네스가
남긴 파일입니다. 재생성할 수 없지만 그 글이 어떤 증거 위에서 쓰였는지를 담고 있어 남겨 두었습니다.

## 스킬 검증

```bash
for d in .agents/skills/*/; do ( cd "$d" && python3 scripts/validate_skill.py ); done
```

세 스킬 모두 PASS여야 합니다. PyYAML이 필요합니다.

## 이력

이 저장소에는 ClariDoc 하네스(파이썬 패키지 `claridoc-harness` 0.2.0과 CLI)가 있었습니다.
2026-08-07에 제거했습니다. 판단 근거와 삭제 인벤토리는
[docs/decisions/2026-08-07-remove-claridoc-harness.md](docs/decisions/2026-08-07-remove-claridoc-harness.md)에 있고,
제거 직전 상태는 `pre-harness-removal` 태그에 있습니다.

```bash
git show pre-harness-removal:src/claridoc/cli.py
git checkout pre-harness-removal -- <경로>
```

## 라이선스

MIT. `LICENSE` 참조.