기획 요청·밸런스 데이터 운영¶
위키 홈의 PLANNER REQUEST LINK는 기획자가 지금 답해야 하는 항목과 구현 완료 안내를 한곳에서 보여 줍니다. 요청은 코드 주석이나 채팅에만 남기지 않고 요청 ID와 공개 Notion 근거를 연결합니다.
상태 태그¶
| 태그 | 의미 | 기획자 행동 |
|---|---|---|
작업 요청 |
규칙·예외·플레이 결과가 미확정 | 같은 요청 ID로 Notion에 확정·보류·수정 근거 작성 |
밸런스 데이터 |
수치·목록·확률·비용 표가 필요 | Notion에 정책 근거를 적고 지정 Google Sheet 탭에 시험값 작성 |
완료 안내 |
코드·데이터·플레이어 인식 E2E까지 통과 | 의도와 다르면 새 요청 ID로 변경 근거 작성 |
역할·상태 계약¶
첫 화면은 기획자 할 일, AI 개발자 할 일, 검증 완료로 필터링합니다. 각 카드는 담당자, 차단 여부, 수락 기준, 검증 근거와 Sheet 대상 범위를 가집니다. Notion은 기획 결정의 원본이고 위키 JSON은 마지막으로 검증한 작업 스냅샷이므로 자동 동기화로 오해하지 않도록 확인 시각을 항상 표시합니다.
상태는 needs_planner → ready_for_dev → in_implementation → implemented_verified → accepted 순서입니다. 구현 완료와 기획 수용 완료를 같은 상태로 취급하지 않습니다.
Notion 작성 계약¶
- 카드의
PLAN-*또는DATA-*요청 ID를 Notion 결정 제목에 그대로 포함합니다. 확정,보류,수정 필요중 하나를 명시하고 정상 흐름과 예외 조건을 함께 적습니다.- 수치가 필요하면 단위, 최소·기본·최대, 등급 또는 난이도별 변화 기준을 적습니다.
- 개발자는 공개 Notion 근거와 저장소 구현을 대조한 뒤 카드 상태를
완료 안내로 바꿉니다.
권위 있는 원문은 게시된 SFH Master GDD입니다.
Google Sheet 상시 확장 허용¶
사용자는 앞으로 모든 구현 작업에서 새로운 아이템·무기·방어구·스킬·드랍·강화·경제 등 열거형 목록이 필요하면 별도 재승인 없이 공용 Google Sheet를 확장할 수 있도록 명시적으로 허용했습니다.
확장 시 다음 규칙은 항상 유지합니다.
- 1행 변수명, 2행 한국어 설명, 3행부터 개별 데이터
- 기존 도메인 탭을 우선 사용하고 책임이 다르면 독립 탭 추가
runtime_enabled로 시험 행과 비활성 행을 구분- 실시간 테스트 공급자와 확정 CSV 공급자가 같은 스키마 사용
- Web payload·Windows 배포 메타데이터·CSV 해시까지 함께 갱신
- 기획 확정 전 값은 요청 카드와 Sheet 설명에서
임시로 명시
목록이 필요하지 않은 로직 변경에는 Sheet를 억지로 확장하지 않습니다.
완료 판정¶
카드를 완료 안내로 바꾸려면 Definition/Policy/Service/Presenter 또는 Provider 경계, 실제 플레이 입력, 플레이어가 보는 결과, E2E와 위키 문서가 모두 연결되어야 합니다. 클래스만 존재하거나 Notion에 문장만 추가된 상태는 완료로 계산하지 않습니다.