저장소 위생
DispatchAtlas 의 버전 관리는 손으로 작성된 소스, 테스트, 구성, 문서, 재현 가능한 메타데이터를 담습니다. 로컬 실행 산출물은 정책이 명시적으로 소스로 승격하지 않는 한 Git 바깥에 머뭅니다.
🧹 생성 출력 정책
생성된 실험 데이터, 체크포인트, 결과 번들, 커버리지 리포트, 문서 빌드 출력, 패키지 산출물, 릴리스 후보는 기본적으로 무시됩니다. 후속 게이트가 그것들을 승격할 때 소스에서 재생성되고 출처를 통해 기록됩니다.
추적되는 생성 파일은 다음을 요구합니다:
- 소스 소유자.
- 재생성 명령.
- 보존 근거.
- 오래된 출력에 대한 검토 경로.
🗃️ 캐시 정책
Python, Ruff, mypy, pytest, 커버리지, 문서 빌드, 가상 환경의 로컬 캐시는 무시됩니다. CI 는 의존성을 캐시할 수 있으나, 캐시 키는 lockfile 과 워크플로 입력에서 유도되어야 합니다.
🔬 로컬 실험 출력 정책
로컬 실험 실행은 실험 작업공간의 무시되는 출력 계층 — 실행 결과, 로그, 체크포인트, 증거
번들, 작업공간 자체의 README 에 배치된 대로 — 에 쓰며, outputs/ 나 artifacts/ 같은
다른 무시되는 스크래치 위치와 나란히 있습니다. 최종 연구 증거는 모든 공개 사용 전에
검증된 캠페인 및 분석 명령을 통해 산출됩니다.
📋 산출물 보존 규칙
| 산출물 클래스 | 기본 위치 | Git 상태 | 보존 |
|---|---|---|---|
| 패키지 빌드 | dist/ | 무시 | 필요 시 재빌드. |
| 문서 빌드 | site/out/ | 무시 | 필요 시 재빌드. |
| 커버리지 | htmlcov/, .coverage* | 무시 | 품질 검사 중 재빌드. |
| 스모크 출력 | outputs/ | 무시 | 디버깅 시에만 로컬 보관. |
| 캠페인 결과 | 실험 작업공간의 결과 및 체크포인트 계층 | 무시 | 출처-게이트된 내보내기를 통해서만 승격. |
| 릴리스 증거 | artifacts/ | 승인 전까지 무시 | 릴리스-후보 정책으로 보존. |