AWR은 사람과 AI를 위한 오픈소스 프로젝트 딜리버리 플랫폼입니다. 목표, 워크스트림, 의존성, 컨텍스트, 인수를 하나의 프로젝트 딜리버리 워크플로로 연결하여, 작업이 여러 에이전트, 세션, 협업자에게 나뉘어 있어도 프로젝트가 합의된 목표에서 검증된 딜리버리까지 나아갈 수 있게 합니다.
AWR은 같은 근본 문제를 공유하는 두 가지 상황을 위해 만들어졌습니다.
- 한 사람이 여러 에이전트를 조율하며 복잡한 프로젝트를 진행하는 경우.
- 팀이 공유 프로젝트를 딜리버리하는 경우. 복잡한 소프트웨어 프로젝트부터 시작합니다.
두 경우 모두 사람이 방향을 정하고 결과를 검토하며, 에이전트가 작업을 수행합니다. AWR은 CLI와 MCP 서비스를 통해 이들의 작업을 동일한 프로젝트 상태에 연결합니다.
AWR가 해결하는 문제
AI 코딩 에이전트와 일할 때, 프로젝트의 지식은 보통 에이전트의 비공개 대화 속에 머뭅니다. 세션이 끝나거나, 모델이 바뀌거나, 다른 사람이나 에이전트가 작업을 이어받으면 그 컨텍스트는 사라집니다. 병렬로 진행되는 작업은 서로 어긋나고, "완료"는 마지막 에이전트가 말한 것이 무엇이든 그것을 의미하게 됩니다.
AWR은 대신 어떤 것이 참이어야 하는지를 중심으로 설계되었습니다.
- 세션, 모델, 협업자가 바뀌어도 프로젝트는 보존됩니다. 목표, 제약, 검증된 진행 상황이 핸드오프를 넘어 살아남습니다. 후속 작업자는 현재 작업에 필요한 컨텍스트와 체크포인트를 전달받으므로, 프로젝트는 세션과 에이전트를 가로질러 계속될 수 있습니다.
- 병렬 작업에 명확한 소유권과 핸드오프가 있습니다. 독립적인 워크스트림(예: 프런트엔드, 백엔드, 테스트)은 프로젝트 제약을 공유하면서도 각자의 작업, 컨텍스트, 소유권을 유지합니다.
- "완료"는 검증 가능합니다. 완료 주장은 버전에 바인딩된 증적에 연결됩니다. 구현, 검증, 머지, 릴리스는 하나의 주장으로 뭉뚱그려지지 않고 별개의 사실로 추적됩니다.
- 작업량이 가시적입니다. 모든 단계에서 무엇이 준비되었고, 무엇이 대기 중이며, 무엇이 검증되었고, 노력이 어디에 쓰였는지 알 수 있습니다.
요약하면: AWR은 유한한 컨텍스트 윈도우를 가로지르는 프로젝트 연속성을 보존합니다. 에이전트의 컨텍스트 윈도우는 제한되어 있고, 컴팩션(호스트가 대화를 짧게 줄이는 것)은 호스트의 몫입니다 — AWR의 체크포인트가 기록된 프로젝트 사실을 대신 앞으로 전달합니다.
작동 방식: 파일이 진실의 원천(source of truth)으로 유지됩니다
AWR의 아키텍처는 세 부분으로 이루어져 있습니다.
- 파일이 의도를 담고 있습니다. 프로젝트의 Markdown 및 YAML 파일이 목표, 계획, 작업, 제약, 결정을 기술합니다. AWR은 이 소스들을 몰래 대체하지 않고 인덱싱합니다.
- AWR이 연속성을 유지합니다. 로컬 상태(SQLite 프로젝트)가 그 소스들의 프로젝션과 함께 세션, 클레임, 체크포인트, 증적을 보관합니다. 컨텍스트 컴파일 — 현재 작업에 관련된 목표, 규칙, 의존성, 증적을 모으는 작업 — 은 로컬에서 실행되며 모델 호출을 하지 않습니다. 리비전 검사가 오래된 상태로부터 쓰기를 보호합니다.
- 사람과 에이전트가 작업을 수행합니다. CLI와 MCP 서비스가 프로젝트 사실을 여러분이 사용하는 어떤 호스트에든 연결합니다. 에이전트는 자체 모델, 도구, 대화를 가져오고, 검토된 변경 사항과 진행 상황은 프로젝트 소스로 되돌아갑니다.
기록된 체크포인트는 기록된 사실만 전달하므로, 에이전트의 기록되지 않은 대화 이력을 재구성하지 않습니다 — 그것은 호스트의 책임으로 남습니다.
구성 요소와 결합 방식
AWR과는 같은 패키지에서 설치되는 두 개의 진입점을 통해 상호작용합니다.
awrCLI — 프로젝트를 초기화하고, 상태를 조사하고, 명시적 세션 워크플로를 구동합니다: 작업 하나를 클레임하고, 집중된 컨텍스트를 받고, 중단하기 전에 체크포인트를 저장합니다. 셸 명령을 실행할 수 있는 어떤 에이전트든 사용할 수 있습니다.awr-mcpMCP 서비스 — 동일한 프로젝트 상태를 MCP 도구로 노출합니다 (MCP, 즉 Model Context Protocol은 AI 클라이언트가 외부 도구를 호출하는 방식입니다). 클라이언트는 stdio를 통해 단일 프로젝트에 연결하거나, 여러 클라이언트와 프로젝트를 서빙하는 공유 HTTP MCP 서비스에 연결합니다.
이 위에 AWR은 여러분이 이미 사용하는 에이전트를 지원합니다. 통합은 계층으로 이루어집니다.
- 제네릭 계약(기본값, 완전 지원). CLI를 실행하거나 MCP를 구사할 수 있는 어떤 호스트든 공유 세션 워크플로를 통해 동일한 프로젝트 상태를 사용합니다. 여기에는 Claude Code, Cursor, Windsurf 및 유사한 호스트가 포함되며 — 별도의 설치 프로그램이 필요 없습니다.
- 호스트 노트. 일부 호스트(Cursor, Kimi Code, Grok Build)에 대해 AWR은 특정 날짜의 호스트 버전을 기준으로 검증된 정확한 구성 병합 경로와 네이티브 세션 플래그를 문서화합니다. 이 노트들은 런타임 기능을 추가하지 않습니다.
- 선택적 라이프사이클 어댑터. 호스트의 네이티브 라이프사이클 훅이 안정적인 곳에서는 어댑터가 호스트 이벤트로부터 AWR 체크포인트를 구동할 수 있습니다. 현재 이것은 Codex에 존재합니다. 어댑터는 AWR을 해당 호스트의 런타임으로 바꾸지 않습니다.
여러 에이전트를 조율하는 한 사람에게도 더 큰 팀과 동일한 의존성, 검토, 회계 규율이 적용됩니다 — 하나의 프로젝트 모델이지 두 개의 제품이 아닙니다.
AWR가 아닌 것
AWR은 의도적으로 범위가 한정되어 있습니다. 호스트에 구애받지 않는 작업 런타임이며, 제품 경계는 공유 CLI/MCP 계약입니다 — 특정 에디터나 에이전트가 아닙니다.
- AWR은 AI 에이전트가 아닙니다. 코딩 에이전트를 선택하거나, 시작하거나, 구성하지 않습니다. 에이전트는 자체 모델, 도구, 대화를 가져옵니다; AWR에 저장된 제공자와 모델 문자열은 표시용 레이블일 뿐입니다.
- AWR은 에디터, 채팅 UI, 모델 제공자가 아닙니다. 에이전트의 UI, 네이티브 대화 ID, 컴팩션은 호스트에 속합니다.
- AWR은 프로젝트 파일을 대체하지 않습니다. Markdown/YAML 소스가 권위 있는 원본으로 남습니다; AWR의 로컬 상태는 인덱스와 연속성 기록이며, 소스를 몰래 대체해서는 안 됩니다.
- AWR은 하나의 전송 방식에 묶여 있지 않습니다. MCP가 stdio로 실행되는지, HTTP로 실행되는지, 아예 없는지는 호스트의 선택입니다; 호스트에 네이티브 훅이 없으면 CLI를 통해 수동으로 체크포인트를 저장합니다.
- AWR은 워크스트림을 물리적으로 격리하지 않습니다. 워크스트림 격리는 프로젝트 상태와 지원되는 연산을 다룹니다; 물리적 프로세스 격리는 실행 호스트에 달려 있습니다.
현재 범위: 릴리스된 버전과 개발 중인 기능
AWR은 출시된 것과 만들어지고 있는 것을 정직하게 구분합니다. 공개된 0.5.1 CLI/MCP 패키지는 다음을 제공합니다.
- 소스 기반 목표와 작업, 의존성 탐색 포함
- 현재 작업을 위한 집중된 컨텍스트 컴파일
- 세션 클레임과 체크포인트
- 버전에 바인딩된 증적
- 여러 클라이언트와 프로젝트를 위한 공유 HTTP MCP 서비스
- Personal Workspace 파일 교환
- 개인 워크스트림 기반: 로컬 SQLite 프로젝트에서의 명시적 소스 소유권, 세션 귀속, 범위 지정 컨텍스트
이 릴리스는 인증된 Team 서비스나 완전한 다중 클라이언트 격리를 제공하지 않습니다. main에서 아직 개발 중인 기능:
- 버전 관리되는 워크스트림 간 딜리버리 채택(다운스트림 작업을 인수된 아티팩트와 계약 버전에 바인딩; 변경 시 소비자를 재검사)
- 팀 협업과 딜리버리 리뷰(명시적 리뷰어 및 승인 기록)
- 워크스트림 사용량, 시간, ETA 회계
각 공개 버전의 릴리스 노트가 실제 패키지 경계를 정의합니다.
여러분에게 의미하는 바
AWR을 평가하고 있다면: 현재의 에이전트와 현재의 파일을 그대로 유지합니다. 프로젝트에서 AWR을 초기화하고, 에이전트에게 작업 합의를 제공하면, 그 이후로 모든 세션은 처음부터 시작하는 대신 기록된 목표, 규칙, 의존성, 체크포인트에서 시작합니다. 진행 상황은 언제든지 확인할 수 있습니다.
팀에 도입한다면: 동일한 CLI/MCP 기반이 해당 기능들이 출시됨에 따라 공유 딜리버리와 리뷰로 확장됩니다 — 공개된 릴리스는 이미 단일 사용자 및 다중 에이전트 코어를 제공합니다.