← 구요한 bio

에이전트와 하네스

연구와 일을 운영하는
에이전트 시스템

구요한이 매일 쓰는 에이전트 시스템의 구조와 규모, 대표작입니다. 원문은 Zotero에서 시작하고, 에이전트는 하네스 위에서 일하며, 바꾸는 일은 사람이 승인한 뒤에만 합니다.

1. 원문은 Zotero에서 시작합니다

논문 서지, PDF, 하이라이트는 Zotero 한 곳에 둡니다. 볼트와 위키는 서지를 복사하지 않고 인용 키로 원문을 가리킵니다. 에이전트도 Zotero를 읽기만 합니다.

  1. 01
    Zotero

    서지, PDF, 하이라이트의 원본

  2. 02
    인용 키

    Better BibTeX가 논문마다 바뀌지 않는 키를 붙입니다

  3. 03
    CMDS Zotero 플러그인

    인용 넣기, 주석 가져오기, PDF 해당 쪽 열기. 직접 만들어 공개했습니다

  4. 04
    볼트와 위키

    본문에는 인용 키만 두고, 에이전트는 키로 원문 위치를 확인합니다

453Zotero 서지
137Zotero 주석
0.6.3플러그인 공개 판
CMDS Zotero (GitHub)사용 설명서

2. 규모

2026-10-15 실측입니다. 에이전트와 스킬과 하네스를 따로 셉니다.

9 + 1전문 에이전트와 지휘
8작업 리그
120+스킬(절차 패키지)
16정기 작업
10,000+볼트 노트
1,100+LLM Wiki 페이지

3. 구조

아래 층일수록 오래 바뀌지 않습니다. 에이전트라고 부르는 것은 가운데 두 층뿐입니다.

하네스Claude Code, Codex

반복 실행, 도구, 맥락, 권한을 주는 실행 환경입니다. 맥 두 대에 OpenRig 작업 리그 8종을 나눠 둡니다(리서치, 블라인드 판정, 덱 제작, 구현과 리뷰 등).

지휘 에이전트9요한

일을 나누고 합치며, 밖으로 나가는 결과는 사람의 확인을 거칩니다.

전문 에이전트9개

연구, 글쓰기, 교육, 창작, 분석, 관계, 개발, 커뮤니티, 자문. 각자 자기 맥락에서 일하고 결과만 돌려줍니다.

스킬120여 개

에이전트가 필요할 때 꺼내 읽는 절차서입니다. 덱 제작, 논문 반입, 질문 수신함 처리 등. 스킬은 에이전트가 아닙니다.

규칙 파일CLAUDE.md, AGENTS.md 외

모든 에이전트가 먼저 읽는 공개 규칙입니다. 하네스가 바뀌어도 그대로 남습니다.

4. 대표작

과학기술정책연구원 기획연구 지원

에이전트가 숫자 하나에서 원문 초록까지 근거를 짚고, 판단은 연구진이 확정했습니다. 판마다 기록을 남긴 공개 아카이브.

labs.cmdspace.work/stepi-2045
다중 모델 블라인드 판정

같은 후보를 이름을 가린 채 Claude, GPT, Gemini, Grok 판정석이 따로 판정합니다. 평균을 내지 않고 이견을 사람에게 올립니다.

매일 브리핑과 주간 회고

정기 작업 16개가 데일리 노트, 주간 회고, 작업 기록, 모델 정보 갱신을 남깁니다. 사람은 결정 한 줄만 씁니다.

질문 창구 Ask

공개 자료를 근거로 답하는 상시 질문 창구입니다. 들어온 질문은 볼트 노트가 되고, 에이전트가 답변 초안을 채웁니다.

ask.cmdspace.workAKM Index

에이전틱 지식관리 자가 평가 루브릭과 공개 보드. 제출은 30분마다 회수해 점검합니다.

akm.cmdspace.work모델 지도

네 회사 공식 문서에서 매일 모델 정보를 가져와 정리합니다.

models.cmdspace.work

5. 지키는 원칙

용어

에이전트
모델 + 하네스. 자기 맥락을 가지고 계획하고 도구를 쓰며 반복 실행하는 단위
하네스
모델이 실제로 일하게 하는 반복 실행, 도구, 맥락 관리, 권한
스킬
에이전트가 불러 쓰는 절차 패키지. 스스로 실행하지 않음

Anthropic: Agent harness design · Claude Code: Skills · Claude Code: Subagents