# task-master-agent

**AI 에이전트를 위한 최강의 태스크 마스터 도구**

`task-master-agent`는 AI 에이전트(Antigravity, Cursor 등)가 개발 프로세스를 스스로 지휘하고 실행할 수 있도록 최적의 **AI-Native 워크플로우**를 구축해주는 npm CLI 도구입니다.

단순한 태스크 관리를 넘어, 요구사항 분석부터 기술 설계, 구현, 검증까지 이어지는 전문적인 개발 사이클을 자동화합니다.

---

## 🚀 주요 특장점

AI 에이전트와 협업할 때 발생하는 **"맥락(Context)의 단절"**과 **"부정확한 검증"** 문제를 근본적으로 해결합니다.

### 1. 🏛️ 건축가 모드 (Architect Mode)
설계(Plan) → 구현(Do) → 검증(Check) 사이클을 지휘하는 수석 아키텍트 워크플로우를 제공합니다. PRD로부터 정교한 태스크를 도출하고, 구현 계획 수립 및 TDD 방식의 검증까지 독립적으로 수행합니다.

### 2. ⌨️ AI-Native No-Input CLI
모든 CLI 입력이 `선택형 리스트`로 구성되어 있습니다. 에이전트가 `y/n` 등을 직접 타이핑할 필요 없이 화살표 키와 엔터만으로 정확하게 도구를 조작할 수 있어 오류를 최소화합니다.

### 3. 🔍 스마트 컨텍스트 동기화
AI 에이전트가 현재 어떤 작업을 하고 있는지, 다음 단계는 무엇인지 즉시 파악할 수 있도록 상태 정보를 동기화합니다. `TASK_BREAKDOWN.md`를 통해 작업의 **Source of Truth**를 유지합니다.

### 4. 🛡️ 엄격한 자동 검증 및 자가 복구
린트, 타입 체크, 빌드는 물론 **시각적 완성도**까지 검증합니다. 실패 시 AI가 스스로 원인을 분석하고 수정할 수 있는 구체적인 가이드를 제공하여 자가 복구 능력을 높입니다.

---

## 📦 시작하기

```bash
# 설치 없이 바로 실행하여 프로젝트를 초기화합니다.
npx task-master-agent@latest
```

실행 후 나타나는 **인터랙티브 메뉴**를 통해 프로젝트 설정 및 워크플로우를 관리할 수 있습니다.

---

## 🛠️ 에이전트 워크플로우 (Slash Commands)

AI 에이전트(Antigravity, Cursor 등) 대화창에서 아래 커맨드를 호출하여 작업을 지시하세요.

| 명령어 | 용도 |
| :--- | :--- |
| `/task-architect` | **[추천]** PRD 분석부터 최종 검증까지 전 과정을 자동 수행 |
| `/task-next` | 다음 대기 중인 태스크를 진행하고 결과를 자동 검증 |
| `/task-all` | 남아있는 모든 태스크를 순차적으로 자동 처리 |
| `/write-prd` | 사용자 요구사항을 기반으로 고도화된 PRD 작성 |
| `/verify-task` | 구현된 기능의 품질과 시각적 완성도를 엄격하게 검수 |

---

## 📈 베스트 프랙티스

1.  **초기화**: `task-master-agent init`을 실행하여 프로젝트 구조를 잡습니다.
2.  **설계**: `/write-prd`로 요구사항을 정리하고 `parse-prd`로 태스크를 자동 생성합니다.
3.  **실행**: `/task-architect` 또는 `/task-next`를 사용하여 에이전트에게 구현을 맡깁니다.
4.  **동기화**: 작업 중간에 `sync` 명령어로 에이전트의 맥락을 최신화합니다.
5.  **검증**: 수정된 `verify-task` 워크플로우를 통해 기능과 디자인을 최종 확인합니다.

---

## 📂 프로젝트 구조

- `.agent/`: 핵심 엔진, 개발 룰, 자동화 워크플로우 저장소
- `.agent/TASK_BREAKDOWN.md`: 전체 작업 상태를 관리하는 핵심 문서
- `.task-master.json`: 프로젝트별 맞춤형 설정 파일

---

## 라이선스

MIT