재우니 개발자 블로그

Claude Task Master: 설치 가이드

 

Claude Task Master는 프로젝트 요구사항 문서(PRD)를 자동으로 구문 분석하고 구조화된 작업 목록을 생성하여 개발 워크플로를 간소화하도록 설계된 AI 기반 작업 관리 시스템입니다.

 

이 강력한 도구는 Cursor와 같은 편집기와 원활하게 통합되며 지능적인 작업 분류 및 관리 기능을 제공합니다.

설치

Option 1: MCP Installation (추천)

 

MCP 접근 방식은 Cursor와 같은 AI 편집기와 가장 원활하게 통합됩니다.

 

Step 1: Install the Package

 
npm install -g task-master-ai

 

 

Step 2: Configure MCP Server

편집기의 MCP 설정 파일(예: .cursor/mcp.json)에 다음 구성을 추가합니다:

{
  "mcpServers": {
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE"
      }
    }
  }
}

 

 

Step 3: Initialize Project

AI 편집기(커서)에서 간단히 프롬프트를 입력합니다:

Can you please initialize taskmaster-ai into my project?

 

 

Project Structure (프로젝트 구조)

 

초기화 후 작업 마스터는 다음과 같은 구조를 만듭니다:

your-project/
├── .taskmaster/
│   ├── docs/           # Place your PRD files here
│   ├── config.json     # Configuration settings
│   └── tasks.json      # Generated tasks
├── tasks/              # Individual task files
└── .cursor/
    └── rules/
        └── dev_workflow.mdc  # Cursor AI integration rules

 

 

Commands 사용법

기본 기능 Task Management

 

PRD 구문 분석 및 작업 생성:

task-master parse-prd .taskmaster/docs/prd.txt

 

 

모든 Tasks 목록

task-master list

 

 

다음 Task 보기:

task-master next
 

 

개별 작업 파일을 생성

task-master generate

 

 

Task Status 변경하기:

task-master set-status --id=3 --status=done

 

 

고급 기능

 

복잡한 작업을 세분화

task-master expand --id=5 --num=3 task-master expand --id=5 --prompt="Focus on security aspects"

 

 

Update Multiple Tasks 변경하기

task-master update --from=4 --prompt="Now we are using MongoDB instead of PostgreSQL"
 
 

Research Integration:

task-master research "Latest JWT security recommendations 2024" --id=5

 

Multi-Context 개발을 위한 TAG 관리

Tagg Context 생성하기:

task-master add-tag --from-branch task-master add-tag user-auth --description="User authentication feature tasks"

 

 

 

Contexts 간 전환하기:

task-master use-tag user-auth

 

TODO List Simulation 재연하기

Task Master 실제 프로젝트 워크플로를 시뮬레이션해 보겠습니다:

1. Create a Sample PRD

이 콘텐츠를 .taskmaster/docs/web-app-prd.txt에 배치합니다:

Project: E-commerce Web Application

Requirements:
- User registration and authentication system
- Product catalog with search functionality  
- Shopping cart implementation
- Order processing and payment integration
- Admin dashboard for inventory management
- Email notifications for orders
- Mobile-responsive design
- Security implementation with JWT tokens

 

2. Generate Tasks from PRD

task-master parse-prd .taskmaster/docs/web-app-prd.txt

 

3. View Generated Task List

task-master list​

 

 

Expected Output:

Tasks Overview:
ID | Title | Status | Priority | Dependencies
1  | User Authentication System | pending | high | []
2  | Product Catalog & Search | pending | high | [1]
3  | Shopping Cart Implementation | pending | medium | [1,2]
4  | Payment Integration | pending | high | [3]
5  | Admin Dashboard | pending | medium | [1]
6  | Email Notification System | pending | low | [4]
7  | Mobile Responsive Design | pending | medium | [2,3]
8  | Security & JWT Implementation | pending | high | [1]

 

4. Work on Next Priority Task

task-master next

 

 

5. Break Down Complex Tasks

task-master expand --id=1 --num=4

 

 

This generates subtasks like:

  • 1.1: User registration form
  • 1.2: Login/logout functionality
  • 1.3: Password reset system
  • 1.4: User profile management

 

 

 

ASP.NET Core 8 MVC Integration Example

다음은 ASP.NET Core 8 MVC 프로젝트에 클로드 태스크 마스터를 사용하는 포괄적인 예제입니다:

 

ASP.NET Core Project

1. ASP.NET Core Specific PRD 작성하기

이 파일을 .taskmaster/docs/aspnet-mvc-prd.txt에 넣습니다:

 

ASP.NET Core 8 MVC E-Learning Platform

Technical Requirements:
- ASP.NET Core 8 MVC architecture
- Entity Framework Core 8 with SQL Server
- Identity Framework for authentication
- Razor Pages with ViewModels
- Repository pattern implementation
- Dependency injection container setup
- Areas for Admin/Student/Instructor modules
- SignalR for real-time notifications
- Background services for email processing
- API controllers for mobile app integration
- Unit testing with xUnit and Moq
- Docker containerization
 
 

2. Research 기능으로 Tasts Generate 하기

 

task-master parse-prd .taskmaster/docs/aspnet-mvc-prd.txt
task-master research "ASP.NET Core 8 MVC best practices 2024" --id=1

 


 

ASP.NET Core 개발을 위한 AI 질문 가이드

Task Master  를 설치한 후 ASP.NET Core 8 MVC 개발을 위해 Task Master 와 상호 작용하는 효과적인 방법은 다음과 같습니다:

 

Architecture 와 셋팅 관련 질문

 
What's the next task for setting up our ASP.NET Core 8 MVC project structure? 
Please consider dependency injection and the repository pattern.

I need to implement task 3 (Entity Framework setup). Can you research the latest 
EF Core 8 configuration patterns and update the task with current best practices?


Can you break down task 5 (Identity Framework integration) into subtasks that 
follow ASP.NET Core Identity conventions?
 
 

개발 구현에 대한 질문

I'm working on task 7 (Repository pattern). Research the latest ASP.NET Core 8 
repository pattern implementations and help me understand the current approach.

We've decided to use Minimal APIs alongside MVC controllers for our API endpoints. 
Can you update tasks 8-12 to reflect this architectural change?

Show me tasks 4, 6, and 8 so I can understand the database, authentication, 
and API dependencies before implementing the controller layer.

 

테스트와 품질에 대한 내용

I've completed the user controller implementation for task 6. All unit tests are 
passing. Please mark it as complete and tell me what MVC-related task I should work on next.

Can you expand task 11 (Unit Testing) with a focus on ASP.NET Core MVC controller 
testing patterns using xUnit and Moq?

 

ASP.NET Core 고급 기능

Research SignalR integration patterns for ASP.NET Core 8 MVC and update task 9 
with the latest real-time communication approaches.

I need to implement background services for task 10. Can you research .NET 8 
hosted services and update the task with current implementation patterns?