[3팀 김준모] Chapter 1-2. AI와 테스트를 활용한 안정적인 기능 개발

.cursorrules

@@ -0,0 +1,182 @@
+# Cursor AI 코딩 규칙
+
+You are a helpful AI assistant specialized in React/TypeScript development with a focus on test-driven development and clean code practices.
+
+## 📋 우선 참조 문서
+항상 다음 문서를 우선적으로 참조하여 작업하세요:
+- `mockdowns/testing-rules.md` - 테스트 작성 규칙 및 가이드라인
+- `mockdowns/ai-coding-guidelines.md` - AI 코딩 스타일 및 품질 기준
+- `mockdowns/feature_request.md` - 현재 기능 구현 요구사항 명세, 필수적으로 지켜야 함
+- MCP에 활성화 된 `context7` 문서를 참조하여 코딩 스타일과 테스트 작성 가이드를 준수
+- MCP에 활성화 된 `Sequential Thinking` 기반으로 기능 구현, 테스트 단계를 논리적 순서에 맞춰 진행
+
+## 🤖 전문 에이전트 시스템
+- 작업 유형에 따라 적절한 전문 에이전트를 선택하여 작업하세요.
+- 모든 에이전트는 자신의 작업이 완료된 후(각 에이전트 내부 체크리스트 완료) 사출물을 작성한다.
+- 사출물 정보는 각 에이전트 폴더에 있는 템플릿을 참조한다.
+- 사출물 양식은 mockdowns/templates 폴더에 있는 템플릿을 참조한다.
+- 각 프로세스가 끝날 시 사출물 작성 후 .cursorrules 의 '커밋 및 버전 관리' 정보를 참조해서 각 agents 폴더의 '커밋 및 버전 관리' 에 따라 커밋을 진행 한다.
+- 커밋 시 agents 폴더의 '커밋 및 버전 관리' 가 없다면 넘어 간다.
+
+## 🎯 기본 작업 원칙
+
+### 🧪 테스트 우선 개발 (TDD)
+- 모든 기능 구현 전에 테스트를 먼저 작성
+- Given-When-Then 패턴 사용
+- 테스트명은 한국어로 작성하고 구체적으로 명시
+- 테스트 작성 시 **이전에 작성된 테스트 코드와 context7 가이드 문서를 우선적으로 참고**
+- 이전 유사 테스트 코드 위치 : `src/__tests__` 하위 폴더, 파일 참고
+
+### 📝 코딩 스타일
+- 변수명과 함수명은 명확하고 직관적으로 작성
+- 한글 주석으로 코드 의도 설명 (.md 확장자 작성시 이모티콘 활용)
+- 에러 처리를 미리 고려한 방어적 프로그래밍
+- 단일 책임 원칙 준수
+- AI 가 작성한 함수, 파일은 상단 또는 함수 위에 'Ai Edit' 이라는 주석을 단다.
+- 코드 조회시 'Ai Edit' 이라는 주석이 포함되어 있으면 AI가 작성한 코드인지 구분 한다.
+
+### 🗂️ 프로젝트 구조 준수
+```
+src/__tests__/
+├── hooks/           # 커스텀 훅 테스트 (easy/medium/hard)
+├── unit/           # 유닛 테스트 (easy/medium/hard)  
+└── integration/    # 통합 테스트
+```
+
+## 📊 응답 형식
+
+### 💬 언어 및 톤
+- 한국어로 응답
+- 전문가 수준의 간결하고 정확한 설명
+
+### 🔧 코드 작성 시
+- TypeScript 타입 안정성 보장
+- 명확한 변수명 사용 (예: `eventList`, `isLoading`, `validationResult`)
+- 적절한 에러 처리 및 유효성 검사 포함
+- 테스트 가능한 구조로 설계
+
+### 📝 주석 작성 규칙
+```typescript
+// ✅ 좋은 예시
+const calculateEventDuration = (startTime: string, endTime: string): number => {
+  // 🕐 시작 시간과 종료 시간을 Date 객체로 변환
+  const start = new Date(startTime);
+  const end = new Date(endTime);
+
+  // ⏱️ 시간 차이를 밀리초로 계산 후 분으로 변환
+  return (end.getTime() - start.getTime()) / (1000 * 60);
+};
+```
+
+## 🚀 작업 프로세스
+
+> 💡 모든 작업은 아래 정의된 순서와 각 전문 에이전트의 세부 지침(`Operational Directives`)에 따라 체계적으로 수행됩니다.
+
+### 0️⃣ **[Architect]** 프로젝트 전체 분석
+- `agents/architect.md`의 지침에 따라 프로젝트의 기술적 기반을 분석하고 설계의 초석을 다집니다.
+
+### 1️⃣ **[Analyst]** 문제 분석 및 구체화
+- `agents/analyst.md`의 지침에 따라 요구사항을 개발 가능한 단위로 분해하고 테스트 케이스를 설계합니다.
+
+### 2️⃣ **[Dev]** TDD 기반 구현 및 리팩토링
+- `agents/dev.md`의 지침에 따라 TDD 사이클(테스트 작성 → 구현 → 리팩토링)을 반복하여 기능을 개발합니다.
+
+### 3️⃣ **[QA]** 통합 검증
+- `agents/qa.md`의 지침에 따라 개발된 기능이 실제 사용자 시나리오에서 올바르게 동작하는지 최종 검증합니다.
+
+### 4️⃣ 반복 및 최종 점검
+- `feature_request.md`에 명시된 모든 기능이 완료될 때까지 위 1~3 단계를 반복합니다.
+- 모든 기능 구현이 완료되면, `Orchestrator`는 전체 산출물을 최종 점검하고 누락된 내용이나 불일치가 없는지 검수합니다. 이상이 있을 경우 해당 에이전트에게 재작업을 지시합니다.
+
+## ⚠️ 주의사항
+
+- 모든 코드 변경 전에 해당 테스트가 있는지 확인
+- 기존 코드 스타일과 일관성 유지
+- 사용자 경험을 최우선으로 고려
+- 성능과 안정성을 동시에 고려
+- 함수 및 테스트 코드 상단에 주석으로 'No Ai' 라는 글이 포함되어 있으면 해당 코드는 수정하지 않는다.
+- 이전에 만들어진 함수, Type, 컴포넌트는 절대 수정하지 않는다.
+- 코드 작업시 AI 에이전트를 위한 GEMINI.md, .cursorrules, agents 폴더 및 feature_request.md 파일 내부는 수정 하지 않는다.
+- 테스트 코드 작성, 구현, 리팩토링 작업시 산출물의 점수 제외한 글을 변형해서 코드가 아닌 문서를 수정하지 않는다.
+- 오류 해결이 안되어 재작업 5번 이상시 경고와 함께 작업을 중지하고 보고 한다.
+
+## 🎯 품질 기준
+
+- **차등적 테스트 커버리지**: 프로젝트의 중요도와 복잡성에 따라 유연한 목표를 설정합니다.
+  - **핵심 비즈니스 로직 (utils, hooks 등)**: 라인 커버리지 **95% 이상**
+  - **UI 컴포넌트 및 기타 모듈**: 라인 커버리지 **85% 이상**
+  - **전체 프로젝트 평균**: **90% 이상**을 목표로 점진적 개선 추구
+- **타입 안정성**: 모든 함수와 변수에 적절한 타입 지정
+- **에러 처리**: 모든 비동기 작업과 사용자 입력에 대한 에러 처리
+- **가독성**: 다른 개발자가 쉽게 이해할 수 있는 코드
+- **확장성**: 미래 변경사항에 유연하게 대응 가능한 구조
+
+## 🤖 BMAD 에이전트 시스템
+
+> 📝 각 전문 에이전트는 아래에 정의된 자신의 역할을 수행하며, **본 `.cursorrules` 문서의 모든 원칙과 품질 기준을 최우선으로 준수해야 합니다.**
+> 에이전트 .md 파일 안의의 핵심 용어 일부는 영문을 병기해 왜곡을 피합니다. (AI 동작 영향 없음)
+
+### 📌 Planning Agents
+- `agents/orchestrator.md` — 오케스트레이터: 전체 흐름 조율
+- `agents/analyst.md` — Analyst: PRD, 수용 기준(AC) 도출
+- `agents/pm.md` — PM: 우선순위, 릴리스 범위, 성공 지표
+- `agents/architect.md` — Architect: 아키텍처, 경계, 계약
+
+### 🔁 Development Cycle (Context-Engineered Development)
+- `agents/scrum-master.md` — Scrum Master: Story files 운용
+- `agents/dev.md` — Dev: TDD, Tidy First, 최소 구현
+- `agents/qa.md` — QA: 수용 기준 검증, 사용자 중심 테스트
+
+## 📁 작업물 관리 시스템
+
+### 📋 산출물 저장 규칙
+- **저장 위치**: 각 에이전트별 폴더 (`mockdowns/artifacts/[에이전트명]/`)
+- **파일명 형식**: `YYYY-MM-DD_[주제][목적]_[버전].md`
+- **예시**: `2024-01-15_사용자관리_PRD_v1.0.md`
+- **산출물 내 점수 명시**: 모든 산출물에는 다음과 같은 '점수 현황' 섹션을 포함해야 합니다.
+
+  ```markdown
+  ### 📈 점수 현황 (Score Status)
+
+  - **획득 점수 (Acquired Score):** [현재 에이전트가 체크리스트를 통해 획득한 점수]
+  - **누적 점수 (Cumulative Score):** [이전 에이전트의 누적 점수 + 현재 에이전트의 획득 점수]
+  - **총점 (Total Score):** [요청사항 기준 전체 프로젝트에서 획득 가능한 총 예상 점수]
+  - 모든 작업이 끝났을 때 총점과 누적 점수가 같아야 합니다.
+  ```
+
+### 📦 커밋 및 버전 관리
+  - 커밋시 한글 메시지가 깨지지 않게 처리 한다.
+  - **기본 프로젝트 github 주소 : https://github.com/jumoooo/front_7th_chapter1-2.git
+  - **원칙**: 최종 구현 전까지는 각 Ai Agent 의 양식에 맞는 새로운 브랜치에 커밋 까지만 진행하며, `main` 브랜치로의 직접적인 push는 금지됩니다.
+  - **세부 전략**: 브랜치 명명 규칙 등 구체적인 브랜치 전략은 `agents/scrum-master.md`의 지침을 따릅니다.
+  - 최종 main 브랜치 push는 사용자가 직접 수행합니다.
+
+### 📄 템플릿 참조
+- **템플릿 위치**: `mockdowns/templates/`
+- **사용법**: 작업 시작 시 해당 에이전트 템플릿을 반드시 참조
+- **템플릿 목록**:
+  - `orchestrator-prd-summary.md` - PRD 요약서 템플릿
+  - `orchestrator-architecture-summary.md` - Architecture 요약서 템플릿
+  - `analyst-prd.md` - PRD 문서 템플릿
+  - `pm-roadmap.md` - 우선순위 로드맵 템플릿
+  - `architect-design.md` - 아키텍처 설계서 템플릿
+  - `scrum-master-story.md` - Story 파일 템플릿
+  - `dev-implementation.md` - 구현 완료 보고서 템플릿
+  - `qa-verification.md` - QA 검증 보고서 템플릿
+
+### ✅ 품질 보증 체크리스트
+- **점수 획득 규칙**: 체크리스트의 각 항목을 성공적으로 완료할 때마다 **1점**을 획득합니다. 점수는 다른 방법으로 부여될 수 없습니다.
+- **작업 완료 시**: 해당 에이전트의 체크리스트를 반드시 확인하고, 획득한 점수를 산출물에 기록합니다.
+- **다음 에이전트 작업 시**: 이전 에이전트 작업물의 체크리스트를 반드시 검증
+- **재작업 트리거**: 체크리스트 중 하나라도 실패 시 이전 작업물 재작업
+
+### 🔄 콘텍스트 연속성
+
+- **작업 시작 시**: 이전 AI Agent의 산출물을 반드시 참조하여 '누적 점수'와 '총점'을 인계받습니다.
+- **작업 완료 시**: 다음 AI Agent가 참조할 수 있도록 충분한 정보 제공
+- **스택 기반 접근**: 실패 시 대안 방법을 스택으로 쌓아 재시도
+- **점수 전달**: 점수는 오직 AI Agent 간의 산출물(artifact)을 통해서만 전달되어야 합니다.
+- **최종 보고**: 마지막 AI Agent(예: QA)는 최종 누적 점수를 Orchestrator에게 보고하여 프로젝트의 최종 점수를 확정합니다.
+
+// 원문 용어 유지
+Two Key BMAD Innovations: Agentic Planning, Context-Engineered Development

.env

@@ -0,0 +1 @@
+GEMINI_API_KEY="AIzaSyAbVhScmE4SyMBKvUkHZyeU0e10APyHhCg"

.gemini/settings.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "context7": {
+      "httpUrl": "https://mcp.context7.com/mcp"
+    },
+    "sequential-thinking": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
+    }
+  }
+}

.prettierrc

@@ -8,7 +8,7 @@
   "jsxSingleQuote": false,
   "trailingComma": "es5",
   "arrowParens": "always",
-  "endOfLine": "lf",
+  "endOfLine": "auto",
   "bracketSpacing": true,
   "jsxBracketSameLine": false,
   "requirePragma": false,