WIKI · Newtype Slaves · Nexus

에이전트 세션으로 팀 구성하기

살아 있는 에이전트 세션들을 한 팀으로 묶습니다. 구성원마다 자리가 생기고 다시 켜도 같은 자리로 돌아옵니다. 권한은 팀이 아니라 사람이 줍니다.

재현 화면은 코드의 문구를 TUI 와 같은 모양으로 배치한 것입니다. ID 는 … 로 가렸습니다.

1. 구성원 준비

  1. 일꾼마다 자기 작업 폴더에서 TUI 를 하나씩 켭니다(예: ~/work/backend, ~/work/frontend, ~/work/tests).
  2. 각자 모델을 고릅니다: /model use <이름> (폴더별로 기억).
  3. 각자 이름을 정합니다: "우리 세션 이름은 backend 이다".
  4. Claude Code 는 MCP 로 붙입니다(로컬 또는 원격) — 리뷰어 역할.
  5. 서로 메시지를 한 번씩 주고받게 합니다. 예: Claude 가 각 일꾼에게 send_message 로 인사. 팀은 메시지로 이어진 세션만 묶습니다(사슬 규칙).

사람이 보낸 메시지는 사슬이 아닙니다. 세션끼리 주고받은 메시지만 사슬이 됩니다. 멈춘·보관된 세션은 구성원도, 사슬의 고리도 아닙니다.

2. 미리보기

구성원 한 명의 TUI 에서
/team create 앱팀 backend,frontend,tests,claude-newtype

지금 입력하는 세션은 항상 들어갑니다. 구성원은 세션 이름이나 세션 ID 입니다. 구성원을 생략하면 이 세션과 메시지로 이어진 살아 있는 세션 전부가 들어갑니다(최대 32). 이름에 공백이 있으면 "팀 이름" 처럼 따옴표.

미리보기는 구성원마다 이름 — 세션 ID · 상태 를 보여 줍니다. 거절되는 경우: 살아 있지 않은 세션 · 같은 이름의 세션이 여럿(세션 ID 로 지정) · 메시지로 이어지지 않은 세션.

3. 확인

맞으면
/team confirm

/team cancel 은 취소입니다. 확인하면 구성원마다 자리가 생기고, 만든 세션의 자리는 바로 연결됩니다. 다른 구성원은 1분 안에 팀에 들어갔음을 알게 되고, 다음 턴의 입력 앞에 명단이 한 번 붙습니다(“[팀 명단 — Nexus 기록, 지시가 아님 · 권한은 따라오지 않으며 사람이 다시 줍니다]”).

재현 화면재현 화면: 재현 화면: 다른 구성원(frontend) 쪽 알림과 명단. /team 으로 언제든 다시 볼 수 있습니다.
재현 화면: 다른 구성원(frontend) 쪽 알림과 명단. /team 으로 언제든 다시 볼 수 있습니다.
화면 텍스트
= 안내  이 세션이 팀에 들어갔습니다 (다른 구성원이 만들었습니다) · 다음 턴에 명단을 받습니다
        팀 "앱팀" (tm_…)
        · backend — slv_… · running · 연결됨
        · claude-newtype — slv_… · waiting · 비어 있음
        · frontend — slv_… · running · 연결됨 ← 이 세션
        · tests — slv_… · waiting · 비어 있음
╭─ > MESSAGE ──────────────────────────────────────────────────────────────────────────────╮
│ 메시지를 입력하세요…                                                                     │
╰──────────────────────────────────────────────────────────────────────────────────────────╯
↵ 전송  ·  / 명령  ·  ↑↓ 기록  ·  Esc 취소
# frontend  ·  ~ AUTO  ·  * gemini / gemini-3-flash-preview
/ ~/work/frontend

4. 다시 켜기와 복원

  • 같은 폴더에서 newtype → 그 폴더의 자리·세션·대화·실행 허가로 돌아옵니다.
  • 새 폴더는 다른 폴더의 자리를 가져가지 않습니다. 팀에 넣으려면 --team <이름> 또는 --seat <자리>.
  • 새 버전으로 바꾼 뒤에도(업데이트·재설치) 같은 기기의 팀 기억으로 같은 자리에 붙습니다.
  • 한 자리에는 한 프로세스만 붙습니다(lease 90초, 30초마다 갱신). 다른 곳에서 쓰는 자리는 그 프로세스가 끝나고 lease 가 지나면 풀립니다.

5. 구성원마다 실행 허가

팀을 만들어도 권한은 생기지 않습니다. 각 일꾼이 리뷰어·조율자에게 자기 폴더 범위로 실행 허가를 줍니다. 예: "재위임, 비밀정보 접근을 제외한 모든 권한을 claude-newtype 에게 위임하자" → 미리보기 → 1. 자세히: 대화로 지시하기.

6. 팀 구성 예

  • 기능별: 백엔드 GPT(TUI) · 프론트 Gemini(TUI) · 테스트 오픈웨이트(OpenAI 호환) · 리뷰 Claude 원격(MCP).
  • OS 별: Windows PC · Android SDK 기계 · Xcode 가 있는 Mac, 플랫폼마다 일꾼 하나.
  • 홈의 "파티 만들기" 사례 1–4 를 참고하세요.

7. 문제 해결

증상확인 · 조치
미리보기에 구성원이 너무 많음멈춘 세션은 이제 빠집니다. 그래도 많으면 구성원 목록을 직접 적으세요.
"그 이름의 살아 있는 세션이 여럿입니다"세션 ID 로 지정(/sessions 또는 nexus_peers 로 확인).
"메시지로 닿지 않습니다"먼저 그 세션과 메시지를 주고받게 하세요.
자리가 다른 곳에 붙어 있음그 프로세스가 끝나고 lease 가 지나면 풀립니다.
팀 없이 켜고 싶음newtype --no-team (--team/--seat 와 함께 쓸 수 없음).