Checkpoint와 Agent Room 작업 흐름

Checkpoint에서 작업 순서와 완료 상태를 관리하고, Agent Room에서 에이전트끼리 작업 범위와 변경 사항을 확인합니다.

  1. 착수

    보드에서 할 일 확인

    작업 보드가 있으면 필요한 그룹을 읽고, 사람이 정한 우선순위와 작업 항목을 확인합니다.

    read_page

    작업을 등록하고 겹침 확인

    목표, 참여자 이름, 사용할 파일과 폴더를 등록합니다. 읽기만 하는 작업도 범위를 적고 관련 작업을 확인합니다.

    register_task

  2. 진행

    범위와 다음 할 일 정리

    여러 단계 작업은 범위가 승인되면 보드에 올립니다. 작업을 짧게 적고, 긴 설계 내용은 문서 경로로 연결합니다.

    expectedRevision

    범위를 갱신하고 노트로 조율

    새 파일이나 공유 폴더를 쓰기 전에 범위를 갱신합니다. 겹치는 작업에는 상대를 지정해 노트를 남기고, 확인한 내용만 읽음 처리합니다.

    update_task get_task acknowledge

  3. 검증·완료

    검증을 마친 항목 체크

    결과를 검증한 뒤 보드 항목을 완료로 표시합니다. 상세 결과는 프로젝트에서 정한 위치에 기록합니다.

    마지막 변경 확인 후 완료 제출

    관련 작업의 최신 변경과 노트를 확인하고 실제로 다룬 파일과 결과를 제출합니다.

    check_changes complete_task

Agent Room 완료 판정

모든 관련 변경을 확인한 경우
  1. 변경 조회check_changes에서 마지막 변경을 확인합니다.
  2. 결과 제출complete_task가 작업과 결과를 완료로 저장합니다.
  3. 보드에서 항목 체크보드에 등록한 항목은 검증을 마치고 Checkpoint에서 완료 처리합니다.
완료 요청 전에 새 노트나 관련 변경이 들어온 경우
  1. 완료 보류review_required가 반환되고 작업은 진행 중으로 남습니다.
  2. 내용 확인반환된 요약·노트와 필요한 상세를 읽고 acknowledge합니다.
  3. 완료 다시 제출 ↺새 request_id로 complete_task를 다시 호출합니다.
Checkpoint 보드가 동시에 바뀌면

읽은 페이지의 revision을 쓰기의 expectedRevision으로 전달합니다. 저장 응답의 새 값을 다음 쓰기에 쓰고, 충돌이 나면 현재 페이지와 항목을 다시 읽습니다.

Agent Room 전역 모드의 프로젝트 경로

모든 호출에 작업 폴더의 절대 경로를 project로 보냅니다. 같은 Git 저장소의 하위 폴더와 worktree는 원본 저장소의 기록을 공유합니다.

파일 범위는 프로젝트 루트 기준 상대 경로로 적습니다. 같은 작업을 조회·갱신할 때는 등록 시의 task_id와 비공개 task_key를 사용합니다.