---
description: Git Worktree를 사용하여 새로운 태스크 시작 및 검증
---

# Git Worktree 기반 태스크 실행

이 워크플로우는 메인 브랜치를 더럽히지 않고 격리된 환경(Worktree)에서 태스크를 처리할 때 사용합니다.

## 1단계: 신규 작업 환경 생성
```bash
git worktree add ../task-<task-id> -b feature/task-<task-id>
cd ../task-<task-id>
```
- `<task-id>`는 `TASK_BREAKDOWN.md`에 정의된 ID로 대체하세요.
- 의존성 설치가 필요할 수 있습니다: `<%= runCmd %> install`

## 2단계: 태스크 구현
1. `TASK_BREAKDOWN.md`에서 선택한 태스크의 요구사항을 확인합니다.
2. 새 워크트리 디렉토리에서 코드를 구현합니다.

## 3단계: 검증 및 커밋
1. 구현 완료 후 **verify-task** 워크플로우를 실행합니다.
   ```bash
   # 다른 터미널 또는 현재 워크트리에서 실행
   npx task-master-agent verify
   ```
2. 검증 통과 시 다음을 수행합니다:
   - **[CRITICAL RULE]** 태스크가 끝날 때마다 반드시 `TASK_BREAKDOWN.md`를 업데이트하여 최신 상태(`[x]`)를 유지하세요.
   - 워크트리 내 변경사항을 커밋합니다.
   ```bash
   git add .
   git commit -m "feat: <task-description>"
   ```

## 4단계: 작업 정리 및 병합
1. 메인 워크트리로 돌아가 병합합니다.
   ```bash
   cd -
   git merge feature/task-<task-id>
   ```
2. 작업용 워크트리를 삭제합니다.
   ```bash
   git worktree remove ../task-<task-id>
   git branch -d feature/task-<task-id>
   ```

## 참조
- @.agent/TASK_BREAKDOWN.md
- @.agent/workflows/verify-task.md