claude-plugin-harness-docs

github.com/wowoyong/claude-plugin-harness-docs

2026-02-17 ~ 2026-03-14 · 25 days

과도한 문서화

Claude 에이전트를 위한 문서화 시스템을 문서화하다 질식사

“에이전트를 위한 지도를 만들다 길을 잃다”

Death Type

README Dreamer

이 프로젝트는 '에이전트에게 백과사전이 아니라 지도를 줘라'는 철학 아래, 558라인짜리 SKILL.md와 527라인짜리 doc-extractor.md 같은 방대한 문서를 생성했다. 그러나 .claude-plugin/plugin.json 외에 실행 가능한 프로그래밍 언어 파일이나 외부 의존성은 전혀 발견되지 않아, 실제 '플러그인'은 문서화된 꿈속에서만 존재했다. 코드로 실현되지 않은 채, 오직 문서로만 존재하는 야망의 증거였다.

Cause of Death

1. 단 하루 만의 모든 활동

프로젝트의 생애 25일 중 모든 3개의 커밋은 2026년 3월 14일 단 하루에 집중되었다. 이는 폭발적인 시작이었으나, 이후 어떠한 추가 작업도 기록되지 않은 채 영구적인 침묵으로 이어졌다.

2. 코드 없는 플러그인

명시적으로 'Claude Code 플러그인'으로 설계되었음에도 불구하고, 어떠한 프로그래밍 언어 파일도, 심지어 'package.json' 같은 외부 의존성 관리 파일도 발견되지 않았다. '.claude-plugin/plugin.json'만이 유일하게 '플러그인'임을 암시하는 설정 파일이었다.

3. 과도한 설명 문서

문서화를 위한 플러그인이 정작 본인의 기능 설명을 위해 방대한 문서를 쏟아냈다. 'skills/harness-docs/SKILL.md' 파일은 558라인, 'agents/doc-extractor.md'는 527라인, 'README.md'는 209라인이 추가되며, 실제 구현보다 설명에 더 많은 노력을 기울인 흔적이 역력하다.

Vibe Score

48/ 100

AI-assisted but human-driven

What They Did

이 프로젝트는 'Claude Code 플러그인'으로, 'OpenAI Harness Engineering'과 'MyRealTrip의 docs-tree-tools'에서 영감을 받아 AI 에이전트를 위한 인레포지토리 문서 관리 시스템을 꿈꿨다. 'AGENTS.md'를 프로젝트 지도로 삼고, 'docs/' 디렉토리 내에 구조화된 문서, 중앙 'index.yml'을 통한 문서 추적, 4단계 진단 시스템, 그리고 소스 코드로부터의 자동 문서 추출을 목표로 했다. 2026년 3월 14일 단 하루 만에 이 모든 야망이 3개의 커밋으로 응축되었다.

MarkdownClaude Code (플랫폼)

Burnout Analysis

개발자는 2026년 3월 14일 단 하루 동안 3개의 커밋을 남겼으며, 이는 'feat' 1회와 'fix' 2회로 구성되었다. 이 짧고 강렬한 활동 이후 어떠한 추가 작업도 기록되지 않았다. 번아웃 대신 초고속 집중 후 '완성'이라는 착각에 빠졌을 가능성이 높다. 커밋 메시지 길이 변화나 심야 비율 변화 같은 번아웃 징후는 나타나지 않았다.

Dependency Archaeology

package.json 파일은 존재하지 않았다. 이는 0개의 외부 의존성으로 구동되는 플러그인이라는 점에서 야망이 넘쳤거나, 혹은 플러그인이 아닌 단순한 문서 묶음이었다는 비극을 암시한다. AI 에이전트가 사용할 도구를 상상하는 데는 외부 라이브러리가 필요 없었던 모양이다. 3개의 커밋 동안 단 하나의 외부 의존성도 추가되지 않았다.

Autopsy: File Structure

├──skills/harness-docs/SKILL.md가장 길었던 문서 (+558라인). AI 에이전트의 스킬 정의가 실제 코드보다 방대했다.

├──agents/doc-extractor.md문서를 추출하는 에이전트의 설계도는 있었으나, 그 에이전트 자체는 어디에도 없었다 (+527라인).

├──agents/doc-diagnostician.md문서 품질을 진단하는 시스템의 설명서 (+444라인). 정작 이 시스템의 품질은 누가 진단하는가?

├──README.md프로젝트의 거창한 야망을 담았으나 (+209라인), 결국 이 야망 자체가 유일한 결과물이 되었다.

├──.claude-plugin/plugin.json이 파일만이 이 모든 것이 '플러그인'이었다는 유일한 증거 (+34라인). 껍데기는 있었다.

├──AGENTS.md에이전트에게 지도를 준다던 AGENTS.md. 정작 이 지도를 따를 에이전트는 나타나지 않았다.

├──docs/문서 구조화의 꿈을 담은 디렉토리. 그 꿈은 문서로만 존재했다.

└──index.yml문서를 추적하는 중앙 인덱스. 추적할 문서는 많았지만, 추적할 사용자는 없었다.

Eulogy Stats

Total Commits: 3
Ambitious Adjectives: 7
Deploy Config: Yes
Estimated Users: 0명 (문서만 읽다 지쳐 잠든 AI 에이전트 다수)

Last Words

“fix: 마지막 문서 수정 (더 이상의 수정은 없다)”