00-project-context

Instruction file imported from lahomsystem/FOMS (.cursor/rules/00-project-context.mdc). Copyright stays with the author.

FOMS 프로젝트 컨텍스트 (Cursor 보강 — 공통 정책 정본은 루트 AGENTS.md)

공통 정책(문제 수정·성능 가드·git 브랜치/승격 절차·프로젝트 개요)은 루트 AGENTS.md가 SSOT다. 본 파일은 Cursor 전용 보강만 담는다. 충돌 시 AGENTS.md 우선.

새 세션 시작 시 + 작업 프로토콜 (RPI — 필수 준수)

1. docs/AI_STATUS.md 상단 40줄 읽기 → 전체 상황 파악
2. 핵심 코어 변경(DB/Auth/API, 배포 인프라, 하네스 인프라) → RPI 필수:
   • Research: docs/harness/policy/DECISIONS.md + docs/ARCHIVE_INDEX.md 조사
   • Plan: docs/guides/SPEC_TEMPLATE.md 기반 Spec 작성 → 사용자 승인 대기
   • Implement: 승인 후 코딩 → /verify-result → /auto-status-update 실행
3. 단순 UI 변경/타이포 → 바로 코딩 허용
4. 대화가 길어지면 → 핵심 요약 후 새 세션 권유 (Dumb Zone 회피)

Cursor 내 Runner 라우팅

• Cursor 기본 에이전트: AGENTS.md + 본 .mdc 규칙 기준 (Cursor가 .mdc를 네이티브 로드).
• Claude 확장 in Cursor: AGENTS.md + CLAUDE.md. Codex: AGENTS.md 기준, 세컨드 오피니언은 on-demand gstack-codex 스킬.
• 브라우저 역할: Cursor browser MCP=탐색·수동 재현·디버깅, gstack browse=반복 가능한 smoke/QA 자동화.
• 온디맨드 컨텍스트 번들: python tools/harness/build_context_bundle.py --all (상시 커밋 번들은 2026-07-08 폐기).
• 세션 worktree 격리 (선택 표준): 동시 2+창 코드 편집 시 python tools/harness/session_worktree.py create → c:/tmp/foms-s-* 폴더 열어 작업, push는 git push origin HEAD:deploy, 종료 시 cleanup --remove. 단일 창·핫파일 작업은 공유 트리 유지. 상세: AGENTS.md §브랜치·푸시.

작업 완료 시 (자동)

• Cursor: Hook(session_stop)이 자동으로 AI_STATUS.md + AI_CHANGELOG.md 갱신
• 수동: /auto-status-update 워크플로우 실행

디렉토리 구조 핵심

• app.py: Flask 앱 초기화(최소화, 라우트 추가 금지 — 새 라우트는 foms/api/(JSON·API·webhook)·foms/web/(HTML 페이지) Blueprint, 등록 정본은 foms/platform/blueprints.py)
• foms/services/: 비즈니스 로직·정책 엔진, templates/: HTML, static/: JS·CSS
• models.py: DB 모델 / 상수는 도메인 모듈 옆(예 foms/services/orders/erp_policy_constants.py) — 루트 단일 상수 모듈은 없다