AI 도서관 · Claude · 하네스 설정 · CLAUDE.md

웹 개발용 CLAUDE.md 템플릿

FastAPI + Next.js + PostgreSQL 같은 풀스택 웹 프로젝트에 최적화된 템플릿이에요

내용

# 프로젝트 개요
{{INPUT}}

# 기술 스택
- Backend: FastAPI (Python 3.11+)
- Frontend: Next.js 14 (App Router)
- DB: PostgreSQL + SQLAlchemy ORM
- 인증: JWT (python-jose)

# 폴더 구조 규칙
backend/
  api/routes/    ← 라우터 파일만
  api/models/    ← DB 모델
  api/schemas/   ← Pydantic 스키마
frontend/
  app/           ← 페이지 (App Router)
  components/    ← 재사용 컴포넌트

# 절대 금지
- .env 파일 수정 금지 (변수 추가는 .env.example에만)
- DB 마이그레이션 없이 모델 변경 금지
- `npm run build` 오류 상태로 커밋 금지

# API 작성 규칙
- 모든 응답은 {success, data, message} 구조 사용
- HTTP 상태코드 반드시 명시
- 라우터 함수에 docstring 필수

# 작업 전 체크
1. 백엔드 변경 시 → pytest 실행 확인
2. 프론트 변경 시 → TypeScript 에러 0개 확인
3. DB 변경 시 → alembic revision 생성 필수

{{INPUT}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.

근거

유형
설정 가이드 — 지정된 파일이나 설정에 적용합니다
사용 환경
프로젝트 루트의 CLAUDE.md 또는 .claude/CLAUDE.md
주의
200줄이 넘어가면 파일 종류별로 .claude/rules/ 로 쪼개는 편이 낫습니다.
공식 출처
https://code.claude.com/docs/en/memory
확인일
2026-09-08 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기