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

이 저장소는 한국어 기술 블로그를 쓰고 보관하는 곳입니다. 글쓰기 능력은 .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/는 위 세 폴더를 가리키는 상대 경로 심링크입니다.

실행 순서

원자료·초안
→ 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줄

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

.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은 제거된 하네스가 남긴 파일입니다. 재생성할 수 없지만 그 글이 어떤 증거 위에서 쓰였는지를 담고 있어 남겨 두었습니다.

스킬 검증

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에 있고, 제거 직전 상태는 pre-harness-removal 태그에 있습니다.

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

라이선스

MIT. LICENSE 참조.