오래 대화한 세션을 워커로 데려오기
한 시간째 대화하며 코드를 익힌 에이전트를 그대로 다른 에이전트의 워커로 데려와 일을 맡기고, 끝나면 놓아 줍니다.
목표. 함께 인증 모듈을 읽으며 그 뒤에 있는 결정까지 알게 된 Claude Code나 Codex 세션이 있습니다. 빈 맥락에서 시작하는 새 워커를 띄우는 대신, 코디네이터가 그 세션을 워커로 데려옵니다. 아무것도 다시 띄우지 않으므로 대화는 그대로 남습니다.
필요한 것
- st 0.3.70 이상을 쓰고,
st hooks install을 해 둡니다. - 두 에이전트 모두 st가 공유하는 세션의 pane에 있어야 합니다. 세션이 달라도 되고, 같은 계정의 다른 장치에 있어도 됩니다(다른 장치의 워커 참고).
1. 세션 id 찾기
워커가 될 세션의 pane에서 확인합니다.
echo $TMUX_PANE # %15st ls나 데스크탑 앱의 에이전트 그래프에서도 볼 수 있습니다.
2. 데려오기
부모가 될 에이전트에게 부탁합니다.
%15를 네 워커로 데려와서 인증 테스트를 맡겨. 그 모듈은 이미 알고 있어.그러면 에이전트가 이렇게 실행합니다.
st worker adopt %15직접 해도 됩니다.
- 셸에서. 부모의 pane에서는
st worker adopt %15를, 공유 세션의 다른 곳에서는st worker adopt %15 --parent %12를 실행합니다. - 데스크탑 앱(0.1.21 이상). 에이전트 그래프에서 워커가 될 카드를 부모 카드 위로 끌어다 놓습니다. "Make <워커> a worker of <부모>"가 뜹니다.
- 사이드바(데스크탑 앱 0.1.31 이상, 웹 터미널 st 0.3.85 이상). 워커가 될 창 행을 부모 창 행 위로 끌어다 놓습니다.
워커로 데려오면 st가 두 에이전트에게 한 줄씩 알립니다. 부모에게는 워커의 id와 일을 맡기는 명령을 알려 주고, 워커에게는 누구의 워커가 되었는지와 끝나면 st worker done으로 보고하라는 것을 알려 줍니다. 터미널에서 데려오면 st가 먼저 그 에이전트를 왜 데려오는지 묻고(--role "<이유>"로 줄 수도 있습니다), 데려온 에이전트의 턴이 끝나면 지금까지 한 일을 짧은 브리프로 알려 달라고 묻습니다. 그 브리프는 st worker read에 나옵니다(st 0.3.93 이상). 워커가 질문 화면이나 권한 화면에 있으면 데려오기는 되지만 알림은 가지 않고, 결과에 그렇게 나옵니다. 그 화면이 넘어간 뒤 직접 말해 주면 됩니다.
3. 일 맡기기
데려온 워커에게는 과제 파일이 없습니다. 일은 메시지로 받고, 이미 아는 배경은 다시 설명하지 않아도 됩니다.
st worker send %15 "토큰 갱신 테스트를 추가해 줘. go test ./internal/auth가 통과하면 끝."
st worker wait %15
st worker read %15send 다음의 wait는 새 턴이 시작해서 끝날 때까지 기다립니다. 예전 일을 끝냈다는 표시가 남아 있어도 바로 돌아오지 않습니다.
4. 보기
에이전트 그래프에서 두 카드가 굵은 초록 선으로 이어집니다. 사이드바에서는 코디네이터 행에 coordinator 배지가 붙고, 워커는 Workers · 1 working 같은 머리 줄 아래로 접힙니다.
5. 놓아 주기
st worker release %15에이전트 그래프의 워커 카드에서 Release를 누르거나 사이드바 행의 메뉴에서 놓아 줘도 됩니다. 그러면 그 세션은 원래의 대화로 돌아갑니다. st worker stop은 데려온 워커를 닫지 않습니다. 원래 내가 쓰던 세션이기 때문입니다.
- 부모와 워커 모두 에이전트여야 합니다. 자기 자신이나 이미 자기 아래에 있는 에이전트를 데려오거나, 한 실행 안에서 코디네이터 아래 두 단계를 넘거나, 팀이 이어진 사슬에서 워커 위의 에이전트가 넷을 넘으면 거절합니다(st 0.3.88 이상). 데려오는 에이전트에게 자기 워커가 있으면 팀째로 들어옵니다. 팀을 워커로 데려오기를 보세요.
- 다른 장치의 에이전트가 이미 누군가의 워커면 먼저 놓아 주어야 합니다.
--owns는 이 장치의 워커에만 씁니다.
자세한 내용은 워커에 있습니다.