세션 생성 및 Git 협업

한 쌍으로 작동하는 두 가지 기능: vspawn을 사용해 서브태스크를 독립적인 자식 세션에 생성하는 기능(선택적으로 격리된 git worktree 내에서도 가능)과, 병렬로 작동하는 브랜치들을 다시 하나로 합치는 그래픽 기반 병합 기능입니다. 이 두 기능을 함께 사용하면 “여러 에이전트가 동일한 리포지토리를 병렬로 처리하는” 작업 흐름이 일상적으로 가능해집니다.

1. 스포닝이란 무엇인가

어떤 세션 내에서든 서브태스크를 분리할 수 있습니다. VelaTerm는 현재 노드 아래에 새 자식 세션을 만들고, 트리는 부모 → 자식 → 손자 구조가 됩니다. 선택적으로 격리된 git worktree를 할당할 수 있으며, 태스크 설명이 새 세션의 첫 번째 메시지로 전달됩니다. 새 에이전트는 시작되는 즉시 작업하므로 다시 설명할 필요가 없습니다.

그 결과로 트리 내에 실제 세션이 생성되며, 이 세션은 자체 프로세스를 가지고 있고 완전히 대화형이며 재개가 가능합니다. 언제든지 이 세션을 모니터링하거나 직접 접속할 수 있습니다. 이는 숨겨진 백그라운드 작업이 아닙니다.

2. 4가지 접근 방식

두 개의 터미널 명령어는 설치 없이도 모든 세션의 PATH에 자동으로 삽입됩니다.

/ 기능을 사용하기 위한 사전 조건: 클로드가 /vspawn 또는 /vspawn-tree를 사용하거나(또는 자체적으로 서브 세션을 생성하려면), 설정 ▸ 일반에서 Vela Skills을 활성화해야 합니다. 이를 통해 /vspawn, /vspawn-tree, /vopen 기능들이 번들 형태로 ~/.claude/skills/에 설치되며, 앱 업데이트 시 자동으로 최신 상태로 유지됩니다. 활성화한 후 새로운 클로드 세션을 시작하거나 기존 세션을 재시작하여 에이전트가 해당 기능들을 인식하도록 해야 합니다. 이 과정이 생략되면 클로드는 이러한 명령어들을 인식하지 못하며, 터미널에서 입력하는 vspawn / vspawn-tree만 작동합니다.

3. 생성 전 확인

기본적으로 새로운 세션이 생성될 때마다 우측 상단에 확인 카드가 먼저 표시되며, 이는 모달 형태가 아니고 포커스를 차지하지 않습니다:

• 편집 가능한 세 개의 필드가 있습니다: prompt (다중 줄), agent type (부모 세션의 값이 기본값으로 사용됨), 그리고 separate git worktree입니다.
• "Launch"는 자식 세션을 시작하고, "Cancel"은 요청을 취소합니다. 에이전트가 여러 세션을 동시에 생성할 경우 카드들은 하나씩 처리되며, 남은 세션 수가 카드에 표시됩니다.
• 확인 절차를 완전히 생략하고 싶다면, 설정 ▸ 동작에서 “생성 전 확인”을 끄세요.

4. 워크트리: 서로 방해받지 않는 병렬 처리

워크트리 옵션이 켜져 있으면 자식 세션은 자체 작업 디렉터리 내의 새로운 브랜치에서 작동하며, 메인 작업 공간 및 다른 자식 세션들과는 분리됩니다. 이것이 다중 에이전트 병렬 처리에 적합한 형태입니다. 관리는 세션 컨텍스트 메뉴의 “워크트리 ▸” 아래에서 이루어지며, 변경 사항 확인, 워크트리 폴더 복사/열기, 워크트리 삭제(미 커밋된 변경 사항을 강제로 삭제할 수도 있음) 기능이 제공됩니다.

git이 아닌 디렉터리에서도 생성하는 것은 여전히 가능합니다. 단, 워크트리 없이 부모 디렉터리를 공유하는 방식으로 처리됩니다.

5. 병합: 그래픽 기반 Git 병합

작업이 완료되면 결과를 로컬로 가져옵니다. 작업 디렉터리가 git 저장소인 모든 세션(워크트리 여부와 상관없이): 마우스 오른쪽 버튼 → "Git ▸ Merge…"를 클릭하면 병합 대화상자가 열립니다:

• **소스 브랜치와 대상 브랜치 **를 모두 선택할 수 있으며, 방향을 바꿀 수도 있습니다. 자식 브랜치를 메인 브랜치로 다시 병합하거나, 메인 브랜치의 최신 상태를 자식 브랜치에 적용하는 등 모든 작업을 동일한 대화상자에서 수행할 수 있습니다.
• 병합은 대상 브랜치가 체크아웃된 작업 트리에서 실행됩니다. 소스 트리에 커밋되지 않은 변경 사항이 있을 경우, 먼저 이를 커밋하여 데이터가 손실되지 않도록 합니다.
• 충돌이 발생하면 해당 장면은 그대로 남아 있어 사용자(또는 에이전트)가 터미널에서 문제를 해결하고 작업을 계속할 수 있습니다.

병합 과정에서는 워크트리가 자동으로 삭제되지 않습니다. 확실해진 후 “Worktree ▸ Delete worktree…”를 통해 직접 정리해 주세요.

6. 일반적인 작업 흐름

1. 메인 세션에서 claude에게 작업을 분석하도록 하고, 그 후 /vspawn-tree refactor the checkout module를 사용해 해당 작업을 시작합니다(이 기능에는 Vela Skills가 필요합니다 — §2 참조).
2. 확인 카드에 표시된 프롬프트를 검토한 뒤 Launch를 클릭하면, 자식 작업은 자체 워크트리에서 실행되며 사이드바에서 부모 작업 아래에 표시되고 점이 녹색으로 변합니다.
3. 사용자는 계속해서 메인 세션에서 작업을 진행합니다. 자식 작업이 무언가를 요청하거나 작업을 완료하면 그 점이 노란색으로 변하고 알림이 표시됩니다.
4. 직접 확인한 뒤 마우스 오른쪽 버튼을 클릭하여 “Git ▸ Merge…”를 선택해 해당 브랜치를 메인 브랜치에 다시 병합합니다.
5. 정리를 위해 “Worktree ▸ Delete worktree…”를 사용한 뒤, 기록을 위해 자식 세션을 아카이브합니다.