docs: 기본 파일 구조, .gitignore, CLAUDE.md, README.md, 및 작업 관리 시스템을 위한 설정 파일 추가

README.md

@@ -1,3 +1,239 @@
 # ai-dev-claude-tm-cursor
 
-Claude Code를 통한 지능형 코드 생성, Task Master를 통한 효율적인 프로젝트 관리, 그리고 Cursor를 통한 AI 기반 코드 편집 기능을 통합한 AI 기반 개발 템플릿입니다. 고급 AI 기능을 활용하여 개발 워크플로우를 간소화하세요.
+Claude Code, Task Master, Cursor를 연동한 AI 기반 개발 템플릿입니다.
+
+## 소개
+
+세 가지 강력한 AI 개발 도구를 결합한 프로젝트 템플릿입니다:
+
+- [**Claude Code**](https://docs.anthropic.com/en/docs/claude-code/overview) - Anthropic의 Claude용 CLI
+- [**Task Master**](https://github.com/eyaltoledano/claude-task-master) - 태그 기반 작업 관리 시스템
+- [**Cursor**](https://www.cursor.com/) - 정밀한 코드 리뷰 워크플로를 위한 AI 기반 IDE (선택 사항)
+
+## 시작하기
+
+1. **Claude Code 실행**
+
+   ```bash
+   claude
+   ```
+
+2. **Task Studio 열기** (선택적 웹 인터페이스)
+
+   ```bash
+   npx task-studio@latest
+   ```
+
+3. **워크플로를 따르세요:**
+   - `/create-app-design` - 앱 설명하기
+   - `/create-tech-stack` - 기술 스택 선택하기
+   - `/create-prd-interactive` - 기능 요구사항 작성하기
+   - `/parse-prd` - 요구사항을 작업으로 변환하기
+   - `/next` - 코딩 시작하기
+
+## 작동 방식
+
+Claude Code는 다음을 통해 프로젝트를 이해합니다:
+
+- **CLAUDE.md** - 자동으로 로드되는 프로젝트 컨텍스트 및 규칙
+- **Task Master** - MCP 연동을 통한 작업 관리
+- **자연어** - 하고 싶은 작업을 설명하기만 하면 됩니다
+
+명령어를 외울 필요 없이 Claude에게 간단히 요청하세요:
+
+- "인증을 위한 새 기능 태그 생성"
+- "다음 작업 보여주기"
+- "이 작업을 완료로 표시"
+- "이 기능에 남은 작업은?"
+
+## 명령어
+
+### 빠른 참조
+
+| 명령어                       | 설명                                                                 | 분류          |
+| ------------------------------ | -------------------------------------------------------------------- | ------------- |
+| `/create-app-design`           | 프로젝트 단계 평가를 포함한 포괄적인 앱 설계 문서 생성                   | 문서          |
+| `/update-app-design`           | 코드베이스 변경사항을 기반으로 기존 앱 설계 문서 업데이트                | 문서          |
+| `/create-tech-stack`           | 코드베이스 분석을 통해 포괄적인 기술 스택 문서 생성                      | 문서          |
+| `/update-tech-stack`           | 의존성 변경에 따라 기술 스택 문서 업데이트                               | 문서          |
+| `/create-prd-interactive`      | 복잡한 기능에 대해 명확한 질문을 통해 대화형으로 PRD 생성                | 문서          |
+| `/create-prd`                  | 단순하고 잘 정의된 기능에 대해 질문 없이 바로 PRD 생성                   | 문서          |
+| `/parse-prd`                   | PRD를 파싱하여 선택적 태그 생성과 함께 Task Master 작업으로 변환         | 문서          |
+| `/create-rule`                 | 적절한 구조와 컨벤션을 갖춘 새 Cursor 규칙 파일 생성                     | 문서          |
+| `/update-rule`                 | 새로운 패턴이나 코드베이스 진화에 따라 기존 Cursor 규칙 업데이트         | 문서          |
+| `/update-project-structure`    | `tree` 스크립트를 실행하여 프로젝트 구조 문서 업데이트                   | 문서          |
+| `/next`                        | 다음 작업을 받아 즉시 구현 시작                                        | 작업          |
+| `/done`                        | 작업을 완료로 표시하고 선택적으로 다음 작업 받기                         | 작업          |
+| `/show`                        | 특정 작업의 세부 정보 표시                                               | 작업          |
+| `/list`                        | 현재 태그의 모든 작업 나열                                               | 작업          |
+| `/add`                         | 현재 태그에 하나 이상의 작업 추가                                        | 작업          |
+| `/add-interactive`             | 명확한 질문을 통해 대화형으로 작업 추가                                  | 작업          |
+| `/update-task`                 | 구현 변경사항에 따라 작업 업데이트                                       | 작업          |
+| `/update-task-interactive`     | 명확한 질문을 통해 대화형으로 작업 업데이트                              | 작업          |
+| `/expand`                      | 작업을 하위 작업으로 분해                                                | 작업          |
+| `/move`                        | 작업 구조 재구성                                                         | 작업          |
+| `/research`                    | 모범 사례를 연구하고 작업 업데이트                                       | 작업          |
+| `/task`                        | 모범 사례를 연구하고 작업 업데이트                                       | 리서치        |
+| `/tech`                        | 기술, 프레임워크, 도구 연구                                              | 리서치        |
+| `/security`                    | 보안 모범 사례 및 취약점 연구                                            | 리서치        |
+| `/architecture`                | 아키텍처 패턴 및 모범 사례 연구                                          | 리서치        |
+| `/create-snippet`              | 재사용 가능한 코드 스니펫 생성                                           | 스니펫        |
+| `/debug`                       | 복잡한 문제에 대한 체계적인 디버깅 프로세스                              | 지원          |
+
+### 명령어 세부 정보
+
+모든 명령어는 프로젝트 컨텍스트를 분석하고 지능적인 지원을 제공하는 패턴을 따릅니다. 문서 관련 명령어는 일반적으로 정확한 결과물을 보장하기 위해 명확한 질문을 합니다. 작업 관련 명령어는 현재 태그 컨텍스트 내에서 작동합니다. 리서치 관련 명령어는 웹 검색을 활용하여 AI의 지식 마감일 이후의 최신 정보를 가져옵니다.
+
+## 팁
+
+### Claude Code 대 Cursor
+
+**대부분의 개발 작업에는 기본적으로 Claude Code를 사용하세요**:
+
+✅ **장점:**
+
+- 장기적인 프로젝트 이해 및 컨텍스트 유지
+- 모든 Task Master AI 명령어 지원
+- 병렬 개발
+- Claude Opus의 광범위한 사용을 위한 가장 저렴한 요금제
+
+❌ **단점:**
+
+- 세션 간 채팅 기록 유지 안 됨
+- 개별 파일 변경에 대한 세분화된 제어 부족
+
+**다음과 같은 경우 Cursor로 전환하세요:**
+
+✅ **세분화된 코드 리뷰 제어:**
+
+- 파일별로 특정 diff를 수락/거부
+- 인라인 코드 탐색 기능이 있는 시각적 diff 검토
+- 복원 지점 및 쉬운 변경 되돌리기
+- 신중한 코드 검사가 필요한 복잡한 리팩토링
+
+❌ **단점:**
+
+- 대화가 길어지면 느려지고 불안정해짐
+- 비-AI Task Master 명령어만 지원
+- Claude Code보다 프로젝트 컨텍스트 관리가 비효율적
+- 자주 새로운 채팅을 시작해야 함
+
+**추천 요금제:**
+
+**Claude Max ($100/월)**
+
+- 기본 사용을 위해 Pro 요금제($20/월)로 시작
+- 중요 프로젝트를 위해 **Max 5x**($100/월)로 업그레이드: 훨씬 높은 사용량 한도, 심층 연구를 위한 Claude Opus 모델 잠금 해제
+- 사용량 한도에 자주 도달하는 경우 **Max 20x**($200/월)로 업그레이드. Claude Opus의 광범위한 사용에 가장 가성비 좋음.
+
+**Cursor Pro ($20/월)**
+
+- 선택 사항이지만, 세분화된 코드 리뷰 워크플로에 필수적
+- 시각적 diff 관리 및 복원 지점
+- 정밀한 편집을 위해 Claude Code를 완벽하게 보완
+
+### 컨텍스트 관리
+
+- **Claude Code**: 다른 작업 사이에 `/clear`를 사용하여 집중 유지
+- **Claude Code**: 프로젝트 컨텍스트를 위해 `CLAUDE.md`를 자동으로 읽음
+- **두 도구 모두**: Task Master 상태는 세션 간에 유지됨
+
+### 빠른 명령어 (자연어)
+
+- "다음 작업은?" - 다음 작업 가져오기
+- "작업 2.1 보여줘" - 특정 작업 세부 정보 보기
+- "완료로 표시해줘" - 현재 작업 완료하기
+- "인증 기능 태그 만들어줘" - 새 기능 컨텍스트 생성
+- "결제 태그로 전환해줘" - 컨텍스트 변경
+
+### 사용자 정의 명령어 생성
+
+`.claude/commands/`에 추가하여 자신만의 슬래시 명령어를 만드세요.
+
+### 다중 작업 및 다중 기능 개발
+
+동일한 기능 내에서 또는 여러 기능에 걸쳐 다중 작업을 수행합니다:
+
+```bash
+# 다중 작업 개발 (동일 기능)
+"현재 태그의 모든 작업 보여줘"
+"작업 2.1 보여줘" - 특정 작업 검토
+"완료로 표시" - 작업 완료 후 다음으로 이동
+
+# 다중 기능 개발
+"결제 태그로 전환하고 다음 작업 보여줘"
+"모바일 개발을 위한 새 태그 만들어줘"
+"모든 태그와 진행 상황 보여줘"
+```
+
+### Git Worktree를 이용한 병렬 개발
+
+```bash
+# 병렬 개발을 위한 워크트리 생성
+git worktree add ../project-api feature/api
+git worktree add ../project-components feature/components
+
+# 각 워크트리에서 다른 태그로 Claude Code 실행
+cd ../project-api && claude    # 터미널 1: API 작업
+cd ../project-components && claude     # 터미널 2: 컴포넌트 작업
+```
+
+### 문제 해결
+
+```bash
+# 현재 태그 확인
+"나 지금 무슨 태그 쓰고 있어?"
+
+# 작업 파일 동기화 문제 해결
+"작업 파일 다시 생성해줘"
+
+# AI 모델 설정
+task-master models --setup
+```
+
+## 주요 파일 및 프로젝트 구조
+
+### 핵심 파일
+
+- `.taskmaster/tasks/tasks.json` - 태그 기반 작업 데이터베이스 (자동 관리)
+- `.taskmaster/state.json` - 현재 태그 컨텍스트
+- `.taskmaster/config.json` - AI 모델 설정
+- `.taskmaster/docs/prd-<tag>.md` - 태그별 제품 요구사항 명세서 (PRD)
+- `.taskmaster/tasks/*.md` - 개별 작업 파일 (자동 생성)
+
+### Claude Code 연동 파일
+
+- `CLAUDE.md` - Claude Code를 위한 자동 로드 컨텍스트
+- `.claude/settings.json` - Claude Code 도구 허용 목록 및 환경설정
+- `.claude/commands/` - 반복적인 워크플로를 위한 사용자 정의 슬래시 명령어
+- `.mcp.json` - MCP 서버 설정
+
+### 디렉토리 구조
+
+```
+project/
+├── .taskmaster/
+│   ├── tasks/              # 태그 기반 작업 파일
+│   │   ├── tasks.json      # 작업 데이터베이스
+│   │   ├── task-1.md       # 개별 작업
+│   │   └── task-2.md
+│   ├── docs/               # 문서
+│   │   ├── app-design-document.md
+│   │   ├── tech-stack.md
+│   │   └── prd-<tag>.md
+│   ├── reports/            # 분석 보고서
+│   ├── templates/          # PRD 템플릿
+│   ├── state.json          # 현재 태그 컨텍스트
+│   └── config.json         # AI 모델 설정
+├── .claude/
+│   ├── settings.json       # Claude Code 설정
+│   └── commands/           # 사용자 정의 명령어
+├── .cursor/                # Cursor IDE 규칙
+│   └── rules/              # 코딩 표준
+├── .mcp.json               # MCP 설정
+└── CLAUDE.md               # 프로젝트 컨텍스트
+```
+
+## 라이선스
+
+MIT