herdr tour: 초급, 중급, 고급

초급 6분 여러 agent를 띄워보기

  1. b1-server 창을 닫아도 돈다

    SKILL.md README.md

    터미널 창 TUI (client) 붙었다 떨어진다 server claude 나와의 대화 $i $(date +%T) 시계 pane pane = 가상 terminal(PTY) + 프로그램(process) 창 0개 터미널 창 창 닫기 herdr server 시계 pane claude 대화 그대로 0 5 10 15 20 s

  2. b2-team 인사 탭과 개발 탭

    SKILL.md README.md

    workspace demo tab 인사 hi-claude claude hi-codex codex tab 개발 pm claude front claude back claude ~/herdr-demo git init 인사 hi-claude hi-codex agent prompt agent read 답 개발 pm SendMessage front 화면 back server, 데이터 준비됨 준비됨 --ratio 0.6 만드는 순서 1 workspace create 2 tab rename 3 pane split 4 agent start 5 /rename 6 agent prompt (역할) ID는 응답에서, focus는 그대로

  3. b3-gotopicker 질문하며 기다리는 pm 찾아가기

    SKILL.md README.md

    workspace demo tab 인사 tab 개발 pm front back rollup blocked > done > working > idle prefix+g b w i d a hi-claude demo / 인사 hi-codex demo / 인사 pm demo / 개발 front demo / 개발 back demo / 개발 b blocked만 남기고 Enter로 간다 pm 질문 창 답하고 떠남 가서 봄 안 봄 PLAN.md done = 끝났고 아직 안 봄 idle = 끝났고 봤음

중급 15분 agent 팀에 일을 나눠 맡기기

  1. m1-pm pm이 나눠 맡긴다

    SKILL.md README.md

    투어 agent pm front back 실행 확인 pm이 끝나기를 기다린다 프롬프트 막히면 골라 준다 front, back을 기다린다 SendMessage 동시에 화면 server, 데이터 SendMessage 답 실행 완료 조건과 대조 점검 완료 조건 보고 디브리프 0 3분 6분

  2. m2-swarm worktree로 동시에 만들고 고른다

    SKILL.md README.md

    ~/herdr-demo main swarm/a ~/.herdr/worktrees/herdr-demo/swarm-a s-a swarm/b ~/.herdr/worktrees/herdr-demo/swarm-b s-b swarm/c ~/.herdr/worktrees/herdr-demo/swarm-c s-c demo group wait 동시에 Best-of-N 같은 일을 여럿에게. 완료 조건을 통과한 하나를 merge main claude 통과 claude 통과 codex 실패 Divide and Merge 다른 일을 나눠서. 하나씩 merge, 매번 확인 main 1번째 2번째 3번째 공유 계약은 먼저 고정 Nominal Group 같은 질문을 서로 못 보게. 전부 모아 중복만 뺀다 main 혼자 혼자 혼자 합칠 때 중복만 뺀다 고르기, 나눠 합치기, 따로 모으기. 셋 다 완료 조건이 끝을 정한다

  3. m3-plugin plugin 만들기

    SKILL.md README.md

    server 시작 event CLI key 링크 수명 [[startup]] 한 번 [[events]] 한 번 [[link_handlers]] [[actions]] 한 번 [[panes]] 닫을 때까지 on = "pane.created" 등 넘김 연다 예시 entrypoint herdr CLI 보이는 곳 팀 보드 [[actions]] + [[panes]] plugin pane open, agent list popup swarm 버튼 [[actions]] worktree create, agent start 새 workspace worktree 자동 투입 [[events]] worktree.created pane list, agent start sidebar reviewer 소환 [[actions]] pane split, agent start 옆 pane 링크를 pm에게 [[link_handlers]] agent prompt pm pm pane 끝 시각 요약 [[events]] agent_status_changed pane report-metadata sidebar $summary 엮기 manifest, plugin.sh plugin link trigger plugin log list 고치기 plugin.sh 고침: 바로 manifest 고침: 다시 link

고급 나만의 Workflow 만들기

  1. p1-compose 간단하게 agent team 짜보기

    SKILL.md README.md

    결정 묻는 것 쓰게 되는 herdr Decomposition 하위 작업끼리 서로의 결과를 몰라도 되나 나눌 수 있을 때만 나눈다. agent 수 = 독립 하위 작업 수 tab create, pane split, agent start, /rename Communication context는 공유되지 않는다. 무엇으로 잇나 넘기지 않은 건 모른다. 목적, 형식, 금지, 계약을 넘긴다 SendMessage, agent prompt, pane run tail -F Convergence 여러 결과를 어떻게 하나로 모으나 모으기가 더 어렵다. 다른 기준으로 확인, 완료 조건으로 끝 agent wait, agent read, --kind codex 같은 과제, 다른 답, 다른 tab lead w1 w2 w3 나눠서 동시에 SendMessage, 실행 확인 a b c ver (codex) 차례로 파일로 넘김, 다른 눈 c1 c2 c3 judge 같은 일을 여럿에게 서로 모름, 고르기

  2. p2-events 끝나거나 막힐 때만

    SKILL.md README.md

    client server events.subscribe subscription_started event: pm working herdr agent get pm 다시 읽기 "agent_status": "working" event: pm done herdr agent get pm 다시 읽기 "agent_status": "done" herdr api snapshot 전체를 한 번에 API socket, 한 줄에 JSON 하나(NDJSON). 브라우저로 넓히기는 p3-socket pane.agent_status_changed 보지 않는 곳의 done, blocked toast 사람을 부른다 [[events]] hook on-status pane report-metadata --token summary=... sidebar pm done 14:03 끝, 52초 front idle 14:01 끝, 95초 back idle 14:01 끝, 88초 설정: 보이는 방식은 client, 실행 방식은 server

  3. p3-socket 연결을 열어 둔 채 실시간으로

    SKILL.md README.md

    연결 수명 herdr agent wait pm --until working 응답 하나, 연결 닫힘 그 뒤 변화는 못 본다 events.subscribe 연결 하나, 구독은 pane마다 pm working front working pm blocked back done front idle live.py herdr server $HERDR_SOCKET_PATH live.py python3 표준 라이브러리 브라우저 표 + 입력창 session.snapshot 처음 한 번 events.subscribe 열어 둔 채 SSE /events agent.prompt, pane.send_text 보낼 때마다 POST /send 한 줄에 JSON 하나(NDJSON), 연결 하나에 요청 하나

  4. p4-session 다시 켜도 이어지게

    SKILL.md README.md

    config와 plugin은 같이 쓴다 default herdr.sock session.json tour-s sessions/tour-s/herdr.sock session.json vim sleep 3600 -- top sandbox zsh top 새 shell resume sandbox stop server 보통 pane 보통 pane resume 보고 resume 보고 layout ✓ ✓ process ✗ ✗ resume ✓ 원격 local host ssh host, herdr terminal TUI server local host herdr --remote host TUI server local host herdr machine add host TUI Local remote server server + host 2, 3