Files
Colosseum/RESTRUCTURE_CHECKLIST.md
dal4segno c265f980db chore: Assets 디렉토리 구조 정리 및 네이밍 컨벤션 적용
- Assets/_Game/ 하위로 게임 에셋 통합
- External/ 패키지 벤더별 분류 (Synty, Animations, UI)
- 에셋 네이밍 컨벤션 확립 및 적용
  (Data_Skill_, Data_SkillEffect_, Prefab_, Anim_, Model_, BT_ 등)
- pre-commit hook으로 네이밍 컨벤션 자동 검사 추가
- RESTRUCTURE_CHECKLIST.md 작성

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-16 19:08:27 +09:00

2.6 KiB

Assets 디렉토리 구조 정리 체크리스트

주의: 모든 에셋 이동/이름 변경은 반드시 Unity Editor의 Project 창에서 진행할 것. 파일 탐색기로 작업하면 .meta 참조가 깨짐.


네이밍 컨벤션

기본 형식: {타입}_{대상}_{이름}

위치 Prefix 형식 예시
Data/Skills/ Data_Skill_ Data_Skill_{대상}_{이름} Data_Skill_Player_근접베기
Data/Skills/Effects/ Data_SkillEffect_ Data_SkillEffect_{대상}_{스킬명}_{순서}_{효과} Data_SkillEffect_Player_베기_0_데미지
Data/Abnormalities/ Data_Abnormality_ Data_Abnormality_{대상}_{이름} Data_Abnormality_Test_버프
Data/Weapons/ Data_Weapon_ Data_Weapon_{이름} Data_Weapon_검
Data/Enemies/ Data_Enemy_ Data_Enemy_{이름} Data_Enemy_TestBoss
Data/Patterns/ Data_Pattern_ Data_Pattern_{대상}_{이름} Data_Pattern_TestBoss_우수2연타
Prefabs/ (non-UI) Prefab_ Prefab_{대상}_{이름} Prefab_Player_Default
Prefabs/UI/ UI_ UI_{이름} UI_BossHealthBar
Animations/Controllers/ AC_ AC_{대상}_{이름} AC_Player_Default
Animations/ (클립) Anim_ Anim_{대상}_{이름} Anim_Player_베기
Models/ Model_ Model_{대상}_{이름} Model_Player_Base
AI/ BT_ BT_{이름} BT_TestBoss

대상 후보: Player, Boss, Enemy, Common, TestBoss 등 구체적 이름도 허용


진행 현황

  • Phase 0. Git 백업
  • Phase 1. 빈 폴더 정리
  • Phase 2. External 패키지 정리
  • Phase 3. _Game/ 구조 생성 및 에셋 이동
  • Phase 4. 에셋 Rename (일부 잔여)
  • Phase 4-잔여. UI 미수정 항목
  • Phase 5. Scripts 정리
  • Phase 6. 검증 및 마무리

Phase 4-잔여. UI Rename (Unity Editor)

  • UI_BarUI_StatBar
  • UI_GameOver OverlayUI_GameOver (공백 제거)

Phase 5. Scripts 정리 (Unity Editor)

5-1. Core/ 폴더 생성 및 공통 파일 이동

Assets/_Game/Scripts/Core/ 생성:

  • Scripts/Enemy/IDamageable.csScripts/Core/IDamageable.cs
  • Scripts/Team.csScripts/Core/Team.cs
  • Scripts/GameManager.csScripts/Core/GameManager.cs

Phase 6. 검증 및 마무리

  • Console 창 — Missing Reference 에러 없는지 확인
  • Play Mode 진입 후 기본 동작 확인
  • .gitignoreAssets/DownloadCache/ 추가
  • Git commit (chore: rename assets and restructure)