herdr-tour
herdr 0.9.5를 몸으로 익히는 agent skill 투어. 데모 팀 하나를 띄우고(초급 6분), 그 팀에 일을 나눠 맡기고(중급 15분), agent team을 간단하게 짜 본 뒤 나만의 Workflow를 만든다(고급).
| 파트 | 시간 | 할 수 있게 되는 일 |
|---|---|---|
| 초급 | 6분 | 여러 agent를 띄워보기 |
| 중급 | 15분 | agent 팀에 일을 나눠 맡기기 |
| 고급 | 자기 속도 | 나만의 Workflow 만들기 |
장면마다 파일이 셋이다.
SKILL.md: 실제 프롬프트처럼 짧은 구어체 요청. herdr pane 안의 agent가 읽고 바로 한다.README.md: 개념 한 줄과 정확한 명령diagram.html: 개념도. 전체는index.html에서 한눈에 본다(브라우저로 연다).
개념도와 README는 사이트로도 본다: iamgroooooot.github.io/herdr-tour. main에 push하면 .github/workflows/pages.yml이 scripts/build_site.py로 다시 만든다.
운영 주제(설치, update, channel, troubleshooting, Windows)는 다루지 않는다.
준비물
herdr 0.9.5 이상, Claude Code, Codex CLI, git, jq, python3. 미리 깔아 둘 plugin이나 원격 host는 필요 없다.
herdr 설치
공식 문서: herdr.dev/docs (Install, Quick start)
- macOS, Linux:
curl -fsSL https://herdr.dev/install.sh | sh
설치 후 herdr --version으로 확인하고, herdr로 실행한다.
실행
agent를 herdr pane 안에서 실행한다(HERDR_ENV=1). 투어를 진행하는 Claude Code는 herdr, git, mkdir 명령을 미리 허용해 두면 승인 창이 줄어 시간 안에 끝난다: --allowedTools "Bash(herdr *),Bash(git *),Bash(mkdir *)"
- Claude Code plugin:
claude plugin marketplace add IamGroooooot/herdr-tour후claude plugin install herdr-tour@herdr-tour, 이어서/herdr-tour:b1-server - Codex plugin:
codex plugin marketplace add IamGroooooot/herdr-tour후codex plugin add herdr-tour@herdr-tour, 이어서$herdr-tour:b1-server. Codex용 사본은plugins/herdr-tour에 있고, AskUserQuestion 대신request_user_input을 쓴다. - 다른 agent:
npx skills add IamGroooooot/herdr-tour -g
초급 6분: 여러 agent를 띄워보기
| 장면 | 시간 | 하는 일 | 참고 | 개념도 |
|---|---|---|---|---|
b1-server |
1분 | 터미널 창을 닫아도 pane과 agent는 계속 돈다 | README | diagram |
b2-team |
3분 | 인사 탭(claude와 codex가 인사)과 개발 탭(pm, front, back)을 차린다 |
README | diagram |
b3-gotopicker |
2분 | pm이 나를 부트스트래핑할 도구를 질문하며 기다리면, Goto picker(prefix+g)로 찾아가 답한다 |
README | diagram |
중급 15분: agent 팀에 일을 나눠 맡기기
| 장면 | 시간 | 하는 일 | 참고 | 개념도 |
|---|---|---|---|---|
m1-pm |
6분 | pm이 front와 back에게 나눠 맡겨 PLAN.md의 도구를 완성한다 | README | diagram |
m2-swarm |
5분 | worktree 여러 개로 동시에 고치고, 완료 조건으로 확인해 고르거나 합친다(Best-of-N, Divide and Merge, Nominal Group) | README | diagram |
m3-plugin |
4분 | 팀에 반응하는 plugin을 그 자리에서 만든다(팀 보드, swarm 버튼, worktree 자동 투입 등) | README | diagram |
고급: 나만의 Workflow 만들기
| 장면 | 시간 | 하는 일 | 참고 | 개념도 |
|---|---|---|---|---|
p1-compose |
판마다 8분 | 세 결정(Decomposition, Communication, Convergence)을 내려 그때그때 다른 agent team을 만들어서 herdr로 돌린다 | README | diagram |
p2-events |
자기 속도 | toast, sidebar 요약, event 구독, plugin hook으로 끝나거나 막힐 때만 알게 한다 | README | diagram |
p3-socket |
자기 속도 | socket 연결을 열어 둔 채 pane 상태를 브라우저에 실시간으로 띄우고, 거기서 입력을 보낸다 | README | diagram |
p4-session |
자기 속도 | server를 껐다 켜도 일이 이어지게 하고, 원격 machine으로 넓히는 길을 본다 | README | diagram |