본문으로 건너뛰기

개발자를 위해 · “vibe the project” 뒤에 있는 기계

Motir 작동 방식

모든 Motir 프로젝트는 같은 장치를 거칩니다. 모듈은 Motir와 에이전트입니다. 노브와 스위치는 당신의 것입니다: 사람이 돌리기 전에는 아무것도 진행되지 않습니다.

Motir와 에이전트당신이 결정

모듈 랙으로 표현한 Motir 워크플로아이디어가 플래너로 연결되고, 계획을 승인하는 노브, 보드, 에이전트 실행, 검토하고 병합하는 노브를 거쳐 완료에 이릅니다. 수동 작업은 보드에서 완료로 바로 갑니다. 에이전트 실행은 발견한 버그를 버그 폴더에 기록하고 계속 진행할 수 있습니다. 복구 모듈은 실패한 실행을 에이전트 실행으로 되돌립니다. 학습 루프는 에이전트 실행에서 판정, 재계획, 교훈 라이브러리를 거쳐 다시 플래너로 이어집니다. 하단의 메모리 뱅크에는 디자인, 결정, 문서, 교훈, 실행 이력, 개정 내역, 누가 무엇을 결정했는지가 보관됩니다.

그림을 옆으로 스크롤하세요 →

모듈별로 살펴보기

위 그림의 각 모듈을 가까이서 살펴봅니다. 마우스를 올리면 그림에서 위치를 찾을 수 있습니다.

[01] AI 계획

프롬프트에서 계획으로

한 문장, 저장소, 또는 Jira, Linear, Plane에서 가져온 프로젝트로 시작하세요. 플래너는 저장소의 코드 그래프를 포함해 이미 있는 것을 읽고, 요청이 모호한 곳에서는 추가 질문을 합니다.

에픽, 스토리, 작업, 하위 작업을 작성하며, 각각에 유형, 실행 주체, 크기, blocked_by 관계를 지정합니다. validate_plan이 당신에게 보여 주기 전에 트리를 검사합니다.

[02] 당신 · 계획 게이트

계획은 당신이 승인합니다

사람이 계획을 승인하기 전에는 아무것도 보드에 올라가지 않습니다. 평소 말투로 변경을 요청하세요. 매번 새로운 차례가 되며, 계획 이력에는 모든 버전과 바뀐 이유가 남습니다.

[03] 작업 항목

보드

승인된 계획은 Sprint, 백로그, 로드맵을 갖춘 작업 항목이 됩니다. 각 작업 항목의 실행 주체는 agent 또는 human입니다.

수동 작업(계정, 시크릿, DNS 레코드, 릴리스 승인)은 motir guide가 한 단계씩 안내합니다.

[04] 에이전트 실행

에이전트가 만듭니다

에이전트는 다음 준비된 작업 항목을 맡아(motir next 또는 motir run <KEY>) 확보하고, 자기 브랜치에서 구현한 뒤 저장소마다 풀 리퀘스트를 하나씩 열어 작업 항목에 연결합니다.

자기 작업 항목 밖에서 발견한 버그 때문에 실행이 멈추지 않습니다: 에이전트는 근본 원인을 찾고, motir log bug로 버그 폴더에 별도 작업 항목으로 등록한 뒤 계속 진행합니다.

각 실행은 에이전트 하네스, 모델, 모든 단계와 결과를 기록합니다. 에이전트는 MCP로 연결되며, 당신의 컴퓨터에서든 Motir의 호스팅 에이전트로든 실행할 수 있습니다.

[05] 당신 · 병합 게이트

검토와 병합은 당신이

작업 항목이 구현됨으로 이동하고 에이전트가 테스트 방법을 게시합니다. 스토리에는 CI에서 녹화한 인수 영상이 붙습니다. 당신이 검토하고, 승인하고, 병합하면 병합이 작업 항목을 닫습니다. 사람 없이는 아무것도 완료에 이르지 않습니다.

[06] 복구

실행이 깨졌을 때

실패했거나 충돌이 있는 풀 리퀘스트는 motir fix로 같은 브랜치에서 최대 다섯 번까지 복구됩니다. 중단된 실행(노트북을 닫았거나 샌드박스가 사라진 경우)은 motir continue로 남겨진 브랜치에서 재개됩니다.

도중에 기록된 버그는 버그 폴더에서 기다리며, motir fix bugs가 오래된 것부터 차례로 처리합니다.

[07] 학습 루프

플래너가 배웁니다

작업 항목을 만들 수 없는 에이전트는 먼저 그 항목이 여전히 승인된 계획 그대로인지 묻습니다(get_approved_shape_verdict). 그래서 이후의 수정이 플래너 탓으로 돌아가지 않습니다. 계획이 잘못되었다면 재계획되고, 변경 사항은 이유와 함께 기록됩니다.

실수는 새로운 교훈이 되거나 기존 교훈을 강화합니다. 다룰 규칙이 없으면 계획 버그가 등록됩니다. 다음 계획은 교훈을 먼저 읽습니다. 90일 동안 반복되지 않은 교훈은 은퇴합니다.

[08] 기억

프로젝트가 기억합니다

디자인, 결정 페이지, 문서, 교훈, 계획 개정 내역, 모든 실행의 이력이 작업 항목 바로 옆에 있습니다. 당신도, 새 팀원도, 다음 에이전트도 몇 달 뒤에 누구의 설명 없이 프로젝트를 이어받을 수 있습니다.

핵심은 오픈 소스

프로젝트 관리 핵심은 GPL-3.0 오픈 소스입니다. 직접 호스팅하거나 motir.co에서 사용하세요.