Cursor Rules Newsfork Overview
Overview
섹션 제목: “Overview”Newsfork는 CONTRACT-FIRST 아키텍처를 따른다.
- JSON + Zod는 유일한 진실의 근원(Single Source of Truth)이다.
- GitHub는 정책과 범위의 이력을 보존하는 SSOT이다.
- Runtime(Hono + Cloudflare Workers) 는 계약을 _실행_할 뿐, 해석하거나 보완하지 않는다.
런타임 로직이 복잡해진다면, 그것은 코드 문제가 아니라 계약(Contract) 설계 오류다.
Core Philosophy (Non-Negotiable)
섹션 제목: “Core Philosophy (Non-Negotiable)”- Seed는 데이터가 아니다. 계약(Contract) 이다.
- JSON은 의도(Intent) 를 정의하고, 코드는 이를 실행한다.
- Git history는 곧 정책·범위 변경 이력이다.
- Deterministic > Clever
- Explicit > Implicit
⚠️ 모호함이 발생하면, 코드를 생성하지 말고 질문하라.
Official Tech Stack (DO NOT DEVIATE)
섹션 제목: “Official Tech Stack (DO NOT DEVIATE)”Infrastructure (Cloudflare-native)
섹션 제목: “Infrastructure (Cloudflare-native)”- Cloudflare Workers, D1, R2, KV, Queues, Logpush
- Wrangler (Local & Deploy)
Application Stack
섹션 제목: “Application Stack”- TypeScript (ES2022+), Hono, Zod, Drizzle ORM
Tooling
섹션 제목: “Tooling”- GitHub (SSOT), GitHub Actions (CI/CD)
절대 금지
섹션 제목: “절대 금지”- Express / Fastify / Nest
- Drizzle 외 ORM
- Zod 없는 검증
- Stateful 서버
- Cloudflare 외 인프라 프리미티브
Key Rules Summary
섹션 제목: “Key Rules Summary”| 영역 | 핵심 규칙 |
|---|---|
| Contract & Schema | 모든 외부 입력 Zod 검증, Schema = 법, Breaking Change 시 Major Version |
| JSON | 런타임 상태/타임스탬프 금지, 배열 기반·평탄한 구조 |
| Runtime | Stateless, Idempotent, Deterministic |
| Database | D1 = 실행 상태만, 미검증 JSON 저장 금지 |
| Error Handling | Fail Fast, Fail Loud, Fail With Context |
| Code Generation | Boring, Explicit, Testable, Type-safe |
| Performance | 선형 알고리즘, Append-only 상태 |
Final Rule
섹션 제목: “Final Rule”Contracts should be boring. Runtimes should be thin. Boring systems survive. Clever systems break.
Related Documents
섹션 제목: “Related Documents”- Cursor Rules Standard — 규칙 업그레이드 가이드
.cursor/rules/— 실제 규칙 파일 (프로젝트 루트)