AgentZero 하네스 진화 — 깡통에서 자라는 정원으로

"우리는 너무 많은 규칙을 만들지 않았다. 그게 필요할지 아닐지

초반엔 몰라서." — 이 글은 그 시작점에서 출발해 약 10일간

하네스가 자기 자신을 어떻게 다듬어 왔는지의 기록이다.

TL;DR

Prologue — 시작은 비어 있었다

1. agents/ — 일을 하는 전문가

2. knowledge/ — 무엇이 올바른지의 기준

4-Layer + Log — 정원의 토양

flowchart LR
  K[knowledge<br/>무엇이 올바른가] --> A[agents<br/>누가 행동하는가]
  A --> E[engine<br/>어떻게 흐르는가]
  E --> L[logs<br/>무엇이 일어났는가]
  L -.피드백.-> K
  L -.피드백.-> A
  L -.피드백.-> E

느슨한 시작 → 복잡도 증가 (실제 timeline)

• 4-25 — 4 specialists 심음. 정원이 처음 사람을 가짐.

• 4-26~28 — AIMODE(로컬 LLM 듀얼 백엔드) / voice 서브시스템 작업. code-coach 가 Mode 3(research consult) 로 자주 발동, 그 결과물이 knowledge/ 로 codify 되기 시작.

• 4-28~30 — release-build-pipeline 엔진 신설. 2개 이상의 agent (security-guard + build-doctor) 가 같이 일하는 첫 케이스가 발생해서 만든 첫 engine.

• 5-2 — pre-commit-review 엔진 + missions-protocol(vibe-mode but file-based — 한 파일 = 한 미션). M001~M0003 운영 시작.

• 5-3 — M0008(voice-note plugin) + M0009(token-monitor + 멀티프로필 collector). 본격 미션 운영.

• 5-4 — 정원 자체의 위생 정비. 후술.

로그가 정원을 다듬은 순간들

사례 1 — WPF 다크 테마 사고 (반복된 실수의 codify)

"WPF 수정시 테마일관성 맞추기 — 이것 때문에 여러 번 실수함"

사례 2 — 데이터 출처를 한 단계만 더 의심하기 (M0009)

"claude, claude-qa 같이 매크로 만들어둠 — 해당 프로파일 수행파일 체크하면 경로추적 가능할것같음"

"데이터 출처를 한 단계만 더 의심해도 누적의 절반이 보인다 — 첫 구현이 'official 경로 ~/.claude' 만 본 결과 ~/.claude-qa, ~/.claude-pel3 의 모든 사용량이 통째로 누락되어 있었다."

사례 3 — 같은 흐름이 두 번 fire 하면 engine 으로 (creator-rule Rule 2)

Rule 2 — Multi-agent collaboration → engine.

The instant a workflow needs two or more agents to coordinate,

a harness/engine/<name>.md engine MUST define the orchestration.

하네스뷰 — 자라는 정원의 시각화

메뉴 구성

Dashboard       │ Build Log 카드 / Recent Updates / PDSA Learning / Contributors
Workflow        │ Core (앱 작동 흐름) ‖ Task (Orchestration — engine 5개)
Roles           │ Agents 6명, 각자의 spec card
Skills          │ Claude Code 슬래시-커맨드 인덱스
Knowledge       │ Expert (per-agent 트리) ‖ Tech / Domain (Docs 트리)
Missions        │ M0001~M0009 카드 + Pencil 디자인 페어링
Activity Log    │ harness/logs/<카테고리>/*.md 시계열
Product Design  │ Pencil(.pen) 화면 설계
Product Intro   │ 운영자 작성 introduction

핵심 기능 5가지

1. Workflow 탭의 Core / Task 분리. Core 는 앱이 작동하는 흐름(Multi-CLI / AIMODE handshake / Tool-call loop / Provider switch / Voice pipeline / Release / Tech-doc publish), Task 는 하네스가 일을 조율하는 흐름. 둘은 의미가 다르다 — Core 는 코드가 사는 곳, Task 는 사람과 에이전트가 사는 곳.

2. Knowledge 트리. 5월 4일 이후 per-agent 서브디렉토리로 재편. 트리에서 code-coach (5) / tamer (2) / security-guard (2) / test-runner (2) / test-sentinel (1) / _shared (1) — 각 전문가가 자신의 지식을 "보유" 하는 구조가 한눈에 보인다.

3. Build-up Contributors 자동 갱신. harness/, Docs/, Home/harness-view/ 의 git log 합집합을 build 마다 다시 계산. 도큐 활동 전반을 통계화. publish 할 때마다 항상 최신.

4. PDSA Learning — 명시 호출만. 의미 있는 활동(미션 묶음 마감 / 릴리즈 통과 / 큰 인사이트 발생) 이 쌓였다고 운영자가 판단할 때만 갱신. publish 가 자동으로 따라가지 않는다 — 정원의 자기 회고는 강제하지 않는다.

5. In-repo single source of truth. 5월 4일 이전엔 Home/_resources/ 미러로 harness/ + Docs/ 를 복제했지만, dual-management 이슈(같은 파일 두 곳에 존재) 로 폐기. Pages artifact 가 repo 전체를 업로드하고 viewer 는 ../../<rel> 로 upstream MD 를 직접 fetch — 한 파일은 단 한 곳에만.

데이터 흐름

flowchart LR
  H[harness/ + Docs/<br/>upstream MD] --> B[build-indexes.js]
  B --> M[Home/harness-view/indexes/*.json<br/>매니페스트]
  H -.viewer fetch.-> V[harness-view UI]
  M --> V
  D[Home/harness-view/data/*.json<br/>news / pdsa / workflow-graph<br/>운영자 큐레이션] --> V
  V -.doc-v 태그 push.-> P[GitHub Pages CI<br/>repo 전체 artifact]

운영 게이트 (tag-gated publish)

git tag -a doc-v1.12.0 -m "..."
git push origin doc-v1.12.0   # → pages.yml 발동, ~30~60초 후 갱신

이번 세션의 셀프-정비 (운영자가 정원에 손을 댄 날)

creator-rule 6개 룰 (압축)

1. Single-responsibility for agents — agent 는 단일 책임. agent A 가 inline 으로 agent B 호출 금지.

2. Multi-agent → engine — 둘 이상이 협업하면 engine 이 orchestration MUST 정의.

3. Triggers live in agent/engine frontmatter only — knowledge 는 content-only.

4. Knowledge owned per-agent — _shared/ 만 cross-cutting.

5. Tamer's modification protocol — 수정 전 creator-rule Read + 제출 전 5문 self-audit.

6. Logs follow agents, engine logs are aggregators — engine 로그는 link, 본문 복제 금지.

부록 — 깡통모드 카카시 하네스 (harness-kakashi)

깡통 상태에서 가지고 있는 것

harness/
├── harness.config.json   ← 정원의 정체성
├── agents/
│   └── tamer.md          ← 정원지기 한 명만
├── knowledge/            ← (비어 있음)
├── engine/               ← (비어 있음)
└── logs/                 ← (비어 있음)

"your kakashi" 발동

"너의 이름은. — 이름을 부르는 순간 정원의 문이 열린다."

• 하네스를 설명해 — 현재 상태 보고

• 새 에이전트 추가해 — 첫 전문가 심기

• 지식 문서 만들어 — 첫 햇빛 들이기

• 워크플로우 정의해 — 첫 물길 내기

AgentZero 와 무엇이 다른가

Epilogue — 우리만의 작은 하네스가 자라고 있다

우리는 너무 많은 규칙을 만들지 않았다. 그게 필요할지 아닐지 초반에 몰라서.

지금, 하네스 프레임이 견고해지는 중이다.

반복실수하고 작동안되는 부분을 발견하는 순간 정비한다.

우리만의 작은 하네스가 자라고 있다.

TECH LINKS

• 𝕏 @webnori

• 📘 Akka Labs (Facebook group)

• 📝 More writings — webnori wiki

Reference

• AgentZero Lite repo: https://github.com/psmon/AgentZeroLite

• Harness viewer (live): https://psmon.github.io/AgentZeroLite/Home/harness-view

• Empty kakashi harness: https://github.com/psmon/harness-kakashi

• Current harness version: 1.6.0 (harness/harness.config.json)