본문으로 건너뛰기
DispatchAtlas
검색

저장소 위생

DispatchAtlas 의 버전 관리는 손으로 작성된 소스, 테스트, 구성, 문서, 재현 가능한 메타데이터를 담습니다. 로컬 실행 산출물은 정책이 명시적으로 소스로 승격하지 않는 한 Git 바깥에 머뭅니다.

🧹 생성 출력 정책

생성된 실험 데이터, 체크포인트, 결과 번들, 커버리지 리포트, 문서 빌드 출력, 패키지 산출물, 릴리스 후보는 기본적으로 무시됩니다. 후속 게이트가 그것들을 승격할 때 소스에서 재생성되고 출처를 통해 기록됩니다.

추적되는 생성 파일은 다음을 요구합니다:

  • 소스 소유자.
  • 재생성 명령.
  • 보존 근거.
  • 오래된 출력에 대한 검토 경로.

🗃️ 캐시 정책

Python, Ruff, mypy, pytest, 커버리지, 문서 빌드, 가상 환경의 로컬 캐시는 무시됩니다. CI 는 의존성을 캐시할 수 있으나, 캐시 키는 lockfile 과 워크플로 입력에서 유도되어야 합니다.

🔬 로컬 실험 출력 정책

로컬 실험 실행은 실험 작업공간의 무시되는 출력 계층 — 실행 결과, 로그, 체크포인트, 증거 번들, 작업공간 자체의 README 에 배치된 대로 — 에 쓰며, outputs/artifacts/ 같은 다른 무시되는 스크래치 위치와 나란히 있습니다. 최종 연구 증거는 모든 공개 사용 전에 검증된 캠페인 및 분석 명령을 통해 산출됩니다.

📋 산출물 보존 규칙

산출물 클래스기본 위치Git 상태보존
패키지 빌드dist/무시필요 시 재빌드.
문서 빌드site/out/무시필요 시 재빌드.
커버리지htmlcov/, .coverage*무시품질 검사 중 재빌드.
스모크 출력outputs/무시디버깅 시에만 로컬 보관.
캠페인 결과실험 작업공간의 결과 및 체크포인트 계층무시출처-게이트된 내보내기를 통해서만 승격.
릴리스 증거artifacts/승인 전까지 무시릴리스-후보 정책으로 보존.