TL;DR

  • Weft는 코딩 에이전트가 풀 리퀘스트를 열 때뿐 아니라 편집하는 동안에도 저장소별 순서 지정과 변경 검증을 제공하는 조정 시스템임.
  • Weft Coordination Protocol(WCP)은 특정 하네스에 종속되지 않는 와이어 프로토콜이며, Weft는 이를 Cloudflare 기반으로 구현한 서비스와 어댑터 모음임.
  • 저장소마다 하나의 Durable Object와 SQLite가 이벤트 순서를 관리하고, 변경 사항을 검증해 에이전트에 실행 가능한 진단을 반환함.
  • 사람은 에이전트와 같은 이벤트 스트림을 확인하며 승인, 일시 중지, 메시지 전송, 되돌리기, 근거 확인을 수행함.
  • WCP v0.1은 공개 표준이 아닌 초안이며, 프로젝트는 연구·데모 구현 단계임.

아키텍처

  • 에이전트 작업 공간은 Claude Code, Codex, OpenCode, Hermes를 지원하는 하네스 어댑터와 분석기로 구성되며, 어댑터는 하네스 훅을 WCP 요청으로 변환함.
  • 게이트웨이는 검사·편집·이벤트 요청을 저장소 조정자로 전달하고, 판정·진단·받은 편지함 정보를 에이전트에 반환함.
  • 저장소마다 하나의 Durable Object와 SQLite가 권위 있는 순서형 WCP 로그, 상태 머신, 제출 큐를 관리함.
  • 큐와 워크플로는 변경 처리, 후보 선택, 반영, 되돌리기를 조정하며, 샌드박스 컨테이너는 에이전트 컨테이너에 자격 증명을 노출하지 않은 채 Git 작업과 테스트를 수행함.
  • Artifacts는 저장소와 격리된 후보 포크를 제공하며, D1은 작업·변경·리비전·근거를 색인하고 R2는 실행 아티팩트를 저장함.
  • 웹 및 iOS 클라이언트는 같은 이벤트 스트림을 관찰하고 사람의 작업을 게이트웨이에 전달함.
  • 실제 이벤트 로그를 보여 주는 공개 읽기 전용 웹 데모는 weft.elier.ai에서 제공되며, 로그인은 필요하지 않음.

Cloudflare를 선택한 이유

  • Workers는 조정 API와 가까운 게이트웨이, 사용자 인터페이스(UI), 미리보기 서비스, 제품 통합을 제공함.
  • SQLite를 사용하는 Durable Objects는 저장소마다 권위 있는 단일 순서형 로그, 상태 머신, 제출 큐를 제공함.
  • Artifacts는 기본 브랜치와 격리된 후보 포크를 제공함.
  • Queues와 Workflows는 푸시 처리, 테스트, 후보 선택, 반영, 복구를 내구성 있고 재시도 가능하게 만듦.
  • Containers와 Sandbox SDK는 Git 작업, 빌드, 테스트, 선택적 에이전트 실행을 격리하며, 자격 증명은 컨테이너 외부에서 중개함.
  • D1은 저장소 간 작업과 근거를 색인하고, R2는 로그·대화 기록·스크린샷을 보관함.
  • Workers AI, AI Gateway, Browser Rendering은 위험·검토 지원, 추적 가능한 모델 트래픽, 시각적 근거를 지원함. 이 서비스들은 핵심 WCP 이벤트 모델을 이해하는 데 필수는 아님.
  • 구현은 계속 바뀌고 있으며, 설계 문서는 핵심·강력·선택적 제품 통합을 구분함. 이 저장소만으로 프로덕션 배포를 의미하지는 않음.

사용해 보기

  • docs/try-it.md를 따라 도구 체인을 설치하고 프로토콜 적합성 테스트 모음을 로컬에서 실행할 수 있으며, 선택적으로 자체 Cloudflare 계정에 미리보기 환경을 배포할 수 있음.
  • 로컬 실행에는 Cloudflare 계정, API 토큰, 제공자 자격 증명이 필요하지 않음.

저장소 구성

  • packages/protocol — WCP 타입, 스키마, 검증기, 참조 조정자, 적합성 테스트 픽스처.
  • packages/analyzer — TypeScript 차이점의 심벌 읽기·쓰기 분석.
  • packages/adapters — 하네스별 훅 변환기.
  • apps/gateway, apps/workflows, apps/sandbox, apps/web — 조정 API, 내구성 있는 작업, 격리 실행, 사람을 위한 UI.
  • demo/ — 시나리오, 실행 도구, 기록된 근거.
  • docs/ — 설계, 프로토콜, 런북, AAIF 제안.

라이선스

  • MIT 라이선스이며, 세부 내용은 LICENSE에 있음.