finna/Finn-loop

해결하는 문제

Finn-loop는 Linear와 GitHub를 사용하는 표준 개발 워크플로우를 AI 기반의 '소프트웨어 팩토리'로 변환합니다. 소프트웨어 수명 주기의 지루한 부분인 명세, 구현 및 검토를 자동화하는 동시에 코드베이스에 병합되는 항목에 대한 최종 결정권은 인간이 가지도록 보장합니다.

작동 방식

이 시스템은 Linear(이슈 추적용) 및 GitHub(버전 관리 및 CI용)와 통합되는 세 가지 Claude Code 커스텀 스킬 세트로 작동합니다.

1. 명세 (/finn-spec): AI가 사용자에게 인터뷰하여 모호한 아이디어를 명확한 수용 기준과 비목표가 포함된 상세한 Linear 이슈로 변환합니다.
2. 구현 (/finn-build): AI가 Linear에서 agent-ready 이슈를 할당받아 필요한 변경 사항을 구현 및 검증하고 GitHub Pull Request를 엽니다.
3. 검토 (/finn-review): AI가 열려 있는 PR을 원래 Linear 계약 및 GitHub 상태 확인과 대조하여 검토하고 PR이 병합 준비가 되었는지에 대한 평가를 제공합니다.

사용자는 이러한 프로세스를 루프(/loop 사용)로 실행하여 준비된 이슈 대기열과 보류 중인 검토를 지속적으로 처리할 수 있습니다.

대상 독자

Claude Code, Linear, GitHub를 사용하며 최종 병합 결정에 대한 제어권을 포기하지 않고 작고 잘 정의된 작업의 실행을 자동화하려는 소프트웨어 엔지니어 및 제품 소유자.

하이라이트

• 인간 제어 워크플로우: 인간만이 코드를 병합할 수 있다는 규칙을 엄격하게 적용합니다.
• 계약 기반 개발: Linear 이슈를 단일 진실 공급원으로 사용합니다. 요구 사항이 이슈에 없으면 에이전트는 이를 구축하지 않습니다.
• 통합된 도구: GitHub CLI(gh) 및 Linear 커넥터를 활용하여 원활한 상태 관리를 수행합니다.
• 확장 가능한 아키텍처: 단순한 루프에서 Slack 통합, 위험 인식 병합 및 자동화된 워치독을 갖춘 완전한 팩토리로 발전하기 위한 로드맵을 제공합니다.