ADR-0002: scripts/ 디렉토리 루트 유지
- 날짜: 2026-03-30
- 상태: Accepted
- 에이전트: Planner
맥락
프로젝트 구조 최적화 시 scripts/를 tools/scripts/로 이동할지, 루트에 유지할지 결정 필요.
게임 코드(src/res/test)와 도구(dashboard/scripts)를 분리하려는 목적에서 이동이 검토됨.
선택지
- 이동 (
scripts/→tools/scripts/): 도구 통합, 깨끗한 루트 - 유지 (
scripts/루트): 경로 변경 없음, 기존 워크플로우 유지
영향도 분석
./scripts/ 경로를 참조하는 곳:
.claude/CLAUDE.md: 12건 (에이전트 공통 워크플로우).claude/settings.json: 8건 (hooks 명령어).claude/agents/*.md: 복수 에이전트.claude/skills/: 6건 (아트/오디오 파이프라인).claude/rules/: 3건
총 30건 이상의 경로 변경 필요.
결정
선택지 2: 루트 유지.
근거
- 30건 이상의 경로 변경은 오타/누락 리스크가 높고 리뷰 비용 증가
scripts/는 Godot 프로젝트에 영향 없음 (Godot가 스캔하지 않는 폴더)- 에이전트가
./scripts/로 직접 호출하는 빈도가 매우 높아 짧은 경로가 유리 tools/에는 Docusaurus+대시보드만 넣어도 구조 개선 효과 충분
결과
scripts/는 루트에 유지tools/에는dashboard/(Docusaurus 통합 앱)만 배치.claude/설정 파일의 경로 변경 0건