무엇이든 연결
이미 쓰는 것에 연결돼요
도구가 MCP를 쓰면, 어시스턴트는 Project Orchestrator를 통해 그 도구를 호출할 수 있어요. 절차가 상태와 트리거로 표현되면 프로토콜이 될 수 있어요. 각 항목은 오늘 무엇이 작동하는지 밝혀요.
해 보기: 연결 지점을 누르면 오늘 무엇을 하는지 볼 수 있어요.
- 사용 가능
상태와 트리거로 쓸 수 있는 모든 절차예요. 릴리스, 리뷰, 분류 등. 모든 실행은 기록돼요.
- 사용 가능
작업, 단계 또는 계획의 상태가 바뀔 때 실행되는 동작이에요. 어시스턴트 자체의 도구 루프 안에서 실행되는 훅도 있어요.
- 사용 가능
stdio, SSE 또는 streamable HTTP로 연결되는 MCP 서버예요. 어시스턴트는 이름으로 호출하고, 무엇인가를 바꾸는 호출은 기본적으로 차단돼요.
- 진행 중
Claude Code가 기본값이에요. 네이티브 엔진(OpenAI 호환 모델 전부), Codex, opencode 같은 ACP 에이전트, SSH를 통한 Claude Code에서도 에이전트를 실행할 수 있고, 대화를 한 엔진에서 다른 엔진으로 옮길 수 있어요. 이 엔진들은 알파 단계예요. 대역으로만 테스트했고 실제 서비스에서는 아직이에요.
- 사용 가능
17개 언어를 그래프로 분석해요. 누가 무엇을 호출하는지, 변경이 무엇에 닿는지, 프로젝트가 어떻게 구성돼 있는지 보여 줘요.
Project Orchestrator는 MCP 서버이기도 해요. Claude Code나 다른 MCP 클라이언트는 33개 도구를 통해 이것에 접근해요.
배우게 만드는 것
시스템이 간직하는 것과 그 방법
마법은 없어요. 각 카드는 무슨 일이 일어나는지, 언제 일어나는지, 무엇이 수동으로 남는지 알려 줘요. 열면 작동 원리를 읽을 수 있어요.
상태 기계로서의 절차
사용 가능프로토콜은 상태 기계예요. 상태와, 각각 이름 있는 트리거가 필요한 전이로 이루어져요. 모든 실행은 거쳐 간 상태와 함께 기록돼요.
작동 원리와 한계
일어나는 일
실행은 직접 시작하거나, 이벤트(프로젝트 동기화나 스킬 가져오기 후)나 일정(매시간, 매일 또는 매주)에 따라 시작돼요. 러너가 끝까지 진행시킬 수 있고, 판단이 필요한 상태는 Claude 세션에 넘겨져요.
수동으로 남는 것
전이에 쓰인 가드는 오늘 기준으로 어시스턴트를 위한 노트예요. 평가되지 않아요. 제안 절차만 PO가 직접 만들어요. 나머지는 직접 구성하거나 가이드에서 가져와요.
초안에서 구현까지의 Proposal
사용 가능Proposal은 RFC 유형의 노트예요. 그 생명주기는 초안에서 구현, 거절 또는 대체까지 아홉 상태로 이루어진 상태 기계예요.
작동 원리와 한계
일어나는 일
Proposal을 작성하면 그 실행이 시작돼요. 각 단계(제안, 검토 요청, 수락, 계획 시작, 작업 시작, 완료)는 내가 또는 어시스턴트가 발동하는 이름 있는 트리거이고, 실행은 기록을 남겨요.
수동으로 남는 것
Proposal을 계획에 연결하는 것은 어시스턴트가 하는 호출이에요. Proposal을 수락해도 계획의 작업이 스스로 만들어지지는 않아요.
나이 드는 메모리
사용 가능노트와 결정에는 중요도, 에너지, 신선도가 있어요. 그래서 오래되고 쓰이지 않는 것은 쌓이기만 하는 대신 가중치를 잃어요.
작동 원리와 한계
일어나는 일
백그라운드 점검이 스스로 실행돼요. 신선도는 매시간, 통합은 2시간마다(아무도 쓰지 않는 노트는 삭제되지 않고 보관돼요), 에너지와 링크 감쇠는 6시간마다 계산돼요. 14일 동안 쉬고 있는 프로젝트는 동결되므로, 쉬는 동안 지워지지 않아요.
수동으로 남는 것
검토가 필요하다고 표시된 노트는 자동으로 다시 쓰이지 않아요. 누군가 확인하거나, 고치거나, 폐기해야 해요.
사용할수록 강해지는 링크
사용 가능의미가 가까운 노트는 자동으로 연결돼요. 노트가 함께 쓰일 때마다 그 사이의 링크가 강해지고, 아무도 쓰지 않는 링크는 희미해져요.
작동 원리와 한계
일어나는 일
새 노트는 다른 노트와 비교되어 가까운 이웃과 연결돼요. 어시스턴트에게 전달되거나, 검색되거나, 커밋으로 건드려진 노트는 에너지와 더 강한 링크를 얻어요. 사용할 때마다 조금씩, 상한까지예요. 쓰이지 않는 링크는 6시간마다 가중치를 잃고, 바닥 아래로 내려가면 사라지며, 여전히 비슷한 것들은 작업이 다시 연결해요.
수동으로 남는 것
자동 연결에는 임베딩 제공자가 필요해요. 없으면 노트는 수동으로만 연결돼요. 검색은 처음 맞은 항목에서 두 단계 떨어진 링크까지만 따라가요, 그 이상은 가지 않아요.
스킬과 페르소나
사용 가능스킬은 서로 관련된 노트들의 묶음이에요. 작업이 그 주제에 닿을 때 어시스턴트에게 전달돼요. 페르소나는 한 분야에 특화된 어시스턴트로, 자체 한계를 가져요.
작동 원리와 한계
일어나는 일
묶음은 노트 사이의 링크에서 매일 찾아요(프로젝트에 노트 15개 이상, 묶음에 3개 이상). 스킬은 노트가 가깝게 연결되고 몇 번 쓰이면 떠오르는 상태에서 활성 상태가 되고, 30일 동안 쓰이지 않으면 휴면 상태가 돼요. 스킬과 페르소나는 내보내고 가져올 수 있어요.
수동으로 남는 것
프로젝트로부터 페르소나를 만드는 것은 내가 또는 어시스턴트가 하는 호출이에요. 일정으로 돌아가지 않아요. 시스템은 아직 어떤 스킬이 도움이 됐는지 배우지 못해요.
개선 루프
진행 중프로토콜 실행이나 계획이 끝나면 PO는 에피소드를 기록해요. 무엇이 시작했는지, 어떤 상태를 거쳤는지, 무엇을 만들었는지. 비슷한 에피소드가 세 개 쌓이면 노트를 쓰고 절차에 점검 항목을 추가할 수 있어요.
작동 원리와 한계
일어나는 일
에피소드는 스스로 모여요. 분석에는 비슷한 것이 최소 세 개 필요해요. 한 번에 노트를 최대 10개, 프로젝트당 50개까지 쓰고, 자동 학습으로 표시하며, 거의 중복인 것은 건너뛰고, 절차의 모든 변경은 결정으로 기록해요.
수동으로 남는 것
프로토콜이나 계획 러너를 거친 실행에서만 배워요. 결과가 실제로 나아지는지는 아직 측정되지 않으니, 자동 학습 노트를 직접 읽어 보세요. 프로토콜 안의 성찰 단계는 지시일 뿐이라, 어시스턴트가 따를 수도 있고 따르지 않을 수도 있어요.
상태가 바뀔 때마다 실행되는 훅
사용 가능라이프사이클 훅은 작업, 단계, 계획, 목표의 상태가 바뀔 때 동작을 실행해요. 그 아래 단계를 완료하거나, 노트를 만들거나, 경고를 띄우거나, 프로토콜을 시작할 수 있어요.
작동 원리와 한계
일어나는 일
훅은 프로젝트별로 또는 전체에 대해 저장되고, 우선순위에 따라 실행돼요. 실패한 훅은 기록되고 나머지는 계속 실행돼요. 기본 제공되는 훅 하나는 작업이 완료되면 그 작업의 단계를 완료해요. 어시스턴트 자체의 도구 루프 안에서는 각 도구 호출 전후와 맥락이 압축되기 전에 훅이 실행되어, 알맞은 스킬과 노트를 전달해요.
수동으로 남는 것
훅은 상태 변화에만 실행돼요. 외부 도구를 호출하는 동작은 아직 구현되지 않아서 제공되지 않아요.
궤적과 신경 라우팅
진행 중PO는 세션마다 어떤 도구가 호출됐고 결과가 어땠는지 경로를 기록해요. 그리고 새 요청과 비슷해 보이는 과거 경로를 검색할 수 있어요.
작동 원리와 한계
일어나는 일
기록은 기본으로 켜져 있고, MCP와 채팅의 도구 호출을 포함해요. 신경 라우팅은 요청에 가장 가까운 과거 경로를 찾아 대시보드용으로 기록해요.
수동으로 남는 것
라우팅 결과는 아직 어시스턴트가 받는 도구나 프롬프트를 바꾸지 않아요. 제품 안에서 학습 루프도 돌지 않아요. 오늘은 search similar나 stats로 경로를 직접 조회해야 해요.
활용 사례
여섯 가지 일, 단계별로
개발자를 위한 세 가지, 그 밖의 모두를 위한 세 가지. 각각 이전 상황, Project Orchestrator가 하는 일, 결과를 보여 줘요.
처음부터 다시 하지 않고 분류하는 빨간 CI
main에서 파이프라인이 실패해요. 원인, 수정, 다음을 위한 흔적을 알고 싶어요.
이전
빨간 빌드마다 새 대화가 시작돼요. 어시스턴트는 같은 로그를 다시 읽고, 이 테스트가 지난달에도 같은 방식으로 실패했다는 것을 몰라요.
- reproduce
- locate
- fix
- verify
원인은 파일에 연결된 함정 노트로 저장돼요. 다음에 어시스턴트가 그 파일을 건드리면, 편집하기 전에 그 노트가 다시 전달돼요.
해 보기: 단계를 차례로 보거나, 이전과 이후를 비교하세요.
Project Orchestrator가 하는 일
- 내 CI의 MCP 서버를 연결해요. 어시스턴트는 그것을 통해 실행과 로그를 읽을 수 있어요. 무엇인가를 바꾸는 호출은 허락하지 않는 한 차단된 상태로 남아요.
- 내가 구성한 프로토콜 ci-triage가 실행을 재현, 위치 찾기, 수정, 검증 순서로 진행시켜요. 각 이동에는 이름 있는 트리거가 필요하고, code · analyze_impact는 실패한 변경이 무엇에 닿는지 나열해요.
- 원인은 파일에 연결된 함정 노트로 저장돼요. 다음에 어시스턴트가 그 파일을 건드리면, 편집하기 전에 그 노트가 다시 전달돼요.
결과
단계가 있는 수정 작업, 다시 열 수 있는 기록된 실행, 대화보다 오래 남는 노트.
수동으로 남는 것
ci-triage 프로토콜은 한 번 직접 작성해야 하고(가이드에 템플릿이 있어요), CI 서버도 직접 연결해야 해요. PO는 스스로 CI를 지켜보지 않아요.
사용하는 기능 MCP 서버 · 프로토콜 · 코드 그래프 · 나이 드는 메모리
스레드 열두 개가 한 계획 안에 있는 팀 워크숍
장소, 음식, 초대장, 24명을 위한 기차편. 각각은 놓칠 수 있는 대화예요.
이전
어시스턴트와의 대화와 스프레드시트 사이를 오가요. 누가 무엇을 기다리는지, 무엇이 이미 결정됐는지 잊어버려요.
Organise the autumn team offsite
In progress계획에서 일하는 각 어시스턴트는 앞서 내린 결정과 노트를 찾아요. 예를 들어 식단이나 1인당 예산을요. 그래서 다시 묻지 않아요.
해 보기: 단계를 차례로 보거나, 이전과 이후를 비교하세요.
Project Orchestrator가 하는 일
- 목표 하나를 주면, PO가 이를 의존 관계가 있는 작업 계획으로 바꿔요. 장소와 음식 견적은 함께 시작하고, 초대장은 날짜를 기다려요.
- 선택은 이유와 함께 결정이 돼요. 내 허락이나 답이 필요한 어시스턴트는 묻고, 그 내용은 Today에 나타나요.
- 계획에서 일하는 각 어시스턴트는 앞서 내린 결정과 노트를 찾아요. 예를 들어 식단이나 1인당 예산을요. 그래서 다시 묻지 않아요.
결과
한 화면에서 무엇이 끝났고, 무엇이 실행 중이며, 무엇이 내 차례를 기다리는지 보여 줘요. 그리고 11월로 정한 날짜는 한 번 기록돼요.
수동으로 남는 것
PO는 계획을 세우고 대화를 이어 가요. 장소 예약에는 내가 연결한 도구가 필요하거나, 내가 직접 해야 해요.
사용하는 기능 계획과 결정 · 나이 드는 메모리
Proposal에서 계획과 그 작업으로
변경은 논의되고, 수락되고, 만들어져요. 결정이 스크롤 밖으로 밀려난 채팅에 남아 있으면 안 돼요.
이전
“세션 저장소를 Redis로 옮기자”는 대화에서 말해지고, 그다음 사라져요. 몇 주 뒤에는 아무도 그것이 받아들여졌는지 몰라요.
- draft
- proposed
- under review
- accepted
- planning
- in progress
- implemented
수락되면 어시스턴트가 계획을 만들고 Proposal과 연결해요. 작업에는 의존 관계가 생겨서, 독립적인 작업은 함께 실행돼요.
해 보기: 단계를 차례로 보거나, 이전과 이후를 비교하세요.
Project Orchestrator가 하는 일
- RFC 노트인 Proposal을 작성해요. 실행은 초안에서 시작하고, 각 이동(제안, 검토 요청, 수락)은 이름 있는 트리거예요.
- 수락되면 어시스턴트가 계획을 만들고 Proposal과 연결해요. 작업에는 의존 관계가 생겨서, 독립적인 작업은 함께 실행돼요.
- 작업이 시작되고 끝나면 Proposal은 진행 중, 그다음 구현됨으로 이동하고, 그 기록에 각 단계가 남아요.
결과
누구든 그 변경이 받아들여졌는지, 왜 그런지, 그리고 어떤 계획이 그것을 수행하는지 볼 수 있어요.
수동으로 남는 것
Proposal과 계획 사이의 연결은 어시스턴트가 하는 호출이에요. Proposal을 수락해도 작업이 스스로 만들어지지는 않아요.
사용하는 기능 Proposal · 계획과 결정 · 프로토콜
지원금 신청서, 항목별로
지침, 예산, 지지 서한, 마감일. 여기에는 코드가 하나도 없어요.
이전
공고의 규칙은 PDF에, 수치는 스프레드시트에 있고, 어시스턴트는 대화 사이에 둘 다 잊어버려요.
노트는 나이가 들어요. 오랫동안 확인되지 않은 노트는 검토가 필요하다고 표시돼서, 오래된 예산 상한이 본문에 들어가기 전에 점검돼요.
해 보기: 단계를 차례로 보거나, 이전과 이후를 비교하세요.
Project Orchestrator가 하는 일
- 코드 없이 프로젝트를 만들고 목표를 주세요. PO는 신청서 항목마다 작업을 하나씩 계획하고, 마감일을 목표로 삼아요.
- 규칙과 수치는 노트와 결정이 돼요. 예: “공고 마감은 3월 15일”, “지역 공고에 지원하기”.
- 노트는 나이가 들어요. 오랫동안 확인되지 않은 노트는 검토가 필요하다고 표시돼서, 오래된 예산 상한이 본문에 들어가기 전에 점검돼요.
결과
항목별 체크리스트, 어시스턴트가 의존하는 사실들, 그리고 오래되었을 수 있는 것에 붙은 표시.
수동으로 남는 것
표시된 노트는 누군가 확인하거나 고쳐야 해요. PO는 무엇이 오래되었는지 표시할 뿐, 어떤 수치가 아직 맞는지는 알지 못해요.
사용하는 기능 계획과 결정 · 나이 드는 메모리
스스로 시작되는 릴리스 주기
마지막 작업이 끝나면, 누군가 기억하지 않아도 릴리스 체크리스트가 시작돼야 해요.
이전
체크리스트는 누군가의 머릿속에 있어요. 바쁜 주에는 단계가 빠지고, 릴리스마다 조금씩 다르게 진행돼요.
- freeze
- verify
- tag
- announce
각 실행은 에피소드로 기록돼요. 비슷한 에피소드가 세 개 쌓이면, PO는 자꾸 실패하는 것에 대한 노트를 쓰고 절차에 점검 항목을 추가할 수 있어요.
해 보기: 단계를 차례로 보거나, 이전과 이후를 비교하세요.
Project Orchestrator가 하는 일
- release-checklist 프로토콜을 구성해요: 동결, 검증, 태그, 공지.
- 릴리스 계획이 완료 상태가 되면 라이프사이클 훅이 그것을 시작해요. 또 다른 기본 훅은 작업이 완료될 때 그 작업의 단계를 완료해요.
- 각 실행은 에피소드로 기록돼요. 비슷한 에피소드가 세 개 쌓이면, PO는 자꾸 실패하는 것에 대한 노트를 쓰고 절차에 점검 항목을 추가할 수 있어요.
결과
체크리스트는 스스로 시작하고, 모든 실행은 기록을 남기며, 반복되는 실패는 노트가 돼요.
수동으로 남는 것
처음 두 단계는 지금 사용할 수 있어요. 마지막 단계는 진행 중이에요. 프로토콜을 거친 실행에서만 배우고, 릴리스가 나아지는지는 아직 측정되지 않아요. 자동 학습 노트를 읽어 보세요.
사용하는 기능 훅 · 프로토콜 · 개선 루프
네 명의 여행, 매번 지난 여행에서 시작해요
항공편, 숙소, 일정, 그리고 다시 말하고 싶지 않은 선호.
이전
매번 처음부터 계획해요. 탭, 메시지, 같은 질문들: 음식, 날짜, 예산.
주제에 대한 노트가 충분하면, 그 묶음에서 스킬이 생기고, 여행 이야기를 할 때 어시스턴트에게 전달돼요. 30일 동안 쓰이지 않으면 휴면 상태가 돼요.
해 보기: 단계를 차례로 보거나, 이전과 이후를 비교하세요.
Project Orchestrator가 하는 일
- 목표와 날짜를 주세요. PO는 작업을 계획해요. 항공편과 숙소는 함께 검색할 수 있고, 일정은 둘 다를 기다려요.
- 말한 선호는 노트가 돼요. 예: 채식 식사 두 번, 야간 기차 없음. 함께 쓰인 노트는 연결되고, 그 링크는 쓸 때마다 강해져요.
- 주제에 대한 노트가 충분하면, 그 묶음에서 스킬이 생기고, 여행 이야기를 할 때 어시스턴트에게 전달돼요. 30일 동안 쓰이지 않으면 휴면 상태가 돼요.
결과
다음 여행은 지난 여행이 가르쳐 준 것에서 시작하고, 더 이상 쓰지 않는 선호는 희미해져요.
수동으로 남는 것
자동 링크를 쓰려면 노트가 충분한 프로젝트(최소 15개)와 임베딩 제공자가 필요해요. PO는 계획하고 기억해요. 예약은 하지 않아요.
사용하는 기능 계획과 결정 · 링크 · 스킬