콘텐츠로 이동
Newsfork Docs

AI-Native Cursor & Git Development SOP

Project Folder Architecture

섹션 제목: “Project Folder Architecture”
├── .cursor/              # Cursor 프로젝트 설정
├── .cursorrules          # AI 아키텍처 헌법
├── src/                  # 통합된 안정 코드 (CI 통과 상태)
├── staging/              # 배포 후보 (Release Candidate)
├── tests/                # src와 1:1 대응 검증
├── scripts/              # 승격, 마이그레이션, 배포
└── playground/           # AI 실험 격리 구역 (Quarantine)
계층의미
playgroundAI가 자유롭게 실험하는 위험 구역
src통합된 안정 코드
staging실제 배포 전 최종 검증 구역

Naming Rules

섹션 제목: “Naming Rules”
  • 실험 코드: playground/YYYYMMDD-feature-name/
  • 테스트: *.test.ts, *.spec.ts
  • 브랜치: feat/*, fix/*, refactor/*, release/*

AI-Native Development Flow

섹션 제목: “AI-Native Development Flow”

Phase 1 — Experiment (playground)

섹션 제목: “Phase 1 — Experiment (playground)”
  • 모든 신규 로직은 playground/ 에서만 작성
  • Cursor Composer는 해당 폴더 범위 내에서만 작동

Phase 2 — Promote to src

섹션 제목: “Phase 2 — Promote to src”
  • 실험이 검증되면 승격(Promotion) 스크립트로 src로 이동
  • CI(단위·통합 테스트) 통과 필수

Phase 3 — Staging & Release

섹션 제목: “Phase 3 — Staging & Release”
  • staging에서 QA·성능·법무 검증
  • AI 접근 금지 — 인간만 배포 승인
섹션 제목: “Related Documents”