{
  "markdown": "# agent-research\n\n에이전트 전문성은 어디서 나오는가에 대한 연구 노트. \"LLM이 읽기 좋은 문서를 어떻게 쓸까\"에서 시작해서, 지시문 해석 오류 사례, 자기개선 루프, 오케스트레이터 패턴, Hook을 통한 강제까지 이어지는 기록이다.\n\n## 뭔가 찾고 있다면\n\n제목으로 뒤지지 말고 [CATALOG.md](CATALOG.md)부터 열 것. 연구 문서는 각 문서 자신의 상단 태그로 확인하는 법을, 코드/설정/생성물처럼 태그를 가질 수 없는 자원은 목록으로 안내한다.\n\n## 시작점\n\n순서대로 처음부터 읽고 싶으면 [agent-expertise-framework/README.md](agent-expertise-framework/README.md)가 전체 문서 인덱스다. 순서대로 읽으면 아래 흐름을 따라가게 된다.\n\n1. LLM 친화적 문서 작성 원칙 수립 (`00`)\n2. 그 원칙을 Apache Amoro/Iceberg/Paimon 세 오픈소스로 검증 (`01`)\n3. 반대 방향 — 사용자가 LLM에게 지시할 때 생기는 오판 사례 (`02`)\n4. 그 사건을 재료로 만든 요구사항 해석 게이트 설계 (`03`)\n5. 자체개선 루프 설계 + 실제 구현한 그라운딩 metric/필터 (`04`, `agent-expertise-framework/02-self-improvement-loop/eval/`)\n6. 루프를 실제로 연결하는 파이프라인 옵션 비교 (`05`)\n7. 오케스트레이터 패턴 — 이 프로젝트 자신이 수행한 분해→위임→검증 과정을 역추출 (`06`, `.claude/agents/`)\n8. 프롬프트만으로는 안 지켜지는 규칙을 Hook으로 강제한 사례 (`07`, `.claude/hooks/`)\n9. `01`의 4요소와 `07`의 Agent 해부학을 하나의 일반형(agent 무관 스키마)으로 종합 (`08`)\n\n## 이 저장소 자체가 실험 대상\n\n`.claude/agents/`의 4개 서브에이전트(researcher/verifier/doc-writer/supervisor)와 `.claude/hooks/`의 PreToolUse Hook은 위 문서들이 설계한 내용을 실제로 이 저장소에 적용한 결과물이다. 즉 연구 결과를 논문처럼 정리만 한 게 아니라, 이 저장소의 워크플로 자체에 반영해뒀다.\n\n## openwiki/\n\n`openwiki/`는 OpenWiki가 위 문서들로부터 자동 생성한 근거 기반 위키다. 손으로 직접 수정하지 않고, 원본 문서(`agent-expertise-framework/`)를 고치면 재생성되는 방식으로 관리한다.\n",
  "bytes": 1274,
  "sha": "08184da890a1004aedb1f5368bcc3c3d39320f0fc5670297f309aea040aa3e62",
  "repo_slug": "gary5876/agent-research",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_gary5876_agent_research_openwiki_index_m_f418f972/readme"
}