ai-rules handbook Project Kickoff Checklist

Project Kickoff Checklist

### 1.1 엔티티 명명

checklist docs/checklist/project-kickoff.md

planner 에이전트가 새 프로젝트 시작 시 참조하는 체크리스트. 코딩 시작 전에 아래 항목을 모두 확인/결정해야 한다.

1. 도메인 설계

1.1 엔티티 명명

  • 핵심 엔티티명 확정 (단수형 영어: Prompt, User, Category)
  • DB 테이블명 = snake_case 복수형 (prompts, users)
  • URL 경로명 = kebab-case 복수형 (/prompts, /categories)
  • 약어 사용 시 용어집에 등록

1.2 데이터 모델

  • "누가 했는지" 추적 필요한 행위 식별 → 이벤트 테이블 설계
  • 1:N / N:M 관계 명확히 정의
  • 소프트 삭제 전략 결정 (deleted_at vs 물리 삭제)
  • 감사 컬럼 정의 (created_at, updated_at, created_by)
  • PK 전략 결정 (UUID vs auto-increment)

1.3 렌더링 전략

  • SEO 필요 페이지 → SSR/SSG
  • SEO 불필요 페이지 → CSR
  • 주요 페이지별 렌더링 방식 명시

1.4 리텐션 루프

  • 사용자가 재방문하는 이유 1가지 이상 명시
  • 핵심 지표(North Star Metric) 정의

2. 기술 설계

2.1 환경 호환성 매트릭스

  • OS (Windows/Mac/Linux) 호환 확인
  • Python/Node.js 버전 명시 + 라이브러리 호환성 확인
  • DB 버전 명시
  • Docker 이미지 버전 고정

2.2 동시성 시나리오

  • 동시 쓰기 가능 리소스 식별 (좋아요, 조회수, 재고 등)
  • 중복 방지 전략 (UNIQUE 제약, idempotency key 등)
  • 락 전략 결정 (필요 시)

2.3 ERD

  • MVP 범위 전체 엔티티 관계도 (텍스트 또는 Mermaid)
  • FK + 인덱스 설계 포함

2.4 API 전체 목록

  • 모든 엔드포인트: Method + Path + Auth + response_model
  • 공개 / 인증 필수 / Admin 전용 분류
  • 버전 전략 결정 (v1/ prefix 등)

3. 인프라 & 보안

3.1 환경 구성

  • .env 변수 목록 확정 (.env.example 작성)
  • 개발/스테이징/프로덕션 환경 차이 정의

3.2 초기 보안

  • Rate limiting 정책 (분당 요청 수)
  • Request body 크기 제한
  • CORS 허용 도메인

완료 기준

  • 1.1~2.4 모든 항목에 결정 또는 "이번 Phase에서 불필요" 명시
  • 결과를 INTENT.md "제약 조건" 섹션에 반영
  • 사용자 승인 완료