Claude Code용 스킬/플러그인 2종 개발: 작업 위임용 'foreman'과 에이전트 시각화용 'foreman-vision'

둘 다 무료고 MIT 라이선스임.

Claude Code 쓰면서 서브 에이전트 여러 개를 동시에 돌려봤는데, 메인 컨텍스트가 파일 덤프로 계속 꽉 차버려서 각 에이전트가 뭘 하는지 도저히 알 수가 없더라고. 그래서 그냥 내가 쓰려고 직접 만들었음.

foreman은 메인 세션을 오케스트레이터로 바꿔줌. 계획을 읽어서 일을 쪼갠 다음, 각 조각을 서브 에이전트한테 던져주고 결과까지 확인하는데, 정작 본인은 파일 수정 안 함.

• 모든 변경 사항은 서브 에이전트가 처리하니까 메인 컨텍스트에는 파일 덤프 대신 결론만 남음

• 독립적인 작업들은 병렬로 돌아감

• 에이전트가 "완료"라고 하면 그건 그냥 주장일 뿐임: 메인 세션이 diff를 읽거나 체크를 돌려본 다음에야 승인함

• 메인 세션만 에이전트를 생성할 수 있고, 훅(hook)이 이걸 강제로 통제함

파일 하나 수정하거나 짧게 수정-테스트 반복할 때는 굳이 쓸 필요 없고, 필요할 때만 켜서 쓰면 됨: /foreman on을 치거나, 한 번만 작업할 거면 /foreman <task> 입력하면 끝임.

foreman-vision은 GIF에 나오는 실시간 뷰임. 브라우저에서 127.0.0.1로 실행되고, 내 컴퓨터에서 돌아가는 모든 Claude Code 세션이 작은 사무실의 층처럼 보임.

• 서브 에이전트들이 책상으로 걸어가서 지금 무슨 툴 쓰는지 보여줌

• 에이전트가 내 허락이나 답변이 필요하면 머리 위에 풍선 띄우고 대기실로 감

• 에이전트 클릭하면 마지막으로 쓴 툴 호출이랑 실시간 터미널 확인 가능