# 🚀 InsuWiki Project Initialization Guide (START.md)

이 문서는 프로젝트 작업을 시작할 때 **반드시 확인하고 따라야 하는 절차**를 정의합니다.
시스템이 재시작되거나 새로운 세션이 시작될 때 이 가이드를 먼저 읽어주세요.

---

## 1. 🕵️‍♂️ 에이전트 인식 (Agent Check)
작업 시작 전, `.claude/agents` 폴더의 에이전트 정의를 확인하여 역할을 명확히 하세요.

*   `backend.agent.md`: API, DB, Auth
*   `frontend.agent.md`: UI/UX, Next.js, Components
*   `data.agent.md`: Schema, Search, Models
*   `planner.agent.md`: PRD, Specs
*   `pm.agent.md`: Project Management
*   `qa.agent.md`: Test, Security
*   `legal.agent.md`: Regulations, Terms
*   `ux.agent.md`: User Experience
*   `reflect.agent.md`: Knowledge Management

## 2. ⚙️ 워크플로우 준수 (Workflow Enforcement)
`.agent\workflows` 폴더의 규칙은 **절대적**입니다. 위반 시 즉시 수정해야 합니다.

*   **배포**: `/deploy-workflow` (Git 기반 자동 배포)
*   **개발**: `/dev-workflow` (설계 → 논의 → **사용자 승인** → 구현)
*   **문서**: `/create-doc` (폴더 구조 및 네이밍 규칙 준수)
*   **스크립트**: `/create-script` (파일 헤더 및 네이밍 규칙 준수)
*   **사전 협의**: 업무 시작 전, **반드시 사용자와 진행 방향을 상의**해야 합니다. (독단적 진행 금지)
*   **에이전트 회의**: 복잡한 문제 해결 시, **Agent Meeting**을 통해 역할을 분담하고 전체적인 전략을 수립하세요.
*   **규칙 유지보수**: `docs/rules/implementation-list-rule.md`, `docs/rules/260219-dev-checklist.md` 등 규칙 정의 문서를 **항상 최신 상태로 업데이트**하세요.

> **⚠️ 중요**: "Public 문서 로그인 정책" 등의 중요한 변경 사항은 반드시 `docs/decisions/`에 결정 문서를 남겨야 합니다.

## 3. 🔄 작업 상태 업데이트 (Status Update)
프로젝트 흐름이 끊기지 않도록, 작업 완료 후 항상 현재 상태를 기록하세요.

*   **현재 작업 기록**: `docs/tasks/` 폴더 내의 해당 Task 파일 업데이트 (`[x]`).
*   **전체 진행 상황**: `docs/reports/` 내의 최신 대시보드 파일 참고.
*   **Artifacts**: `task.md`, `implementation_plan.md`, `walkthrough.md` 최신화.

## 4. 🔍 컨텍스트 팔로업 (Follow-up)
작업 재개 시, `docs` 폴더 내 **가장 최근 날짜**의 파일을 확인하여 이전 업무 내용을 파악하세요.

*   `docs/tasks/task{번호}-{YYMMDD}-...`
*   `docs/plans/{YYMMDD}-...`
*   `docs/decisions/{YYMMDD}-...`
*   `docs/meetings/{YYMMDD}-...`

## 5. 📘 사용자 매뉴얼 업데이트 (User Manual)
신규 기능이 추가되거나 기존 기능이 변경되면 **반드시** 사용자 가이드를 업데이트하세요.

*   **대상 파일**: `docs/user-guide/insuwiki-user-manual.md`
*   **기준**: 사용자가 기능을 사용하는 방법에 변화가 있을 때.

---

## 🔔 Reminders (Self-Correction)
작업 중간중간 스스로에게 질문하세요:
1.  이 작업이 유저 승인을 받았는가? (`dev-workflow`)
2.  관련 문서는 생성/업데이트 되었는가? (`create-doc`)
3.  중요한 결정 사항이 기록되었는가? (`decisions`)
4.  테스트와 검증은 완료되었는가? (`qa`)