MoAI-ADK
명세 기반 계획·실행·정리를 강제하는 검증 중심 하네스
curl -fsSL https://adk.mo.ai.kr/install.sh | bash모델은 토큰 단위로 움직이는 확률적 작업자라 지난 턴에 무엇을 얼마나 썼는지, 결과가 좋은지, 어디까지 갔는지를 스스로 기억하지 못한다는 전제에서 출발합니다. 하네스가 그 세 가지를 바깥에서 강제합니다. 명세를 앞에 두고 계획과 실행, 정리를 순서대로 돌리며 품질 관문을 통과시킵니다. 3.1 의 칸반 모드는 한 단위 작업을 네 개 터미널로 나눕니다. 주도 세션이 사슬을 이끌고 동반 세션 셋이 각각 하나의 열만 맡아 그 열의 맥락만 들고 갑니다. 열마다 다른 백엔드와 노력 수준을 골라 붙일 수 있습니다. 고 실행 파일 하나이고 열여섯 개 언어를 지원하며 한국어 문서가 있습니다.
판단
이럴 때 씁니다
- 명세 없이 바로 코드를 쓰는 것이 문제일 때
- 한 세션의 맥락 한도가 계속 걸릴 때
- 열마다 다른 모델과 노력 수준을 쓰고 싶을 때
이럴 땐 쓰지 마세요
- 작은 수정에는 절차가 과합니다
- 터미널을 네 개 띄워야 하는 구성이 부담일 수 있습니다
- 동반 세션은 손으로 띄워야 합니다
차별점
- 한 단위 작업을 네 세션으로 나눠 각자 한 열의 맥락만 들게 합니다.
- 열마다 다른 백엔드와 노력 수준을 붙입니다.
- 검토를 별도 열로 두지 않고 정리 관문이 흡수합니다.
- 고 실행 파일 하나이고 한국어 문서를 제공합니다.
워크플로
- 01설치 스크립트로 깝니다.
- 02명세를 먼저 씁니다.
- 03주도 세션을 열어 사슬을 시작합니다.
- 04동반 세션 셋을 각 터미널에서 띄웁니다.
- 05계획과 실행, 정리를 열 단위로 진행합니다.
주요 명령
| 명령 | 설명 |
|---|---|
curl -fsSL https://adk.mo.ai.kr/install.sh | bash | 설치합니다. |
moai cc -k | 주도 세션을 엽니다. 실행 식별자를 알리고 사슬을 시작합니다. |
moai cc -k --name plan | 동반 세션을 자기 터미널에서 띄웁니다. |
함정
설치 전에 확인하세요
- 동반 세션은 손으로 하나씩 띄워야 합니다. 세션이 다른 세션을 만들지 않습니다.
- 실행 식별자는 주도 세션의 것입니다. 동반 세션 이름에는 붙지 않습니다.
- 같은 역할을 주장하는 두 번째 세션은 다음 번호를 가져갑니다.
- 네 개 터미널을 쓰는 구성이라 화면 배치를 미리 잡아 두는 편이 낫습니다.
비교
절차를 강제하는 도구는 대개 한 세션 안에서 단계를 나눕니다. 그러면 앞 단계의 맥락이 끝까지 따라다닙니다. 이쪽은 세션 자체를 나눠 그 짐을 없앱니다. 대신 터미널을 여러 개 운영해야 합니다.
최근 변경
상태줄을 손본 판입니다. 저장소 이름 뒤의 숫자 쌍이 깃 앞뒤 차이 대신 열린 이슈와 열린 변경 요청 수를 나타냅니다. 앞뒤 차이는 이제 표시되지 않습니다.