Git 히스토리에서 엔지니어링 결정 사항을 복구할 수 있는지 테스트했습니다

대부분의 코드는 그것이 작성된 이유보다 더 오래 살아남습니다.

몇 달 후 누군가가 파일을 열고 질문합니다:

이 라인이 왜 여기에 있나요?

git blame은 누가 마지막으로 이 코드를 수정했는지 알려줍니다.

보통 그것은 포매터 (formatter), 이름 변경 (rename), 또는 파일을 이동시킨 사람입니다.

그것이 해당 동작이 왜 존재하는지는 거의 알려주지 않습니다.

저는 이동 (moves), 이름 변경 (renames), 리팩토링 (refactors), 스쿼시 머지 (squash merges), 그리고 체리 피킹 (cherry-picks)을 통해 다음 사항들을 복구하는 오픈 소스 CLI인 archaeo를 구축했습니다:

제가 타협하지 않는 규칙은 다음과 같습니다:

증거가 존재하지 않는다면, archaeo는 **"No recorded decision found." (기록된 결정 사항을 찾을 수 없습니다.)**라고 말합니다.

환각 (hallucination)된 설명은 없습니다.

발행 전, 저는 Kubernetes, React, Cognee 및 기타 리포지토리 (repositories)에 걸쳐 **150개 이상의 실제 쿼리 (queries)**로 이를 검증했습니다.

주요 특징:

전체 검증, 벤치마크 (benchmarks), 아키텍처 (architecture) 및 구현 세부 사항은 기사에 나와 있습니다.


bash
npm install -g git-archaeo

Insights