sodalive-ios/docs/20260225_AGENTS가이드보강.md

20260225 AGENTS 가이드 보강

작업 목표

• 저장소 실행/검증 명령을 근거 기반으로 정리한다.
• 코드 스타일 가이드를 실제 코드 관례 기반으로 정리한다.
• Cursor/Copilot 규칙 파일 존재 시 AGENTS.md에 반영한다.

체크리스트

• 저장소 빌드/린트/테스트 명령 근거 수집
• 단일 테스트 실행 명령(가능한 범위) 정리
• 코드 스타일 관례(임포트/포맷/타입/네이밍/에러처리) 추출
• Cursor/Copilot 규칙 파일 반영
• AGENTS.md를 약 150줄 내외로 보강
• 검증 로그 추가

검증 기록

• 2026-02-25: 작업 시작. 근거 파일 탐색 진행 중.
• 2026-02-25:
  • 무엇: 빌드/테스트/의존성 명령 근거를 확인했다.
  • 왜: AGENTS.md에 실행 가능한 공식 명령만 기재하기 위해서다.
  • 어떻게:
    • xcodebuild -workspace "SodaLive.xcworkspace" -list
    • read Podfile
    • read SodaLive.xcodeproj/xcshareddata/xcschemes/SodaLive.xcscheme
    • read SodaLive.xcodeproj/xcshareddata/xcschemes/SodaLive-dev.xcscheme
    • grep project.pbxproj "PBXNativeTarget|Tests|SWIFT_VERSION|IPHONEOS_DEPLOYMENT_TARGET"
  • 결과: 스킴 SodaLive, SodaLive-dev를 확인했고, 테스트 번들 타깃 부재로 단일 테스트 실행은 제한될 수 있음을 문서화했다.
• 2026-02-25:
  • 무엇: 코드 스타일 규칙(임포트/아키텍처/타입/네이밍/에러처리/로깅/비동기)을 추출했다.
  • 왜: 에이전트가 기존 관례를 깨지 않고 수정하도록 하기 위해서다.
  • 어떻게:
    • read SodaLive/Sources/User/UserApi.swift
    • read SodaLive/Sources/User/UserRepository.swift
    • read SodaLive/Sources/User/Login/LoginViewModel.swift
    • read SodaLive/Sources/Extensions/MoyaProviderExtension.swift
    • read SodaLive/Sources/Utils/Log.swift
    • ast_grep_search "do { $$$ } catch { $$$ }"
  • 결과: View -> ViewModel -> Repository -> Api 레이어와 DEBUG_LOG/ERROR_LOG, sink + .store(in:) 패턴을 AGENTS.md에 반영했다.
• 2026-02-25:
  • 무엇: Cursor/Copilot 규칙 파일 존재 여부를 점검했다.
  • 왜: 요청사항(룰 파일 반영)을 누락 없이 처리하기 위해서다.
  • 어떻게:
    • glob .cursor/rules/**/*
    • glob .cursorrules
    • glob .github/copilot-instructions.md
  • 결과: 현재 저장소에는 해당 파일이 없어, AGENTS.md에 "미존재/추후 동기화" 정책을 기재했다.
• 2026-02-25:
  • 무엇: AGENTS.md 최종 라인 수와 섹션 충족 여부를 확인했다.
  • 왜: 요청 조건(약 150줄, 빈 섹션 채우기) 충족 검증을 위해서다.
  • 어떻게:
    • read AGENTS.md
    • wc -l AGENTS.md
  • 결과: 총 160줄로 확인되었고, 기존 빈 섹션(저장소 범위/코드 스타일)을 포함해 전 섹션을 채웠다.