Skip to content

Add comprehensive CLAUDE.md for AI assistants#1

Draft
ssap-pa wants to merge 1 commit into
mainfrom
claude/claude-md-docs-qoapsn
Draft

Add comprehensive CLAUDE.md for AI assistants#1
ssap-pa wants to merge 1 commit into
mainfrom
claude/claude-md-docs-qoapsn

Conversation

@ssap-pa

@ssap-pa ssap-pa commented Jun 9, 2026

Copy link
Copy Markdown
Owner

개요

이 저장소에서 작업하는 Claude Code 및 기타 AI 어시스턴트를 위한 CLAUDE.md를 추가했습니다. 전체 소스(src/), 마이그레이션, 설정 파일을 분석하여 작성했습니다.

포함 내용

  • 프로젝트 개요: Hono + Cloudflare Pages + D1 기반 AI 롤플레이 채팅 서비스
  • 기술 스택 / 의존성 제약: Workers 호환성(Web Crypto, hono/jose만 사용) 강조
  • 디렉터리 구조 & 라우트 등록: app.route() prefix 매핑 정리
  • 인증 모델: 게스트/회원/관리자 JWT, PBKDF2 비밀번호
  • D1 데이터 모델: 싱글톤 character_config, JSON 컬럼 처리 규칙
  • 코드 컨벤션: 한국어 메시지, 박스 주석, lib/db.ts 집중, LLM 분기 패턴
  • 개발 워크플로 & 마이그레이션 추가 절차
  • 환경변수 표 (LLM 키는 DB 저장이라는 점 포함)
  • 함정 정리: D1 이름 불일치(webapp-production vs ai-character-chat-production), 인라인 프론트엔드, README와의 차이(DomoAI 중단), 이미지 D1 Base64 저장 등

참고

기존 CLAUDE.md는 없었으므로 신규 생성입니다. 코드 변경은 없고 문서만 추가합니다.

https://claude.ai/code/session_01GfBMPFaTPvLMGAUzJyretd


Generated by Claude Code

코드베이스 구조, 인증 모델, D1 데이터 모델, 개발 워크플로,
코드 컨벤션, 함정(D1 이름 불일치·인라인 프론트엔드 등)을 정리한
CLAUDE.md 추가.

https://claude.ai/code/session_01GfBMPFaTPvLMGAUzJyretd
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants