시작하기
에이전트 데이터베이스 만들기
사이드바의 문서 탭에서 스페이스 이름 위에 마우스를 올리고 + 를 누른 뒤 새 데이터베이스 를 고르세요. 스페이스가 비어 있으면 스페이스 바로 아래의 새 데이터베이스 를 누르세요. 에이전트 데이터베이스는 스페이스 관리자(팀 소유자나 스페이스 소유자)만 만들 수 있어요.- 에이전트 데이터베이스 를 고르세요.
- 스페이스에 아직 GitHub 레포지토리가 없으면 GitHub 연결하기 에서 레포지토리를 고르세요. 이미 레포지토리가 있으면 이 단계는 건너뛰고 모든 레포지토리가 에이전트에 지정돼요.
- 에이전트에게 어디까지 맡길까요? 에서 승인 방식을 고르고 만들기 를 누르세요.
에이전트 켜기
에이전트를 쓰는 사람은 각자 자기 컴퓨터에서 자기 에이전트를 한 번 켜요. 데이터베이스 맨 위에 에이전트 지침 단추, 설정 단추, 내 에이전트 가 있어요.
- 내 에이전트 의 스위치(에이전트 켜기)를 켜세요.
- 처음 켤 때 레포지토리가 아직 이 컴퓨터에 없으면 내려받을 위치를 고르세요(레포지토리를 어디에 내려받을까요? › 폴더 고르기…). 한 번만 고르면 되고, 설정에서 바꿀 수 있어요.
- 폴더를 신뢰할지 물으면 신뢰하고 시작 를 누르세요. 터미널의 Claude Code 에서 이미 그 폴더를 신뢰했다면 에이전트 지침의 확인 명령만 물어봐요.
에이전트에게 할 일 맡기기
먼저 써 보려면 이미 승인됨 상태인 예시를 지켜보세요. 에이전트가 그 할 일을 가져가 결과를 PR 로 남겨요. 예시는 늘 PR 로 남고, 머지할지는 사람이 정해요.할 일 쓰기
새 할 일을 만들고 본문에 무엇을 바꿔야 하는지 적으세요. 자유롭게 써도 돼요. 빠짐없이 적으려면 템플릿 아이디어, 버그 리포트, 기능 요청 가운데 하나를 고를 수 있어요. 버그 리포트 는 증상, 재현 단계, 기대 결과, 스크린샷을 물어요. 보따리 세션에서 “이 버그로 할 일 써 줘”처럼 부탁할 수도 있어요. Claude 가 보따리 도구로 대화 내용을 바탕으로 할 일을 써요.담당자 정하기
할 일의 담당자 를 정하세요. 담당자 컴퓨터의 에이전트가 그 할 일을 처리해요.할 일 승인하기
새 할 일은 승인 대기 상태로 시작해요. 내용을 확인하고 단계 를 승인됨 로 바꾸세요. 그러면 에이전트가 가져갈 수 있어요. 승인은 담당자나 데이터베이스 전체 권한이 있는 사람이 했을 때만 인정돼요.에이전트 작업 지켜보기
에이전트는 승인된 할 일을 에이전트 설정에서 정한 순서(우선순위 순 (높음 → 낮음), 먼저 만든 순, 마감이 가까운 순)대로 하나씩 가져가요. 이미 진행 중인 할 일을 먼저 끝내요. 사이드바에 내 에이전트의 세션(“🤖 기기 이름 · 데이터베이스 이름”)이 나타나고, 그 아래에 할 일마다 세션이 하나씩 생겨요. 할 일 세션을 열면 에이전트가 계획하고 고치고 확인하는 과정을 따라갈 수 있어요. 이 세션들은 에이전트가 도는 기기에 머물러서 다른 사람이나 다른 기기에 넘길 수 없어요. 세션 맨 위의 사람을 누르면 담당자 카드를 볼 수 있어요. 승인된 할 일 가운데 급한 것을 바로 시작하려면 내 에이전트의 세션에 “T-12 먼저 해 줘”라고 쓰세요.질문에 답하기
에이전트가 결정이 필요하면 세션에서 묻고, 사이드바의 할 일 세션에 질문 중 가 표시돼요. 입력창 위의 선택지를 고르거나 직접 답을 쓰면(또는 직접 입력해서 답하기) 작업이 이어져요. 답하지 않은 질문은 데이터베이스의 답 대기 보기에도 모여요.결과 확인하기
에이전트는 레포지토리마다 정해진 확인(테스트 등)을 돌려요. 위험한 변경만 PR 나 항상 머지 에서는 확인을 통과한 일반 변경을 PR 로 열어 머지하고 세션에 보여 줘요. 항상 PR만 에서는 PR 로 남아요. PR 을 누르면 GitHub 에서 변경 내용을 볼 수 있어요. 원인, 수정 내용, 확인, 답변, PR 기록은 할 일 문서 끝에도 덧붙여져요. 변경이 위험하거나 에이전트 지침에 그 레포지토리의 확인 방법이 없으면, 머지 전에 답 대기 에 검토 카드가 나타나요. 머지 는 머지 전 확인을 돌린 뒤 머지해요. PR만 남기기 는 할 일을 검토 대기 상태로 두고, GitHub 에서 PR 이 머지되면 완료 으로 바뀌어요.에이전트 설정
데이터베이스 맨 위의 에이전트 지침 옆 설정 단추로 여세요. 설정은 이 데이터베이스의 모든 에이전트에 적용돼요. 스페이스 관리자와 데이터베이스 전체 권한이 있는 사람만 바꿀 수 있어요.승인 방식
어떤 방식이든(항상 머지 포함) 의존성, 마이그레이션, CI, 설정 파일을 바꾸는 변경과 되돌리기 어렵거나 방향을 크게 바꾸는 변경은 사람의 검토를 기다려요.
에이전트 지침
에이전트 지침은 에이전트가 레포지토리마다 따르는 규칙을 적은 문서예요. 데이터베이스 맨 위의 에이전트 지침 단추로 여세요. 첫 초안은 데이터베이스를 만든 사람의 컴퓨터가 자동으로 써요. 그렇게 되지 않았다면, 스페이스 관리자나 데이터베이스 전체 권한이 있는 사람의 컴퓨터에서 에이전트가 돌고 Claude Code 가 준비되고 레포지토리를 내려받았을 때 그 컴퓨터가 쓰거나, 그런 사람이 지침에서 초안 쓰기 를 누르면 써요. 그전까지 다른 사람에게는 관리자가 초안을 쓰면 여기 보여요 가 보여요. 지침은 다른 문서처럼 고칠 수 있어요. 초안이 준비되면 스페이스 관리자와 데이터베이스 전체 권한이 있는 사람은 지침 업데이트하기 를 눌러 에이전트에게 고치게 할 수도 있어요.제한 사항
- 에이전트는 승인되지 않은 할 일을 가져가지 않아요.
- 승인 뒤에 제목이나 본문을 고치면 승인이 풀려요. 에이전트가 아직 시작하지 않았다면 할 일이 승인 대기 로 돌아가고 다시 승인해야 해요.
- 내 컴퓨터가 오프라인이면 에이전트는 일하지 않아요. 컴퓨터가 한 시간 넘게 오프라인이면 에이전트가 멈추니, 계속하려면 컴퓨터를 다시 온라인으로 연결하세요.