이 빠른 시작 가이드는 새 계정에서 에이전트가 작성한 첫 번째 병합 요청까지 안내합니다. 소요 시간은 몇 분 정도이며, 대부분은 설정 화면을 클릭하는 시간이 아니라 에이전트가 작업을 마칠 때까지 기다리는 시간입니다.
시작하기 전에
에이전트가 작업할 저장소가 있는 GitLab 그룹 또는 GitHub 조직에 대한 관리자 권한이 필요합니다. 그리고 가장 매끄러운 첫 실행을 위해서는 Linear 워크스페이스가 있으면 좋습니다. 필요한 것은 그게 전부입니다 — 로컬에 설치할 것도, 여기저기 복사해 다닐 키도 없습니다.
1단계 — 로그인
로그인 페이지로 이동하여 GitLab 또는 GitHub로 로그인하세요. 이 한 번의 동의로 로그인과 동시에 조직이 프로비저닝됩니다. TaskGoblin은 각 원격 그룹(GitLab)마다, 또는 앱 설치(GitHub)마다 조직을 생성하므로, 로그인하는 순간 리포지토리가 연결됩니다.
GitHub의 경우 원하는 조직에 TaskGoblin GitHub App을 설치합니다. 이 앱의 설치 토큰이 taskgoblin[bot]으로 게시하는 봇의 정체입니다. GitLab의 경우 OAuth 동의를 통해 그룹 목록을 열거하고 연결합니다.
2단계 — 이슈 트래커 연결하기
조직 메뉴에서 **통합(Integrations)**을 열고 Linear를 연결하세요. 이는 원클릭 OAuth 동의로, TaskGoblin이 자신에게 할당된 이슈를 확인하고 업데이트를 다시 게시할 수 있게 해줍니다. 팀이 Slack을 사용한다면 여기서 Slack도 함께 연결하세요 — 그러면 어떤 스레드에서든 고블린을 멘션할 수 있습니다.
전체 목록과 각 통합이 무엇을 가능하게 하는지는 통합 연결하기를 참고하세요.
3단계 — 에이전트에게 작업 할당하기
이제 실제 작업을 넘겨보세요. 가장 간단한 첫 작업은 작고 명확하게 설명된 변경 사항입니다 — 문구 수정, 작은 리팩터링, 누락된 테스트 추가 등이 좋습니다.
- Linear에서: 이슈를 열고 변경 사항을 명확히 설명한 다음 담당자를 TaskGoblin으로 설정하세요.
- GitHub에서: 이슈에
taskgoblin라벨을 추가하세요. - GitLab에서: 이슈를
@taskgoblin봇에 할당하세요.
TaskGoblin은 자동으로 작업을 수신합니다 — 할당이나 라벨 자체가 트리거입니다. 지켜봐야 할 대기열도, 눌러야 할 버튼도 없습니다.
4단계 — 작업 지켜보기
에이전트는 샌드박스를 실행하고 리포지토리를 클론한 뒤 ai-{issue-identifier}라는 이름의 브랜치에서 작업을 시작합니다. 진행하면서 이슈에 진행 상황을 계속 게시하므로 새로 무언가를 열지 않고도 지켜볼 수 있습니다. 작업이 끝나면 커밋하고 푸시한 뒤, 해당 이슈로 다시 연결된 병합 요청(또는 풀 리퀘스트)을 엽니다.
5단계 — 검토하고 반복하기
동료의 코드를 검토하듯 병합 요청을 검토하세요. 수정이 필요하다면 새 채팅창을 다시 열 필요 없이 — 그냥 검토 코멘트를 남기고 @taskgoblin을 멘션하거나 이슈에 답글을 다세요. 에이전트는 지금까지 진행된 전체 맥락을 유지한 채 같은 브랜치에서 작업을 재개하고 후속 커밋을 푸시합니다. 작업을 다시 에이전트에게 보내는 모든 방법은 에이전트에게 작업 할당하기를 참고하세요.
방금 한 일
도구를 연결하고, 팀이 이미 사용하는 곳을 통해 작업을 위임했으며, 검토 가능한 병합 요청을 돌려받았습니다 — 이 과정에서 에이전트가 여러분의 노트북을 건드린 적은 한 번도 없습니다. 이것이 전체 흐름입니다. 이 문서의 나머지 내용은 모두 이 위에 얹히는 세부 사항일 뿐입니다.