오픈소스 CLI 도구 sdf는 Claude를 사용하여 스택형 GitHub PR을 관리합니다.

sdf(Stacked Diffs Flow)는 git과 gh 위에서 스택형 풀 리퀘스트 워크플로우를 자동화하는 오픈소스 CLI 도구입니다. 이 도구는 Claude CLI를 엔진으로 사용하여 복잡한 작업을 처리하며, Claude는 git과 gh와 함께 적절한 의존성으로 나열되어 시작 시 버전을 확인합니다. Claude CLI가 없는 경우 AI 기능은 점진적으로 저하됩니다.

주요 명령어 및 기능

이 도구는 Claude가 주요 작업을 수행하는 여러 명령어를 제공합니다:

• sdf split — 큰 브랜치를 스택으로 분해합니다. Claude는 전체 diff를 분석하고 의미론적 주제를 식별하며, 동일한 파일이 여러 관심사를 포함하는 경우를 포함하여 허수준 정밀도로 계층화된 분할 계획을 제안합니다. 그런 다음 종속성 순서로 각 브랜치를 생성하고, 분할이 무손실인지 확인한 후 PR을 엽니다.
• sdf sync — 캐스케이드 리베이스 중 충돌 해결을 처리합니다. 업스트림 PR이 병합되고 다운스트림 브랜치에 충돌이 있을 때, sdf는 전체 스택 컨텍스트(각 브랜치가 수행하려던 작업, 업스트림에서 변경된 사항, 실제 충돌 마커)로 프롬프트를 구성하여 Claude CLI에 전달합니다. Claude는 충돌이 존재하는 이유를 이해하며, 단순히 위치만 파악하는 것이 아닌 의미론적으로 충돌을 해결합니다.
• sdf sync --with-content — Claude는 각 브랜치의 diff를 읽고 무엇과 왜를 설명하는 제목과 설명을 작성하여, 문장 작성으로 컨텍스트 전환을 원하지 않을 때 유용합니다.
• sdf ai intro — Claude Code가 세션 간에 sdf의 명령어, 워크플로우 및 규칙을 이해할 수 있도록 스킬 파일을 생성합니다.

설치 및 이용 가능성

이 도구는 무료이며 MIT 라이선스가 적용되며, 소스는 GitHub에서 이용할 수 있습니다. brew install pavelpascari/tap/sdf를 통해 Homebrew로 설치할 수 있습니다. 문서는 stacked-diffs-flow.com/docs/getting-started에서 확인할 수 있습니다.

이러한 유형의 도구는 복잡한 코드베이스로 작업하며 여러 종속 풀 리퀘스트를 효율적으로 관리해야 하는 개발자에게 유용합니다. Claude CLI와의 통합은 단순한 텍스트 조작이 아닌 코드 변경의 의미론적 이해를 가능하게 합니다.