AI에게 무엇을 줄지
설계하는 법

## CRITICAL — 반드시 지킬 것 - NEVER commit secrets (API 키, .env 내용물) - NEVER run `git push --force` on main branch - ALWAYS read PRD.md before adding new feature - ALWAYS respond in Korean - ALWAYS show plan before writing code (Karpathy 1원칙)

# 뉴스레터 자동화 서비스 — 에이전트 지침서 ## 프로젝트 매일 오전 8시 AI가 IT/비즈니스 뉴스를 수집·요약해서 구독자에게 이메일로 자동 발송. 월 9,900원 구독. 1인 창업가가 운영. 비개발자. ## 기술 스택 - Frontend: Next.js 15 (App Router) + Tailwind - Backend: Supabase (Auth + DB + Edge Functions) - 자동화: n8n (cron 발송) · 별도 권한, 수정 금지 - AI: Claude API (claude-sonnet-4) - 결제: Stripe Checkout - 이메일: SendGrid - 배포: Vercel ## CRITICAL — 반드시 지킬 것 - NEVER commit .env, .env.local 파일 - NEVER 카카오 API 작업 (Stage 7에서 추가) - NEVER n8n 워크플로우 직접 수정 - NEVER npm install 을 자동 실행 (확인 후 진행) - ALWAYS 한국어로 응답 - ALWAYS Karpathy 4원칙 (계획 → 단순 → 최소 수정 → 목표 역산) - ALWAYS 코드 작성 전 plan 보여주기 ## 코딩 규칙 - TypeScript 사용 (any 금지) - Server Component 우선, Client는 정말 필요할 때 - 환경변수: process.env.* (KAKAO_KEY, SENDGRID_KEY 등) - 에러는 try/catch + 한국어 로그 - 함수명: camelCase, 파일명: kebab-case ## 자주 쓰는 명령 - 개발: pnpm dev - 빌드: pnpm build - 타입체크: pnpm typecheck - DB 마이그레이션: pnpm db:push ## 문서 참조 - 제품 요구사항: docs/PRD.md - 기술 구조: docs/ARCHITECTURE.md - DB 스키마: docs/SCHEMA.md - API 명세: docs/API.md - 디자인 가이드: docs/UI_GUIDE.md - 결정 기록: docs/ADR.md ## 작업 흐름 1. 새 기능 요청 → PRD.md 해당 섹션 먼저 읽기 2. 영향받을 파일 목록 + 변경 계획 보여주기 3. 사용자 승인 후 구현 4. 완료 후 ADR.md에 결정 사항 1줄 추가 ## 실전 교훈 (실제 망가졌던 것) - 2026-04-12: send-email 무한 재시도로 SendGrid 일일 한도 초과 → 재시도 ALWAYS 3회 제한 (exponential backoff) - 2026-04-20: 구독 취소 후에도 발송됨 → 발송 직전 ALWAYS subscriber.status === 'active' 검증 - 2026-04-28: claude-3 모델로 짠 코드를 sonnet-4로 안 바꿈 → 모델 ALWAYS claude-sonnet-4-20250514 사용

{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [{ "type": "command", "command": "./hooks/block-dangerous.sh", // rm -rf, git push --force, .env 수정 차단 }] }, { "matcher": "Edit|Write", "hooks": [{ "type": "command", "command": "./hooks/protect-env.sh", // .env, .env.local 수정 시 사용자 확인 }] } ], "Stop": [{ "hooks": [{ "type": "command", "command": "pnpm typecheck && pnpm lint && pnpm build", // 실패하면 AI가 다시 일하게 만듦 }] }] }, "permissions": { "allow": ["Bash(pnpm:*)", "Bash(git:*)", "Read", "Edit", "Write"], "deny": ["Bash(rm -rf:*)", "Bash(git push --force:*)"] } }