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가 스스로 원인을 분석하고 수정할 수 있는 구체적인 가이드를 제공하여 자가 복구 능력을 높입니다.

📦 시작하기

# 설치 없이 바로 실행하여 프로젝트를 초기화합니다.
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