🤖 TaskMaster AI CLI Generator

단 하나의 명령어로 완전한 AI 기반 개발 환경을 구축하세요

TaskMaster AI CLI Generator (tm-setup)는 AI 기반 개발 프로젝트를 위한 완전 자동화된 설정 도구입니다. Smart Agent Dispatcher가 내장되어 있어, Claude Code CLI, Gemini CLI, Cursor Agent가 작업 내용에 따라 자동으로 분류되어 실행됩니다.

✨ 주요 특징

🚀 완전 자동화

• 5분 설정: 복잡한 AI 개발 환경을 단 한 번의 명령어로 구성
• 자동 분류: 작업 내용 분석하여 최적의 AI 에이전트 자동 선택
• 제로 컨텍스트 스위칭: 통합된 워크플로우로 도구 간 전환 없음

🧠 Smart Agent Dispatcher 내장

• 키워드 기반 분류: .env 파일로 간단한 커스터마이징
• 가중치 시스템: 팀/프로젝트별 에이전트 우선순위 조정
• SuperClaude 모드: Test/Design/Task/Clean 전문 모드 지원

🎯 프로젝트 타입별 최적화

• 웹 앱: React/Vue + Tailwind 최적화
• API 서버: Express/FastAPI + 테스트 중심
• 모바일: React Native/Flutter + 성능 최적화
• CLI 도구: 명령어 인터페이스 + 자동화
• AI/ML: 데이터 분석 + 모델 개발

🏃‍♂️ 빠른 시작

설치

# 글로벌 설치 (권장)
npm install -g tm-setup

# 또는 즉시 사용
npx tm-setup init

새 프로젝트 생성

# 대화형 설정
tm-setup init

# 빠른 설정
tm-setup init --name="my-ai-app" --type="web-app" --stack="react"

생성되는 파일 구조

my-ai-app/
├── 📱 Smart Agent Dispatcher
│   ├── .env                     # 키워드/가중치 설정
│   ├── .vscode/settings.json    # VS Code 단축키
│   ├── .cursor/mcp_config.json  # Cursor MCP 통합
│   └── SMART_AGENT_GUIDE.md     # 사용법 가이드
├── 🤖 TaskMaster AI
│   ├── .taskmaster/config.json  # TaskMaster 설정
│   ├── .taskmaster/docs/prd.txt # 자동 생성된 PRD
│   └── .taskmaster/tasks/       # 태스크 관리
├── 🛠️ 개발 환경
│   ├── package.json             # 맞춤 스크립트
│   ├── tsconfig.json            # TypeScript 설정
│   ├── .eslintrc.json           # ESLint 설정
│   ├── .prettierrc              # Prettier 설정
│   └── DEVELOPMENT.md           # 개발 가이드
└── 🚀 DevOps (선택적)
    ├── Dockerfile
    ├── docker-compose.yml
    └── .github/workflows/

🎯 Smart Agent 사용법

기본 단축키

| 단축키 | 기능 | 설명 | |--------|------|------| | Ctrl+Shift+A | 🎯 자동 분류 | 작업 내용 분석하여 최적 에이전트 선택 | | Ctrl+Shift+Q | ⚡ 즉시 실행 | 가장 높은 신뢰도로 즉시 실행 | | Ctrl+Shift+S | 📝 선택 코드 | 선택된 코드 기반으로 작업 |

SuperClaude 모드

| 단축키 | 모드 | 전문 분야 | |--------|------|-----------| | Ctrl+Shift+T | 🧪 Test | 단위/통합 테스트, 검증 | | Ctrl+Shift+D | 🏗️ Design | 아키텍처 설계, 리팩토링 | | Ctrl+Shift+X | ⚡ Task | 복잡한 기능 구현 | | Ctrl+Shift+C | ✨ Clean | 코드 정리, 성능 최적화 |

🔄 실제 사용 시나리오

시나리오 1: 웹 앱 개발

# 1. 프로젝트 생성
tm-setup init --type="web-app" --stack="react"

# 2. VS Code에서 개발 시작
code my-app

# 3. AI 에이전트 사용
"사용자 인증 시스템 구현해줘"           # → Claude Code SuperClaude Task
"위 시스템 단위 테스트 작성해줘"        # → Claude Code SuperClaude Test  
"인증 API 문서 작성해줘"              # → Gemini CLI
"코드 리팩토링하고 최적화해줘"         # → Claude Code SuperClaude Clean

시나리오 2: API 서버 개발

# 1. API 프로젝트 생성
tm-setup init --type="api" --stack="node"

# 2. 자동 최적화된 키워드로 개발
"REST API 엔드포인트 구현"            # → SuperClaude Task (가중치 높음)
"API 로드 테스트 코드 작성"           # → SuperClaude Test (API 특화)
"데이터베이스 쿼리 최적화"            # → SuperClaude Clean (성능 중심)

⚙️ 고급 설정

.env 파일 커스터마이징

# 🎯 기본 동작
SMART_AGENT_DEFAULT_MODE=auto
SMART_AGENT_AUTO_EXECUTE=false
SMART_AGENT_SHOW_CONFIDENCE=true

# 🔧 에이전트 명령어
GEMINI_CLI_COMMAND=gemini-cli
CLAUDE_CODE_COMMAND=claude-code

# 📋 프로젝트별 키워드 (예: React 프로젝트)
SC_TASK_KEYWORDS_CUSTOM=react,component,hooks,state,jsx,tsx
SC_TEST_KEYWORDS_CUSTOM=react-testing-library,jest,storybook
SC_CLEAN_KEYWORDS_CUSTOM=bundle-size,lighthouse,performance

# ⚖️ 가중치 조정
WEIGHT_SUPER_CLAUDE_TASK=2.2    # UI 작업 우선
WEIGHT_SUPER_CLAUDE_TEST=2.0    # 테스트 중요도
WEIGHT_GEMINI_CLI=1.5           # 문서화 강화

# 🎯 임계값
MIN_CONFIDENCE_THRESHOLD=0.6    # 최소 신뢰도
AUTO_EXECUTE_THRESHOLD=0.8      # 자동 실행 기준

팀별 최적화 예시

프론트엔드 팀

SC_TASK_KEYWORDS_CUSTOM=component,ui,ux,responsive,accessibility
WEIGHT_SUPER_CLAUDE_TASK=2.5
WEIGHT_SUPER_CLAUDE_CLEAN=2.0  # 성능 최적화 중요

백엔드 팀

SC_TASK_KEYWORDS_CUSTOM=api,database,microservice,scaling
WEIGHT_SUPER_CLAUDE_TEST=2.5   # API 테스트 중요
WEIGHT_SUPER_CLAUDE_DESIGN=2.2 # 아키텍처 설계 중요

DevOps 팀

SC_TASK_KEYWORDS_CUSTOM=docker,kubernetes,pipeline,monitoring
SC_CLEAN_KEYWORDS_CUSTOM=deployment,automation,optimization
WEIGHT_SUPER_CLAUDE_CLEAN=2.5  # 인프라 최적화 중심

📋 CLI 명령어

기본 명령어

# 새 프로젝트 초기화
tm-setup init [options]

# 설정 관리
tm-setup config [options]

# 템플릿 관리  
tm-setup template [options]

# AI 에이전트 설정
tm-setup agent [options]

# 프로젝트 상태 확인
tm-setup status [options]

초기화 옵션

tm-setup init --help

Options:
  -n, --name <name>          프로젝트명
  -d, --description <desc>   프로젝트 설명
  -t, --type <type>          프로젝트 타입 (web-app, api, cli, mobile, ai-ml)
  -s, --stack <stack>        기술 스택 (react, vue, node, python)
  --skip-git                 Git 초기화 건너뛰기
  --skip-install             패키지 설치 건너뛰기
  -v, --verbose              상세 로그 출력

설정 명령어

# 설정 파일 생성
tm-setup config --generate

# 특정 에이전트 설정
tm-setup config --claude-code
tm-setup config --gemini  
tm-setup config --cursor

# 설정 출력 경로 지정
tm-setup config --output ./custom-config

에이전트 관리

# 모든 에이전트 설정
tm-setup agent setup --all

# 특정 에이전트만 설정
tm-setup agent setup --claude
tm-setup agent setup --gemini

# 에이전트 상태 확인
tm-setup agent status

🔧 요구사항

필수 요구사항

• Node.js: 18.0.0 이상
• npm/yarn/pnpm: 최신 버전
• Git: 버전 관리용

AI 에이전트 요구사항

• Claude Code CLI: Claude Pro/Team 구독 (무료 사용)
• Gemini API: Google AI Studio API 키
• Cursor: Cursor Pro 구독 (선택적)

지원 플랫폼

• ✅ Windows 10/11
• ✅ macOS 10.15+
• ✅ Linux (Ubuntu, Debian, CentOS)

📊 성능 및 효과

설정 시간 비교

| 구분 | 기존 방식 | tm-setup | 개선 효과 | |------|-----------|----------|-----------| | 프로젝트 설정 | 2-3시간 | 5분 | 97% 단축 | | AI 도구 설정 | 1-2시간 | 자동 | 100% 자동화 | | 에이전트 선택 | 매번 수동 | 자동 분류 | 무한 개선 | | 문서화 작업 | 별도 시간 | 실시간 | 즉시 처리 |

개발 생산성 향상

• 🚀 개발 속도: 50-70% 향상
• 🎯 AI 선택 정확도: 90%+ (기존 60%)
• 📚 문서화: 자동 생성으로 100% 최신 상태 유지
• 🧪 테스트 커버리지: 자동 테스트 생성으로 대폭 향상

🤝 기여하기

개발 환경 설정

# 저장소 클론
git clone https://github.com/yourusername/tm-setup.git
cd tm-setup

# 의존성 설치
npm install

# 개발 모드 실행
npm run dev

# 빌드
npm run build

# 테스트
npm test

기여 가이드라인

1. 이슈 확인: 기존 이슈를 확인하거나 새 이슈 생성
2. 브랜치 생성: feature/your-feature-name 형태
3. 커밋 컨벤션: Conventional Commits 규칙 준수
4. 테스트 작성: 새 기능에 대한 테스트 코드 작성
5. PR 생성: 상세한 설명과 함께 Pull Request 생성

기여 영역

• 🌍 다국어 지원: 키워드 패턴 번역
• 🔧 새로운 AI 모델: 추가 에이전트 통합
• 📚 템플릿 확장: 새로운 프로젝트 타입
• 🐛 버그 수정: 이슈 해결 및 개선
• 📖 문서화: 사용 가이드 및 예제 추가

📞 지원 및 커뮤니티

문제 해결

• 📋 GitHub Issues: 버그 리포트 및 기능 요청
• 💬 Discussions: 사용법 문의 및 팁 공유
• 📧 이메일: [email protected]

커뮤니티

• 🐦 Twitter: @TMSetupCLI
• 💼 LinkedIn: TaskMaster AI Community
• 📺 YouTube: 사용법 튜토리얼

자주 묻는 질문

A: 네! Claude Pro 구독이 있다면 Claude Code CLI를 통해 API 키 없이 사용 가능합니다. Gemini는 무료 API 키로 사용할 수 있습니다.

A: 물론입니다! tm-setup config 명령어로 기존 프로젝트에 Smart Agent Dispatcher를 추가할 수 있습니다.

A: .env 파일과 .vscode/settings.json을 Git에 포함시켜 팀원들과 공유할 수 있습니다.

A: v1.1에서 플러그인 시스템을 통해 커스텀 에이전트 추가 기능을 제공할 예정입니다.

🗺️ 로드맵

v1.0.0 (현재) ✅

• ✅ 기본 프로젝트 초기화
• ✅ Smart Agent Dispatcher 통합
• ✅ Claude Code CLI + SuperClaude 모드 지원
• ✅ Gemini CLI 통합
• ✅ 프로젝트 타입별 최적화
• ✅ VS Code/Cursor 통합

v1.1.0 (예정)

• 🔄 더 많은 AI 모델 지원 (DeepSeek, Claude Opus 4)
• 🔄 플러그인 시스템 (커스텀 에이전트)
• 🔄 웹 대시보드 (사용 패턴 분석)
• 🔄 팀 협업 기능 (설정 템플릿 공유)

v1.2.0 (예정)

• 🔄 GitHub Copilot 통합
• 🔄 자동 코드 리뷰 시스템
• 🔄 성능 분석 및 최적화 제안
• 🔄 다국어 키워드 지원

v2.0.0 (Enterprise)

• 🔄 중앙집중식 관리 (회사 표준)
• 🔄 비용 최적화 (API 사용량 분석)
• 🔄 고급 보안 (API 키 중앙 관리)
• 🔄 상세 분석 (팀 생산성 리포트)

📄 라이선스

MIT License - 자유롭게 사용, 수정, 배포 가능합니다.

Copyright (c) 2025 TaskMaster AI CLI Generator

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

🎉 시작해보세요!

# 지금 바로 시작하기
npm install -g tm-setup
tm-setup init

# 또는 즉시 체험
npx tm-setup init --name="my-first-ai-project" --type="web-app"

🚀 5분만에 완성되는 AI 기반 개발 환경을 경험해보세요!

단 하나의 명령어로 Claude Code CLI, Gemini CLI, Cursor Agent가 완벽하게 통합된 스마트한 개발 워크플로우를 구축할 수 있습니다.