GaosCode/PlanWeave

PlanWeave – 코드 에이전트를 위한 파일 기반 루프 엔지니어링 플랫폼

무엇인가요 – PlanWeave는 TypeScript/Node.js 기반 도구(CLI + Electron 데스크톱 앱)로, 모호한 개발 목표를 구조화된 파일 기반 작업 그래프로 전환할 수 있습니다. 각 노드(파일)에는 블록(개별 작업 단위)이 포함됩니다. 블록은 전문적인 AI 에이전트(Codex, Claude Code, OpenCode, Pi, Grok, 또는 로컬 스크립트)에 의해 할당되며, 실행, 검토되고 결과는 소스 파일과 함께 저장됩니다. 전체 루프(계획, 구현, 검토, 복구)는 복구 가능하고 관찰 가능합니다.

왜 중요한가요 – 채팅 기반 프롬프트는 계획 시작에는 좋지만 장기적인 엔지니어링에는 취약합니다. 계획을 리포지토리의 일등 시민으로 다루는 것(파일 = 노드, 블록 = 문서)을 통해 PlanWeave는 상태, 이력, 종속성을 프로젝트 내부에 유지하여 다음을 가능하게 합니다:

• 독립적인 블록에서 병렬 작업
• 각 블록을 가장 적합한 에이전트로 자동 라우팅
• 구현에 피드백되는 구조화된 검토 피드백
• 나중에 검토할 수 있는 지속적인 실행 로그, 아티팩트, 메트릭스
• 다중 사용자 협업 및 원격 에이전트 실행

핵심 개념

개념	역할
패키지 / 캔버스	리포지토리 내 일반 파일로 저장되는 PlanWeave의 최상위 프로젝트.
작업 그래프	종속성으로 연결된 노드(파일); 각 노드는 하나 이상의 블록을 보유합니다.
블록	할당 가능한 작업 단위(예: "함수 X 구현").
실행자 프로필	블록을 처리할 AI 모델 또는 로컬 명령어 설명(예: codex-acp).
에이전트 기술	블록에 대해 특정 작업을 수행하는 작은 재사용 가능한 에이전트(plan-maker, plan-runner, plan-reviewer, …).
MCP 서버	외부 LLM(ChatGPT, Claude 등)이 PlanWeave의 API를 호출하여 계획을 생성하거나 수정할 수 있도록 하는 로컬 HTTP 터널.

주요 기능

• 파일 기반 그래프 – 계획은 별도의 데이터베이스가 아니라 워크스페이스 내에 직접 존재합니다.
• 제로 구성 시작 – CLI(npm i -g @planweave-ai/cli)와 몇 가지 기술 패키지를 설치한 후 planweave 명령어를 실행합니다.
• 블록별 에이전트 라우팅 – 각 블록에 가장 적합한 LLM 또는 결정론적 스크립트를 선택할 수 있습니다.
• 자동 실행 모드 – 준비된 블록을 지속적으로 할당하고, 실행자 호출, 보고서 수집, 검토 결과 피드백을 자동으로 수행합니다.
• 데스크톱 캔버스 – 작업, 블록, 종속성, 실행 상태를 시각적으로 편집할 수 있는(전자 앱).
• 완전한 감사 추적 – 모든 실행에서 프롬프트, stdout, stderr, 구조화된 보고서, 메타데이터가 워크스페이스 아래에 저장됩니다.
• 협업 – 공유 프로젝트, 멤버 초대, 작업 할당, 댓글, 원격 에이전트 호스트 기능.
• MCP 통합 – 로컬 터널을 노출하여 ChatGPT(또는 기타 웹 기반 LLM)가 HTTP를 통해 PlanWeave를 제어할 수 있도록 합니다.
• 통계 및 검색 – 도구를 떠나지 않고 효율 메트릭스를 확인하고, 블록을 검색하며, 할 일 목록을 확인할 수 있습니다.

일반적인 워크플로우

1. 계획 생성/임포트 – plan-maker 또는 plan-importer 기술을 통해 LLM에 고수준 목표나 기존 문서에서 패키지 형태의 드래프트를 생성하도록 요청합니다.
2. 검증 및 임포트 – planweave package-draft validate … 및 planweave package import …를 실행하여 계획을 리포지토리에 적용합니다.
3. 계획 실행 – plan-coordinator 기술(또는 직접 planweave run …)을 호출합니다. 코디네이터는 블록을 할당하고, plan-runner로 구현, plan-reviewer로 검토하며, 필요 시 plan-recovery를 사용합니다.
4. 검토 및 반복 – CLI 명령어(planweave status, planweave graph inspect, planweave doctor) 또는 데스크톱 UI를 사용하여 진행 상황 확인, 로그 보기, 그래프 조정이 가능합니다.
5. 협업 – 팀원 초대, 블록 할당, 에이전트 호스트 기능을 통해 원격 장치에서 에이전트 실행을 선택적으로 수행합니다.

시작하기

# CLI 설치 (npm 또는 Homebrew)
npm install -g @planweave-ai/cli
# 또는
brew install GaosCode/tap/planweave

# 포함된 에이전트 기술 설치
npx skills@latest add GaosCode/PlanWeave

# 설치 확인
planweave --help

• 시각적 경험을 원하시면, 리포지토리의 릴리스 페이지에서 Electron 앱을 다운로드하세요.
• ChatGPT 기반 계획을 활성화하려면 MCP 서버를 시작(planweave mcp tunnel …)하고 ChatGPT의 도구 설정에 터널을 추가하세요.

누가 사용해야 할까요

• 재현 가능하고 감사 가능한 실행이 필요한 AI 지원 코드 생성을 원하는 개발자.
• 여러 AI 에이전트가 병렬로 작업할 수 있는 대규모 코드베이스를 구축하는 팀.
• "루프 엔지니어링"(프롬프트 → 실행 → 검토 → 개선)을 실험하는 연구자.
• 다단계 AI 워크플로우를 지속 가능하고 파일 기반으로 표현하고 싶은 누구나.

라이선스 – MIT (LICENSE 참조).

---

위의 모든 세부 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추측되지 않았습니다.