DongHyeonkaandClaude Opus 5
7dae5a9359
하네스 배선(Brief, SourcePack, STRUCTURE_SPECS, claridoc outline, quality-gate.json, citation_style)을 지우고 스킬 세 개의 실행 순서와 하네스 없이도 성립하는 작업 규칙만 남긴다. README는 저장소가 담고 있는 문서 세 편과 런 디렉터리 구조, 스킬 검증 방법, 하네스 제거 이력과 복구 방법을 설명한다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
74 lines
2.9 KiB
Markdown
74 lines
2.9 KiB
Markdown
# 한국어 기술 블로그 작업 공간
|
|
|
|
이 저장소는 한국어 기술 블로그를 쓰고 보관하는 곳입니다. 글쓰기 능력은 `.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` 참조.
|