기능
Project Orchestrator가 하는 일
계획, 작업, 노트, 결정, 전문 어시스턴트가 프로젝트마다 하나의 메모리에 함께 모여 있어요. Project Orchestrator가 무엇을 해 주는지 살펴보세요.
코드가 있든 없든, 프로젝트
프로젝트는 자기만의 계획, 작업, 노트, 결정을 담아요. 코드베이스일 수도 있고, 행사나 예산처럼 코드가 없는 일일 수도 있어요.
- 모든 프로젝트를 Today 화면 하나에 보여 줘요. 내 답을 기다리는 것, 이어서 할 것, 저절로 진행되는 것이에요.
- 컨텍스트와 목표를 공유하는 워크스페이스에 여러 프로젝트를 묶어요.
- 코드가 없는 프로젝트는 지금은 어시스턴트에게 요청해서 만들어요. 앱의 프로젝트 양식에는 아직 이 선택지가 없어요.
내부 구조
프로젝트에는 profile이 있어요. software는 동기화하고 감시하는 코드베이스이고, work는 소스 트리 없이 문서, 계획, 작업, 노트로 이루어진 프로젝트예요.
- project · create
- workspace · list
- project · get_roadmap
해 보기: 유형으로 걸러낸 다음 프로젝트를 여세요.
목표, 계획, 작업
목표는 지향하는 바예요. 계획은 작업과 단계로 거기에 이르는 방법을 말해요. PO는 끝난 것, 막힌 것, 다음에 올 것을 보여 줘요.
- 각 단계, 작업, 계획의 상태를 추적하고 진행률을 합산해요.
- 가장 긴 작업 사슬을 보여 줘서, 끝나는 날짜를 정하는 것이 무엇인지 알 수 있어요.
- 같은 계획을 연결 지도나 열이 있는 보드로 보여 줘요.
- 채팅에서 #를 입력하면 계획, 작업, 노트, 결정 또는 RFC를 가리킬 수 있고, 카드를 대화로 끌어다 놓을 수도 있습니다. 에이전트가 무엇을 말하는지 정확히 알 수 있습니다. 현재는 기능 플래그 뒤에 있습니다.
내부 구조
가장 긴 사슬은 크리티컬 패스로, plan(action: "get_critical_path")로 의존성 그래프에서 계산해요.
- plan · get_critical_path
- task · add_dependencies
- step · update
Organize the team weekend
In progress해 보기: 작업을 클릭해 앞으로 진행시키고 진행률이 올라가는 것을 보세요.
함께 일하는 어시스턴트
PO는 서로 의존하지 않는 작업을 묶어서 각각 자기 어시스턴트에게 맡겨요. 기본값으로 한 번에 작업 네 개가 실행돼요. 다음 묶음이 시작되기 전에 PO가 결과를 확인해요.
- 어떤 작업이 시작됐고 어떤 작업이 끝났는지 실시간으로 보여 줘요.
- 실행은 언제든 멈출 수 있고, 지난 실행 목록을 상태와 함께 보관해요.
- 아무도 키보드 앞에 없어도, 일정에 맞춰 또는 어떤 일이 일어났을 때 계획을 시작해요.
- 계획의 일정, 웹훅, 이벤트 트리거가 이제 그 계획의 실행을 시작해요. 신호당 한 번이고 쿨다운이 있어요. CI, 릴리스, 풀 리퀘스트에 반응하는 기능은 아직 진행 중이에요.
- 중지는 네이티브 엔진에서 아직 실행 중인 도구에도 닿고, 실패한 취소는 실패로 표시돼요.
내부 구조
plan(action: "run")은 프로젝트 폴더에서 자체 git 브랜치로 실행기를 시작해요. 빌드 확인은 Rust, Node, Go 프로젝트에서 실행돼요.
- plan · get_waves
- plan · run
- plan · run_status
해 보기: 실행을 누르면 웨이브가 차례로 실행돼요.
노트와 결정
노트와 결정은 내 프로젝트, 작업, 파일에 속해요. 각각 상태(활성, 검토 필요, 오래됨, 폐기)가 있어서 어시스턴트가 무엇을 믿어야 하는지 알아요.
- 결정을 이유와 영향 범위와 함께 저장하고, 바뀌면 새 결정으로 대체해요.
- 정확한 단어뿐 아니라 의미로 노트를 찾고, 검토가 필요한 노트를 나열해요.
- 제안은 결정하기 전에 변경 사항을 검토에 올려요.
내부 구조
노트와 결정은 Neo4j 그래프의 노드예요. 함께 쓰인 노트는 점점 강해지는 시냅스로 이어지고, 검색은 그 연결을 따라가요.
- note · search_semantic
- decision · add_affects
- note · get_needing_review
해 보기: 노트를 검색한 다음, 제안된 결정을 수락하거나 거절하세요.
문서
문서는 프로젝트 아래에 정리돼요. 원본 파일은 내 컴퓨터에 남고, PO는 텍스트를 출처를 기억하는 구절로 나눠요.
- 프로젝트에 파일을 업로드하고, 나중에 원본을 다시 열거나 삭제할 수 있어요.
- PDF와 텍스트 파일의 텍스트를 읽어요.
내부 구조
원본은 로컬 디스크에 저장되고 SHA-256으로 주소가 지정돼요. 텍스트는 소스 내 위치를 유지하는 청크로 나뉘어요.
해 보기: 유형으로 걸러내거나 순서를 바꾸세요.
전문 어시스턴트
페르소나는 내 일의 한 분야에 특화된 어시스턴트예요. 스킬은 관련 노트의 묶음으로, 주제가 나오면 어시스턴트가 스스로 켜요.
- 작업에 맞는 페르소나를 골라요.
- 페르소나는 자기 작업에 시간 한도, 비용 한도, 모델을 정해요.
- 스킬은 생겨나는 중에서 활성으로, 30일 동안 쓰지 않으면 휴면으로 바뀌어요. 스킬은 내보내고 가져올 수 있어요.
내부 구조
스킬은 노트 클러스터(Louvain 커뮤니티 탐지)에서 감지해요. 각 스킬에는 에너지와 응집도 점수가 있어요. 페르소나 빌더는 코드 기반 모드와 수동 모드를 제공해요.
- persona · get
- skill · activate
- skill · export
해 보기: 스킬을 사용하거나, 일주일이 지나게 두세요.
반복할 수 있는 절차
프로토콜은 시작, 단계, 끝이 있는 절차예요. 어시스턴트가 순서대로 따르고, 실행은 매번 기록돼요.
- 단계와, 실행을 한 단계에서 다음 단계로 넘기는 조건을 정의한 다음, 실행을 시작하고 따라가요.
- 프로토콜을 스킬에 연결하면 그 스킬이 적용될 때 시작돼요.
- 실행은 계속하기 전에 사람이 검토하기를 기다릴 수 있어요.
내부 구조
프로토콜은 유한 상태 머신이에요. 시작, 중간, 종료 상태와 트리거로 일어나는 전이로 이루어져요. plan-runner-reviewed는 awaiting_review 상태를 더해요.
- protocol · add_state
- protocol · start_run
- protocol · link_to_skill
해 보기: 실행을 진행시키거나, 게이트를 실패시키세요.
AI는 직접 고르거나, PO에게 맡기세요
채팅의 메뉴 하나로 모든 것을 정합니다. 자동을 켜면 PO가 작업이나 턴마다 모델을 고르고, 끄면 허용할 모델을 체크합니다. 하나만 체크하면 엄격, 여러 개면 혼합입니다. Claude Code는 기본 내장이며, DeepSeek 같은 OpenAI 호환 엔드포인트, Codex, opencode 같은 ACP 에이전트, SSH로 연결하는 다른 기기의 Claude Code도 추가할 수 있습니다. 각각 프로젝트별로 허용합니다.
- 메뉴는 이미 시작된 대화를 포함해 대화 중 언제든 사용할 수 있으며, 선택은 그 대화에만 적용됩니다. 직접 한 선택은 PO가 절대 바꾸지 않습니다.
- 자동에서는 PO가 도구, 컨텍스트 크기, 예산, 동의를 따져 보고, 고른 이유를 기록하며, 결과에서 배웁니다. 섀도 보고서는 맡기기 전에 PO가 무엇을 골랐을지, 얼마나 절약했을지를 보여 줍니다.
- 대화는 양방향으로 다른 제공자로 옮겨 갈 수 있으며 기록은 유지됩니다. 자동에서는 PO가 턴 전에 대화를 옮길 수 있습니다.
- 작업을 위임하는 어시스턴트는 그 작업에 쓸 제공자와 모델을 지정할 수 있어요.
- 키는 양식에 직접 입력하지 않아요. 볼트에 보관되고, 한 제공자에게만 부여돼요. 보관함이 잠겨 있으면 채팅을 떠나지 않고 제공자 선택기에서 잠금을 풀 수 있습니다.
- 비용은 두 가지 방식으로 계산해요. 실제로 쓴 돈과, 구독이나 무료 모델의 명목상 가치예요. 알 수 없는 가격은 절대 0으로 표시하지 않아요.
- 초기 단계예요. 이 제공자들은 대역에서만 시험했고, 아직 실제 서비스에서는 시험하지 않았어요. 다른 컴퓨터의 Claude Code 세션에는 PO 도구가 제공되지 않아요.
- 대화 타임라인은 무슨 일이 있었는지 턴별로 보여 줘서 흐름을 다시 잡을 수 있어요.
- 도구 호출을 한 번만, 세션 동안, 또는 항상 승인할 수 있어요. 지속되는 규칙은 PO가 직접 보관하고 확인하며, 버튼은 그 규칙이 다루는 호출을 정확히 보여 줘요.
- 네이티브 엔진, Codex, ACP에서는 서버 재시작으로 끊긴 턴이 저절로 이어져요. 도구가 다시 실행되는 일은 없어요. Claude Code의 턴은 눈에 보이는 오류와 함께 닫히고, 다음 메시지가 대화를 이어 줘요.
- 첨부한 이미지는 Claude Code와 네이티브, 두 엔진 모두에서 모델에 전달돼요. 네이티브 엔진에서는 각 모델의 비전 능력이 결정해요.
- 네이티브 모델은 작업 도중 질문을 하거나, 일부를 서브 에이전트에게 맡길 수 있어요. Claude Code와 같아요.
내부 구조
인스턴스 종류: openai_compatible(프리셋 deepseek, vllm, ollama, llama_server, nim), anthropic), codex, acp, claude_code_remote. 에이전트 엔진 위에서 실행되며, 출처와 자격 증명 참조에 묶인 동의가 필요해요. 대화는 자체 라우팅 모드를 가집니다(자동에서는 프라이머리, 혼합, 풀). 적용 순서: 세션, 요청, 작업, 실행, 프로젝트 역할, 전역 역할, 기본값, Claude Code.
- plan · delegate_task
Claude Code: I split the weekend into four tasks. Nothing is booked yet.
해 보기: 기본 어시스턴트를 고르고, 제공자를 허용하거나 차단하세요.
어디서든, 휴대폰에서도
PO는 내 서버에서 실행하고, 내가 고른 웹 주소로 접속할 수 있어요. 평소 쓰는 계정으로 로그인하고, 인터페이스가 휴대폰 화면에 맞게 조정되므로 책상에서 떨어져서도 진행 상황을 확인하거나 요청에 답할 수 있어요.
- 기존 계정(Google, Microsoft, Okta 및 다른 OpenID Connect 제공자) 또는 비밀번호로 로그인해요.
- 특정 이메일 주소로 접근을 제한할 수 있어요.
- 인터페이스는 휴대폰 화면에 맞게 조정되도록 만들어졌어요.
- PO를 인터넷에 열기 전에 로그인을 켜세요. 켜지 않으면 주소에 닿을 수 있는 누구나 쓸 수 있어요.
- 인터페이스는 13개 언어로 번역되어 있고, 화면 그룹별로 진행 중이며 나머지 화면이 뒤따라요.
내부 구조
OpenID Connect 클라이언트(auth/oidc.rs), 이메일 허용 목록(allowed_emails), 비밀번호 로그인, JWT 세션. 인증을 설정하지 않으면 API는 모든 요청을 받아들여요.
Plan the team weekend and find a venue.
Three venues fit 12 people. The lake house is the cheapest. Shall I book it?
해 보기: 기기를 바꾸고, 로그아웃하고, 휴대폰에서 답하세요.
개발자용
PO는 코드도 읽어요
PO는 저장소마다 파일, 함수, 타입, 호출로 이루어진 그래프를 만들고, 함수를 누가 호출하는지와 변경이 무엇에 영향을 주는지 답해요. 모든 개념이 Claude Code, Cursor 또는 모든 MCP 클라이언트를 위한 도구예요.
내부 구조
- Rust, TypeScript, Python, Go, Java, C와 C++, Ruby, PHP, Kotlin, Swift, Scala, Zig, Dart 등을 파싱해요.
- Meilisearch로 프로젝트 하나 또는 워크스페이스 전체에서 코드를 검색해요.
- mcp_federation으로 다른 MCP 서버를 연결해요.
- 프롬프트에 넣는 그래프 내용은 모델이 지시로 따르지 않도록 데이터로 분리돼요.
Tree-sitter가 코드를 Neo4j 그래프로 파싱하고, 파일 감시기가 편집하는 대로 동기화해요.
- code · get_call_graph
- code · analyze_impact
- code · find_references
- mcp_federation · list