AI 튜토리얼

MCode Stack으로 더 나은 AI 코딩 워크플로 구축하기

MCode Stack을 설치하고 개별 스킬 또는 전체 플러그인 스택을 실행하는 방법을 알아보세요. AI 지원 계획 수립, 컨텍스트 관리, 장시간 세션, 코드 검토, 실험 및 긴급 변경 작업을 개선할 수 있습니다.

2026년 10월 28일약 11분 소요

MCode Stack이란?

MCode Stack은 MiniMax Code 팀이 사용하는 워크플로, 스킬, 체크리스트를 모은 오픈 소스 컬렉션입니다. 실용적인 엔지니어링 습관을 직접 MiniMax Code에 설치할 수 있는 실행 가능한 SKILL.md 파일로 변환합니다.

이 저장소는 일반적인 프롬프트 라이브러리나 정적인 모범 사례 목록이 아닙니다. 리소스는 AI 지원 개발에서 반복적으로 발생하는 실제 의사결정을 다룹니다. 예를 들어 작업을 서브에이전트에 위임할지, 컨텍스트를 어떻게 관리할지, 명령을 얼마나 오래 실행할지, 세션 간 상태를 어떻게 보존할지, AI가 작성한 코드를 어떻게 독립적으로 검토할지 등을 다룹니다.

MCode Stack에는 MiniMax Code의 소스 코드 자체가 아니라 워크플로와 스킬이 포함되어 있습니다.

주요 기능

실행 가능한 스킬: 이름으로 스킬을 호출하거나 에이전트가 설명을 바탕으로 스킬을 로드하도록 할 수 있습니다.
대화형 체크리스트: 에이전트가 프로젝트를 항목별로 점검하도록 하거나, 일반 텍스트 버전을 직접 읽을 수 있습니다.
문서화된 워크플로: 개별 기여자가 일상적인 업무에서 MiniMax Code를 사용하는 방식을 살펴볼 수 있습니다.
플러그인 패키징: 전체 스택을 하나의 MiniMax Code 플러그인으로 설치할 수 있습니다.
마켓플레이스 지원: 저장소를 마켓플레이스로 추가하고, 해당 기능을 지원하는 환경에서 스택을 설치 가능한 플러그인으로 관리할 수 있습니다.
이식 가능한 형식: 공통 SKILL.md 형식을 사용하므로 스킬을 지원하는 다른 에이전트에서도 많은 스킬을 사용할 수 있습니다.

Ronny Stack의 범위

첫 번째이자 가장 완성도 높은 스택은 stacks/ronny입니다. 15개의 스킬이 일반적인 엔지니어링 작업 단계를 중심으로 구성되어 있습니다.

계획 및 분할: 서브에이전트를 사용할 시점을 결정하고, 큰 변경 사항을 작은 풀 리퀘스트로 나누며, 유용한 변경 설명을 작성합니다.
컨텍스트 및 도구: 도구 비용을 점검하고 모든 요청에 주입되는 콘텐츠를 파악합니다.
장시간 세션 및 명령: 압축, 메모리, 인계, 셸 명령, 백그라운드 작업을 관리합니다.
검토: 독립적인 검토를 수행하고, 코드 상태를 평가하며, 검토 의견을 작성하고, 피드백에 대응합니다.
실험 및 긴급 수정: 통제된 하니스 실험을 실행하고, 에이전트의 작업 과정을 검토하며, 긴급 변경 사항을 안전하게 처리합니다.

스킬 하나 설치하기

전체 컬렉션을 활성화하지 않고 MCode Stack을 평가하려면 스킬 하나를 설치하는 것이 좋습니다. 다음 예시는 모든 프로젝트에서 사용할 수 있도록 long-command-check를 설치합니다.

git clone https://github.com/MiniMax-AI/mcode-stack.git ~/mcode-stack
mkdir -p ~/.agents/skills
cp -R ~/mcode-stack/stacks/ronny/skills/long-command-check ~/.agents/skills/

새 MiniMax Code 세션을 시작하고 다음을 입력합니다.

/skills

설치한 스킬이 목록에 표시됩니다. 다음 명령으로 직접 실행할 수 있습니다.

/long-command-check

관련 작업을 설명하고 에이전트가 설명을 바탕으로 스킬을 로드하도록 할 수도 있습니다.

프로젝트 또는 전역 스킬 디렉터리 선택

MiniMax Code는 여러 위치에서 스킬을 검색합니다. 각 스킬은 SKILL.md 파일이 포함된 자체 하위 디렉터리를 가지고 있어야 합니다.

프로젝트별 디렉터리:

.minimax/skills/
.claude/skills/
.agents/skills/

전역 디렉터리:

~/.agents/skills/
~/.claude/skills/
~/.codex/skills/

스킬을 하나의 저장소에만 적용하려면 프로젝트 디렉터리를 사용합니다. 모든 프로젝트에서 사용할 수 있게 하려면 전역 디렉터리를 사용합니다.

전체 스택을 플러그인으로 설치하기

전체 Ronny 스택을 로컬에서 사용하려면 먼저 MiniMax Code의 플러그인 디렉터리를 찾습니다.

mcode plugin marketplace list

해당 명령으로 표시된 로컬 플러그인 디렉터리에 stacks/ronny 디렉터리 전체를 복사합니다. 그런 다음 MiniMax Code에서 /plugins를 열고 Ctrl+R을 눌러 패널을 새로 고칩니다.

디렉터리가 존재하는 즉시 로컬 플러그인이 설치됩니다. 플러그인 패널에서 Space 키를 눌러 활성화하거나 비활성화할 수 있습니다.

mcode plugin add 명령은 공식 카탈로그에서만 설치합니다. GitHub URL이나 로컬 경로는 허용하지 않습니다.

마켓플레이스를 통해 설치하기

이 저장소를 플러그인 마켓플레이스로 사용할 수도 있습니다. MiniMax Code 데스크톱에서 Plugins를 열고 Add marketplace를 선택한 다음 다음을 입력합니다.

MiniMax-AI/mcode-stack

그러면 각 스택이 설치, 업데이트 또는 제거할 수 있는 플러그인으로 표시됩니다. 마켓플레이스 지원은 점진적으로 제공되고 있으므로 모든 MiniMax Code 버전에서 이 옵션이 아직 표시되지는 않을 수 있습니다.

Claude Code에서 카탈로그 사용하기

동일한 플러그인 카탈로그를 Claude Code에 추가할 수 있습니다.

/plugin marketplace add MiniMax-AI/mcode-stack
/plugin install ronny@mcode-stack

호환성은 스킬에 따라 다를 수 있지만, 공통 SKILL.md 형식은 스킬을 지원하는 에이전트 간에 작동하도록 설계되었습니다.

기본 사용 예시

장시간 실행 명령 점검하기

느리게 실행될 수 있는 빌드, 테스트, 마이그레이션 또는 백그라운드 작업을 시작하기 전에 다음을 호출합니다.

/long-command-check

이 스킬은 긴 셸 명령과 백그라운드 작업에 대해 10개 항목의 감사를 수행합니다. 감사 결과를 바탕으로 명령을 어떻게 실행하고 진행 상황을 어떻게 모니터링할지 결정하세요.

서브에이전트를 사용할지 결정하기

작업을 병렬화할 수 있지만 위임이 도움이 될지 확신이 서지 않을 때 다음을 실행하세요.

/subagent-split-check

이 스킬은 작업을 서브에이전트에 맡길지 메인 루프에 남겨 둘지 결정하는 데 도움을 줍니다. 에이전트를 더 추가하기 전에 컨텍스트를 관리한다는 저장소의 더 큰 원칙을 따릅니다.

세션 인계 준비하기

새 세션에서 계속해야 하는 작업에는 다음을 호출하세요.

/handoff-doc

생성된 인계 문서는 다른 세션이 필요한 상태를 유지한 채 작업을 재개할 수 있도록 도와줍니다. 요약할지, 정보를 파일에 기록할지, 현재 세션을 압축할지, 처음부터 다시 시작할지 결정할 때는 /long-session-check와 함께 사용하세요.

깨끗한 컨텍스트에서 검토하기

다음을 사용하세요.

/independent-review

이 스킬은 변경 사항을 diff, 요구 사항, 테스트 결과만 포함하는 깨끗한 컨텍스트에서 검토합니다. 설계, 기능, 복잡도, 테스트, 승인 위험을 포괄적으로 평가하려면 다음을 사용하세요.

/engineering-code-review

고급 워크플로 팁

개발 단계별로 스킬 조합하기

모든 작업에서 모든 스킬을 실행하기보다 현재 작업 단계에 따라 스킬을 선택하세요.

계획: subagent-split-check와 engineering-small-prs로 시작하세요.
컨텍스트 제어: tool-budget-audit와 context-tax-audit를 사용하세요.
연속성 유지: long-session-check, handoff-doc, long-command-check를 적용하세요.
검토: independent-review와 engineering-code-review를 실행한 다음 필요에 따라 검토 댓글 및 피드백 스킬을 사용하세요.
변경 사항 평가: harness-experiment와 trajectory-review를 사용해 결과와 에이전트가 거친 경로를 모두 살펴보세요.

워크플로 파일 점검하기

스택에는 스킬, 체크리스트, 그리고 WORKFLOW.md 파일이 포함될 수 있습니다. 스킬은 실행 가능한 리소스이고, WORKFLOW.md는 스택 작성자가 에이전트와 협업하는 방식을 설명합니다. 전체 스택을 도입하기 전에 워크플로를 읽고 각 요소가 어떻게 연결되는지 이해하세요.

실험을 통제된 방식으로 유지하기

harness-experiment 스킬은 소규모 평가, 한 번에 하나의 변경, 반복 실행, 결과가 달라진 작업의 검사를 강조합니다. trajectory-review와 함께 사용해 테스트 통과 여부만 보는 대신 에이전트가 결과에 도달한 과정을 살펴보세요.

워크플로에 맞게 스택 조정하기

이 프로젝트는 하네스 엔지니어링을 발전하는 실무 분야로 봅니다. 스킬을 프로젝트별 디렉터리에 복사하거나 환경에 맞게 수정하거나, 모든 것을 설치하는 대신 필요한 부분만 모아 사용할 수 있습니다. 스택을 가상의 프롬프트 모음으로 만들기보다 실제 사용에 기반해 변경하세요.

자신만의 스택 기여하기

이 저장소는 MiniMax Code 또는 다른 에이전트와 함께하는 실제 일상 워크플로를 기반으로 한 스택을 환영합니다.

templates/stack-template/을 community/<your-id>/로 복사하세요.
에이전트에 무엇을 위임하고 무엇을 직접 모니터링하는지 설명하는 WORKFLOW.md를 작성하세요.
실제로 사용하는 스킬 또는 체크리스트를 하나 이상 추가하세요.
다음 명령으로 기여 내용을 검증하세요.

node scripts/check.mjs

검증 출력과 실제 사용 기록을 간략히 정리한 내용을 포함해 풀 리퀘스트를 제출하세요. 전체 기여 요건은 CONTRIBUTING.md를 참조하세요.

라이선스 참고 사항

MCode Stack은 일반적으로 MIT 라이선스로 제공되지만, 스택의 NOTICE.md에 다르게 명시된 경우는 예외입니다. 6개의 engineering-* 스킬은 Google Engineering Practices를 바탕으로 수정되었으며, 해당 수정 자료는 CC-BY 3.0 라이선스를 따릅니다.

결론

MCode Stack은 검증된 AI 지원 엔지니어링 습관을 바로 실행할 수 있도록 합니다. 먼저 long-command-check와 같은 스킬 하나로 시작한 다음, 워크플로에 적합하다면 전체 플러그인 스택을 도입하세요. 계획 수립, 컨텍스트 제어, 세션 관리, 독립적 검토, 통제된 실험을 결합하면 AI가 작성한 코드를 더욱 체계적으로 다루는 프로세스를 구축할 수 있습니다.