cowork-bridge

Cowork Bridge

Cowork(Claude Desktop)에서 제출한 문서를 처리하는 파이프라인입니다.

상태 흐름

pending → planning → planned → (Cowork 승인) → approved → executing → done

명령어

/cowork-bridge list

inbox에 있는 문서 목록을 확인합니다. 모든 상태의 문서를 보여줍니다.

/cowork-bridge plan <id>

특정 문서의 실행 계획을 조회합니다.

/cowork-bridge process <id>

approved 상태의 문서를 가져와 계획대로 실행한 뒤 결과를 outbox에 저장합니다.

/cowork-bridge results

처리 완료된 결과 목록을 확인합니다.

처리 흐름

1. $ARGUMENTS를 파싱합니다.
2. 명령어에 따라:

list

• ${CLAUDE_SKILL_DIR}/../../data/inbox/ 디렉토리에서 *.meta.json 파일을 읽습니다.
• 모든 문서를 상태와 함께 목록으로 보여줍니다.

plan

• ${CLAUDE_SKILL_DIR}/../../data/inbox/<id>.meta.json을 읽습니다.
• meta의 plan 필드를 보여줍니다.
• 계획이 없으면 현재 상태를 안내합니다.

process

• meta의 status가 "approved"인지 확인합니다. 아니면 중단합니다.
• ${CLAUDE_SKILL_DIR}/../../data/inbox/<id>.md에서 원본 문서를 읽습니다.
• meta의 plan 필드에서 승인된 실행 계획을 확인합니다.
• Cowork 피드백이 있으면 반드시 반영합니다.
• 계획대로 작업을 실행합니다 (코드 생성, 파일 수정 등).
• 처리 결과를 ${CLAUDE_SKILL_DIR}/../../data/outbox/<id>.md에 저장합니다.
• outbox에 <id>.meta.json도 저장합니다:

  {
    "sourceId": "<id>",
    "sourceTitle": "<원본 제목>",
    "sourceType": "<원본 타입>",
    "summary": "<결과 요약 한 줄>",
    "completedAt": "<ISO timestamp>"
  }
  

• inbox의 meta status를 "done"으로 업데이트합니다.

results

• ${CLAUDE_SKILL_DIR}/../../data/outbox/에서 *.meta.json을 읽어 완료 목록을 보여줍니다.

인수가 없을 때

인수 없이 호출되면 list와 동일하게 동작합니다.

MCP 도구 (watcher 자동 처리용)

watcher가 실행 중이면 아래 흐름이 자동으로 진행됩니다:

• get_document → save_plan → (Cowork 승인 대기) → complete_document

Cowork 쪽 도구:

• submit_and_wait — 문서 제출 후 계획이 올 때까지 대기
• approve_plan — 실행 계획 승인 (피드백 추가 가능)
• get_plan — 실행 계획 조회
• get_result — 최종 결과 조회