본문으로 건너뛰기

동작 방식

하나의 목표에서 따라갈 수 있는 계획까지

여섯 단계가 루프를 이뤄요. 원하는 것을 말하면, PO가 계획하고, 작업의 순서를 정하고, 프로젝트가 아는 것을 불러오고, 작업을 실행하고, 검증하고, 배운 것을 저장해요. 각 단계 아래에서 기술적인 세부 내용을 열어 볼 수 있어요.

계획 → 순서 정하기 → 불러오기 → 실행 → 검증 → 학습, 그리고 다시 불러오기로 돌아가요. 6단계에서 저장한 내용을 다음 계획의 3단계에서 불러와요.

해 보기: 단계에 마우스를 올리거나 포커스하면 내용을 읽을 수 있고, 선택하면 그 단계로 이동해요.

루프

루프를 단계별로

스크롤해 보세요. 그림은 모두 제품 화면처럼 그려져 있어요. 예시는 팀의 주말 행사예요.

6단계 중 1단계: 계획, 읽기 지점 5개 중 5번째: 승인됨

원하는 것을 말하면, 계획이 나와요

원하는 결과를 한 문장으로 설명하세요. 어시스턴트가 그것을 작업이 있는 계획으로 바꿔요. 각 작업에는 단계가 있고, 각 단계에는 끝났는지 확인하는 방법이 적혀 있어요.

내부 구조

결과는 우선순위와 제약 조건이 있는 계획으로 저장된 다음 작업으로 나뉘어요. 각 작업은 무엇에 의존하는지 말하고 자기 단계를 나열해요. 각 단계에는 끝났다는 것을 증명하는 확인 방법이 붙어 있어요.

계획, 작업, 단계는 채팅의 자유 텍스트가 아니라 데이터로 저장돼요. 화면과 실행기는 같은 상태를 읽어요.

plan(action: "create", title, description, priority: 8, constraints: [{ constraint_type: "performance", … }])task(action: "create", plan_id, title, depends_on: [task_id], steps: [{ description, verification }])
  • 계획 상태: draft, approved, in_progress, completed, cancelled.
  • 제약 조건 유형: performance, security, style, compatibility, other.
  • code(action: "plan_implementation", auto_create_plan: true)는 코드 그래프에서 계획 초안을 만들어요.

해 보기: 지점을 고르거나, 화살표로 옮기거나, 재생을 누르세요. 잠시 멈추면 다이어그램이 다시 스크롤을 따라가요.

6단계 중 2단계: 순서 정하기, 읽기 지점 5개 중 5번째: 지금 준비됨

서로 의존하지 않는 작업은 함께 가요

PO가 작업을 정렬해요. 작업은 자기에게 필요한 작업만 기다려요. 나머지는 모두 지금 동시에 시작할 수 있어요.

내부 구조

작업은 의존하는 모든 것이 completed일 때만 시작돼요. PO는 이 연결을 웨이브로 바꿔요. 웨이브 1에는 충족되지 않은 선행 조건이 없는 모든 작업이, 웨이브 2에는 웨이브 1이 풀어 주는 작업이 들어가요. 이런 식으로 이어져요.

같은 웨이브의 작업은 서로 독립적이므로 동시에 실행돼요. 의존 관계의 가장 긴 사슬인 크리티컬 패스가 웨이브의 최소 개수를 정해요.

plan(action: "get_waves", plan_id)plan(action: "get_critical_path", plan_id)
  • plan(action: "get_dependency_graph")는 작업 DAG를 반환해요.
  • task(action: "get_next")는 막히지 않은 다음 작업을 우선순위가 높은 것부터 반환해요.
  • 실행을 재개하면 웨이브를 다시 계산하고 끝난 웨이브는 건너뛰어요.
Plan · dependency graph
Wave 13 in parallelWave 22 in parallelWave 31 taskT1 Venuesno prerequisiteT2 Availabilityno prerequisiteT3 Budgetno prerequisiteT4 Bookingafter T1, T2T5 Mealsafter T3T6 Share planafter T4

해 보기: 작업을 선택하면 무엇을 기다리는지, 무엇을 풀어 주는지 볼 수 있어요

6 tasks3 waveswave 1 is ready now

해 보기: 지점을 고르거나, 화살표로 옮기거나, 재생을 누르세요. 잠시 멈추면 다이어그램이 다시 스크롤을 따라가요.

6단계 중 3단계: 불러오기, 읽기 지점 5개 중 5번째: 전달됨

어시스턴트가 프로젝트가 이미 아는 것을 찾아봐요

각 작업 전에 어시스턴트가 해당하는 노트와 결정을 읽어요. 그래서 같은 질문을 다시 하지 않아요.

내부 구조

작업 전에 어시스턴트는 프로젝트 메모리를 읽어요. 노트(경고, 지침, 패턴), 이유가 붙은 결정, 코드 프로젝트라면 손댈 파일 주변의 코드예요. 의미 기반 검색이 가장 가까운 항목을 먼저 찾아요.

그다음 PO는 노트 사이의 연결을 따라가요. 질문과 맞지 않았던 노트도, 맞았던 노트와 강하게 연결되어 있으면 나타날 수 있어요. 연결은 한 단계마다 약해지고, 희미해진 노트는 제외돼요.

note(action: "search_semantic", query, project_slug)decision(action: "search_semantic", query)admin(action: "search_neurons", query, max_hops: 2)note(action: "get_context", entity_type: "file", entity_id)
  • 활성화 확산의 기본값: 시드 노트 20개, 2홉, 홉마다 신호가 절반으로 줄고, 결과 10개.
  • 결과 자리의 40%는 시냅스로 도달한 노트를 위해 남겨 둬요.
  • 전파된 점수는 부모 점수 × 시냅스 가중치 × 노트 에너지 × 감쇠예요.
Memory · recall
taskdirecthop 1hop 20.910.840.720.460.410.350.300.170.15

해 보기: 노드를 선택하면 활성화를 작업까지 거슬러 따라갈 수 있어요

Given to the assistant

  • The team prefers a quiet place
    0.91
    guidelinedirect match
  • The weekend is 14 and 15 June
    0.84
    decisiondirect match
  • Two people need vegetarian meals
    0.46
    gotcha1 hop
  • Last year the venue was too far from the station
    0.17
    guideline2 hops

해 보기: 지점을 고르거나, 화살표로 옮기거나, 재생을 누르세요. 잠시 멈추면 다이어그램이 다시 스크롤을 따라가요.

6단계 중 4단계: 실행, 읽기 지점 5개 중 5번째: 웨이브 2 시작

어시스턴트가 작업을 그룹별로 처리해요

각 작업은 자기 어시스턴트에게 가요. 한 그룹의 작업은 동시에 실행되고, 다음 그룹은 기다려요.

내부 구조

plan(action: "run")은 자체 git 브랜치에서 실행기를 시작해요. 웨이브마다 대상 작업 하나당 에이전트 세션 하나를 시작하고, 한도까지(기본값 4) 병렬로 실행해요.

각 작업에는 프로젝트 메모리로 만든 프롬프트가 주어져요. 작업의 설명, 단계, 제약 조건, 연결된 노트, 맞는 페르소나와 스킬, 앞선 웨이브가 한 일의 요약이에요. 가드가 세션의 유휴 시간, 반복 호출, 타임아웃을 감시하고, 에이전트가 길을 벗어나면 힌트를 보내요.

plan(action: "run", plan_id, cwd, project_slug)plan(action: "run_status", plan_id)
  • 작업은 태그, 단계, 파일을 바탕으로 simple, complex, creative로 프로파일링돼요. 프로파일이 시간 한도와 비용 예산을 정해요.
  • Simple: 600 s와 $0.50. Complex: 3600 s와 $2.00. Creative: 1800 s와 $1.00.
  • 실행은 저장되므로 재시작한 뒤에도 재개할 수 있어요. plan(action: "cancel_run")은 실행을 멈춰요.
  • 작업을 위임하는 어시스턴트는 그 작업에 쓸 제공자와 모델을 지정할 수 있어요. plan(action: "delegate_task")는 provider, model, task_class를 받아요. 프로젝트가 그 제공자를 미리 허용해 두어야 해요.

해 보기: 지점을 고르거나, 화살표로 옮기거나, 재생을 누르세요. 잠시 멈추면 다이어그램이 다시 스크롤을 따라가요.

6단계 중 5단계: 검증, 읽기 지점 5개 중 5번째: 완료

확인을 통과하면 그룹이 끝나요

다음 그룹이 시작되기 전에 PO가 작업을 확인해요. 단계가 모두 닫혀야 하고, 변경 사항에 민감한 파일이 남아 있으면 안 돼요. 코드 프로젝트라면 PO는 빌드가 여전히 되는지도 확인해요.

내부 구조

웨이브가 끝나면 실행기는 다음 웨이브가 시작되기 전에 검증해요. 에이전트가 커밋을 만들었는지, 모든 단계가 completed 또는 skipped인지, 프로젝트가 빌드되는지, diff에 민감한 파일이 없는지 확인해요.

실행 자체가 상태 머신이에요. 라이프사이클 프로토콜이 approved에서 executing으로, 다시 post_run으로 이동하며, 모든 이동에는 명시적인 트리거가 필요해요. 에이전트가 실패하거나 타임아웃된 작업은 기본값으로 한 번 재시도하고, 오류를 컨텍스트로 넘겨요.

protocol(action: "transition", run_id, trigger: "child_completed")step(action: "get_progress", task_id)
  • 빌드 확인: 감지한 언어에 따라 cargo check, npm run build, go build ./....
  • 거부하는 민감한 파일: .env, credentials.json, *.pem, *.key 및 비슷한 파일.
  • 테스트는 선택 사항이며 기본값은 꺼짐이에요. plan-runner-reviewed는 사람을 위한 awaiting_review 상태를 더해요.

해 보기: 지점을 고르거나, 화살표로 옮기거나, 재생을 누르세요. 잠시 멈추면 다이어그램이 다시 스크롤을 따라가요.

6단계 중 6단계: 학습, 읽기 지점 6개 중 6번째: 회상으로 돌아가기

배운 것은 다음을 위해 저장돼요

작업이 끝나면 결정하고 배운 내용이 프로젝트 메모리에 다시 기록돼요. 다음 계획은 그것과 함께 시작해요.

내부 구조

작업이 완료되면 실행기는 모델을 호출하지 않고 기록해요. 커밋을 작업과 계획에 연결하고, git 로그로 컨텍스트 노트를 만들고, 결정을 영향을 받는 파일에 묶어요.

어시스턴트는 자기만 아는 것을 더해요. 대안이 붙은 결정, 경고, 패턴이에요. 함께 쓰인 노트는 서로 가까워져요. 한 번도 쓰이지 않은 노트는 에너지를 잃고 오래된 것이 돼요. 에피소드는 요청, 상태를 거친 경로, 결과를 기록해요. 다음 계획은 이 모든 것과 함께 3단계에서 시작해요.

decision(action: "add", task_id, rationale, alternatives)note(action: "create", note_type: "gotcha", content, anchors)episode(action: "collect", run_id, project_id)admin(action: "reinforce_neurons", note_ids)
  • 오래됨의 정도는 마지막 활동 이후 시간에 따라 커지고, 그 속도는 노트 유형에 따라 달라요. note(action: "confirm")이 이를 초기화해요.
  • 스킬은 강하게 연결된 노트의 클러스터에서 생겨나요(admin(action: "detect_skills")).

해 보기: 지점을 고르거나, 화살표로 옮기거나, 재생을 누르세요. 잠시 멈추면 다이어그램이 다시 스크롤을 따라가요.

역할

누가 무엇을 하나요

PO가 기계적인 일을 맡아서, 어시스턴트는 작업 자체에 집중할 수 있어요.

PO가 요청받지 않아도 하는 일

  • 작업을 그룹으로 정렬하고 어시스턴트를 시작해요.
  • 각 그룹을 확인해요. 단계가 닫혔는지, 민감한 파일이 없는지, 코드 프로젝트라면 빌드가 되는지예요.
  • 변경 사항을 작업에 연결하고, 일어난 일에 대한 노트를 써요.
  • 실행마다 변경 사항을 자체 git 브랜치에 보관해요.
  • 어떤 페르소나와 스킬이 도움이 되었는지 기록해요.

어시스턴트가 도구로 하는 일

  • 시작하기 전에 노트와 결정을 검색해요.
  • 계획, 작업, 단계를 만들고 상태를 업데이트해요.
  • 대안과 영향 범위가 붙은 결정을 저장해요.
  • 경고, 지침, 패턴을 그 대상에 묶어서 써요.
  • 절차를 한 단계씩 앞으로 진행시켜요.

시작 지점

루프를 시작하는 세 가지 방법

AI 도구에서

PO에 연결된 Claude Code, Cursor 또는 다른 AI 도구예요. 원하는 결과를 설명하면, 계획하고, 순서를 정하고, 불러오고, 마지막에 배운 것을 저장해요.

채팅에서

PO에 내장된 채팅은 같은 어시스턴트와 대화해요. 각 메시지에는 관련 스킬, 적용되는 노트와 결정, 진행 중인 일이 함께 전달돼요. #을 입력하면 계획, 작업, 노트, 결정을 가리킬 수 있어요. 대화마다 엔진을 고를 수 있어요. 기본은 Claude Code이고 다른 엔진(알파)도 고를 수 있어요. 자동으로 두면 PO가 모델을 고르지만, 직접 고른 모델은 절대 바뀌지 않아요. 대화 위의 타임라인에서 무엇이 실행됐고 얼마나 걸렸는지 볼 수 있어요. 어시스턴트가 바쁠 때 보낸 메시지는 서버가 관리하는 대기열에서 기다리므로, 대화를 바꾸거나 새로고침해도 사라지지 않아요. 네이티브 엔진, Codex, ACP에서는 서버 재시작으로 끊긴 턴이 스스로 재개돼요. Claude Code 턴은 눈에 보이는 오류로 닫히고, 다음에 보내는 메시지가 대화를 이어 가요.

혼자서

계획은 아무도 없을 때도 실행될 수 있어요. 일정에 따라 또는 이벤트가 일어났을 때 시작하고, 두 번의 시작 사이에 간격을 둬요. 시작 유형은 schedule, webhook, event, chat이에요.

메모리

PO는 내가 결정하고 배운 것을 기억해요

노트와 결정, 그리고 그 사이의 연결이 프로젝트에 붙어 있어요. PO는 쓸모가 있을 때 그것을 다시 찾아 줘요. 스크롤해서 메모리가 자라는 모습을 보세요.

  1. 1

    파일이 점이 돼요

    PO는 프로젝트에 있는 것에서 시작해요. 문서, 스프레드시트, 파일이에요. 각각이 파란 점이에요.

  2. 2

    계획과 작업이 합류해요

    계획과 작업이 같은 그림에 더해져요. 각 작업은 건드리는 파일에 연결돼요.

  3. 3

    노트와 결정이 연결된 채로 남아요

    배운 것은 노트가 되고, 결정한 것은 결정이 돼요. 둘 다 파일과, 그리고 서로 연결된 채로 남아요.

  4. 4

    같은 주제의 항목이 서로 가까이 모여요. 프로젝트의 주요 주제가 한눈에 보여요.

  5. 5

    질문을 하면 PO가 맞는 노트를 찾아요(청록색). 그다음 연결을 따라 관련 항목(보라색)으로 가요. 단어가 달라도 찾아요.

메모리

지어낸 예시예요. 작은 행사 프로젝트고, 그래프의 이름은 설명용이며 내 데이터가 아니에요. 색과 모양은 제품 그래프와 같아요.

내부 구조: 연결의 이름

제품이 그래프의 연결에 쓰는 이름이에요. PO를 쓰는 데는 몰라도 돼요.

  • CONTAINS계획은 자기 작업을 포함해요.
  • IMPORTS파일이 다른 파일을 사용해요.
  • AFFECTS작업이 파일을 건드려요.
  • CO_CHANGED코드 이력에서 자주 함께 바뀌는 두 파일.
  • SYNAPSE노트, 결정, 파일 사이의 연결. 아무도 쓰지 않는 연결은 희미해져요.

체험해 보기

어시스턴트가 PO와 일하는 모습 보기

요청 하나를 고르세요. 쉬운 말로 된 답변과, 어시스턴트가 뒤에서 PO에 보내는 호출이 보여요. 호출을 열면 자세한 내용을 볼 수 있어요.

Chat · team-weekend시뮬레이션 데모
Organize a weekend in June for my team of 12. We want a quiet place near a train station.

Two notes apply: the place must be close to a train station, and last year the menu had nothing vegetarian. I will write the plan around both.

The plan has 3 tasks in 2 waves. The shortlist and the date poll do not depend on each other, so they happen at the same time. Booking waits for both.

미리 작성된 답변이에요. 서버에는 연결하지 않아요.

해 보기: 요청을 직접 입력하고, 호출을 열어 자세히 보고, 전체 대화를 복사하세요.

시뮬레이션 데모예요. 답변은 미리 작성되어 있고 서버에는 연결하지 않아요. 호출과 인자는 실제와 같아요.

시작하기

에이전트에게 메모리와 계획을 주세요

오케스트레이터를 설치하고, MCP로 어시스턴트를 연결하고, 첫 에이전트가 한 줄을 쓰기 전에 프로젝트부터 읽게 하세요.

앱은 무료예요. 이미 쓰고 있는 AI, 예를 들어 내 Claude Code 구독이나 다른 모델의 키에만 돈을 내면 돼요. 비용 확인하기

또는 터미널에서 시작하기

brew install this-rs/tap/project-orchestrator