루프의 모든 차례는 같은 방식으로 돕니다. 트리거가 웹훅이든 시계든, 누가 고블린을 직접 멘션했든 같습니다. 이 페이지는 그 트리거와 머지 리퀘스트 사이에서 벌어지는 일입니다.
1. 트리거가 도착합니다
TaskGoblin은 그 작업의 스레드(이슈 하나, 머지 리퀘스트 하나, 루프 하나의 대화)를 찾거나 만들고, 이번 차례를 그 안의 메시지로 기록합니다. 이미 진행 중인 작업에 대한 후속 요청은 새 스레드가 아니라 기존 스레드에 들어갑니다. 고블린이 다시 설명해 달라고 하지 않는 이유입니다.
2. 샌드박스가 올라옵니다
실행에는 저장소 체크아웃이 담긴 격리 클라우드 컨테이너가 배정됩니다. 샌드박스는 지속되며 같은 스레드의 차례들 사이에서 재사용되므로, 후속 요청은 저장소와 이전 차례의 상태가 이미 있는 환경에 도착합니다. 고블린은 빈 상자에서 시작하는 대신 이어서 합니다.
대개 미리 예열되어 있어서, 실행은 차가운 컨테이너를 기다리는 대신 보통 몇 초 만에 일을 시작합니다. 격리·지속성·자체 호스팅은 클라우드 샌드박스에서 자세히 다룹니다.
3. 쓰기 전에 읽습니다
코드를 건드리기 전에 고블린은 맥락을 모읍니다. 실행을 부른 이슈나 디프, 스레드 기록, 이전 고블린이 남긴 인계 노트, 그리고 조직의 관례. 이벤트 루프라면 여러분의 상시 지시문이 이벤트 자체의 맥락 위에 얹힙니다.
쓸모 있는 변경과 그럴듯하기만 한 변경을 가르는 단계가 여기입니다. 지난 변경이 어떻게 리뷰됐는지, 이전 접근이 왜 되돌려졌는지 볼 수 있는 에이전트는 빈방에서 시작하는 에이전트보다 나은 판단을 합니다.
4. 진짜 코딩 에이전트가 일합니다
샌드박스 안에서는 진짜 코딩 에이전트가 돕니다 — 그 실행의 모델 계정에 따라 Claude Code, Codex, 또는 Gemini. 개발자와 같은 도구를 갖고 파일을 읽고 고치며, 명령을 실행하고 여러분의 테스트를 돌립니다. 디프를 자동완성하는 게 아니라 문제를 붙잡고 씨름합니다.
5. 브랜치, 커밋, 푸시, 머지 리퀘스트
고블린은 여러분 팀이 이미 쓰는 흐름을 따릅니다.
- 전용 브랜치에서 일합니다 — GitLab이나 GitHub의 이슈 142라면
142-taskgoblin, Jira 키라면proj-123-taskgoblin. 기본 브랜치에서는 절대 작업하지 않습니다. - 흔적이 읽히도록 서명해 커밋하고, 브랜치를 푸시합니다.
- 머지 리퀘스트(GitLab) 또는 풀 리퀘스트(GitHub)를 열고, 작업이 시작된 곳으로 링크를 보고합니다.
예외는 기존 머지 리퀘스트 위에서 실행된 경우입니다. 그때는 경쟁 브랜치를 만들지 않고 그 MR의 브랜치에 푸시합니다.
결과물이 브랜치와 머지 리퀘스트이므로, 리뷰는 사람의 기여에 대해 이미 하던 그대로입니다. 여러분의 승인 없이는 아무것도 머지되지 않습니다.
6. 여러분이 이미 보고 있는 곳에 보고합니다
실행 내내 고블린은 그 작업이 속한 무대를 통해 알립니다. Linear 이슈의 활동, 머지 리퀘스트의 인라인 코멘트, Slack이나 Teams에서 스스로 갱신되는 카드. 터미널을 지켜볼 필요도, 따로 열어야 할 대시보드도 없습니다.
7. 무슨 일이 있었는지 적어 둡니다
고블린이 마지막으로 하는 일은 — 답변을 보낸 뒤이지 결코 그 전이 아닙니다 — 인계 노트를 남기는 것입니다. 무엇을 배웠고, 무엇을 정했고, 무엇이 남았는지. 다음 차례는 그것부터 읽습니다.
루프가 반복이 아니라 쌓이는 이유가 이것입니다. 브레인를 보세요.
비밀은 에이전트 바깥에 머뭅니다
고블린은 여러분의 자격 증명을 결코 보지 않습니다. 샌드박스 안의 git 접근은 실행 시점에 조직 단위로 준비되어(GitLab OAuth 토큰이나 새로 발급된 GitHub 설치 토큰) 에이전트에게 읽으라고 건네지는 대신 그 주위 환경에 주입됩니다. 클론하고 푸시하는 데 필요한 접근을 쓸 수는 있지만, 여러분의 비밀이 그 맥락이나 기록에 들어가는 일은 없습니다.
그 토큰은 git 전송 전용입니다. 코멘트, 리뷰, 이슈 갱신은 TaskGoblin 자체 통합을 거쳐 여러분이 아니라 고블린 이름으로 올라갑니다.
잘못됐을 때
실패한 실행이 사라지지는 않습니다. 고블린은 여러분이 실행을 부른 무대에서 상황을 분명히 알리고, 실패는 그 실행에 기록되며, 인계 노트가 부딪힌 벽을 함께 넘겨 다음 차례가 다시 발견하지 않게 합니다. 샌드박스까지 가지 못한 실행 — 예컨대 잔액 소진으로 막힌 경우 — 은 과금되지 않습니다.