MarsDawn

에이전트의 계획을 5분 안에 검토하는 법

에이전트가 계획을 작성하고 승인을 기다리고 있습니다. 주어진 시간은 한 시간이 아니라 5분입니다. 일반 텍스트 에디터를 포함해 어떤 에디터에서든 통하는 활용법을 소개합니다. MarsDawn은 몇몇 단계에서 도움이 되며, 어느 단계인지 함께 알려 드립니다. 가장 중요한 단계에서는 도움이 되지 않습니다.

계획을 위에서부터 차례로 읽지 마세요. 구조를 확인하고, 주장 하나를 직접 검증하고, 되돌릴 수 없는 작업을 찾고, 다이어그램과 범위를 살핀 다음, 에이전트가 바로 반영할 수 있는 피드백을 쓰세요. 6단계, 약 5분입니다.

실행 전에 신경 써야 하는 이유

Chip Huyen은 계획과 실행을 분리해야 하는 이유를 설명하며 비용을 단도직입적으로 말합니다. “감독이 없으면 에이전트는 그 단계들을 몇 시간이고 실행하며 API 호출에 시간과 돈을 낭비할 수 있고, 그동안 여러분은 그것이 아무 데도 이르지 못한다는 사실을 깨닫지 못할 수 있습니다.” 저희가 덧붙이자면, 계획은 실수를 잡아내기에 가장 저렴한 곳입니다. plan.md의 한 줄을 고치는 데는 문장 하나면 됩니다. 에이전트가 실행한 뒤에 고치려면 오후 한나절이 걸립니다.

예시

사용자 아바타를 기존 링크가 깨지지 않게 오브젝트 스토리지로 옮겨 달라고 에이전트에게 요청했다고 해 봅시다. 에이전트가 이런 계획을 돌려줍니다.

# Plan: move user avatars to object storage

## Goal
Serve avatars from object storage instead of the app server.

## Steps
1. Add a storage client and config. ✅ done
2. Write a script that copies existing avatars to the bucket.
3. Switch the avatar URLs in the templates.
4. Delete `public/avatars/` from the server.
5. Run the copy script.

## Status
All tests pass.

깔끔하게 읽힙니다. 그런데 이대로라면 아바타를 하나도 복사하기 전에 전부 삭제하게 됩니다.

6단계

1. 제목만 읽으세요. (약 1분) 계획이 요청한 내용과 맞나요? 섹션이 빠져 있다면 대개 작업도 빠져 있습니다. 여기에는 Goal, Steps, Status가 있습니다. 기존 링크가 계속 작동해야 한다고 요청했는데, 기존 링크나 변경을 되돌리는 방법을 다루는 제목이 없습니다. 이것이 첫 번째 코멘트입니다.

터미널에서는 grep -n '^#' plan.md로 제목만 볼 수 있고, 대부분의 에디터도 개요를 보여 줍니다. MarsDawn에서는 사이드바의 개요 탭(보기 ▸ 사이드바 보기, ⌃⌘S)에 제목이 나열되고, 클릭하면 해당 위치로 이동합니다.

2. 무언가가 완료됐다, 통과했다, 확인됐다고 주장하는 곳을 모두 찾고, 그중 하나를 직접 확인하세요. (약 1분) 파일을 열고, 테스트를 실행하고, 행 수를 세어 보세요. Chip Huyen은 “에이전트가 작업을 완료하지 않았는데도 완료했다고 확신하는” 실패를 설명합니다. 그의 예시에서는 50명을 호텔 객실 30개에 배정하라는 요청을 받은 에이전트가 40명만 배정하고 완료했다고 말합니다.

grep -n -i -E 'done|pass|verified|✅' plan.md

여기서는 “✅ done”과 “All tests pass.”가 걸립니다. 어떤 테스트일까요? 그중 아바타와 관련된 테스트가 있나요? 직접 실행하거나 물어보세요. 이 단계는 MarsDawn이 대신할 수 없습니다. 여러분 말고는 아무도 할 수 없습니다.

3. 되돌릴 수 없는 단계를 찾으세요. (약 1분) 데이터 삭제, 마이그레이션, force-push, 무언가를 보내거나 결제하거나 게시하는 모든 작업입니다. 이런 단계는 여러분의 명시적인 승인을 기다려야 합니다. Chip Huyen은 같은 생각을 시스템 쪽에서 설명합니다. “계획에 데이터베이스 업데이트나 코드 변경 병합처럼 위험한 작업이 포함되어 있다면, 시스템은 실행 전에 사람의 명시적 승인을 요청하거나 사람이 직접 실행하도록 할 수 있습니다.” 여기서는 4단계가 원본을 삭제하는데, 복사하는 5단계보다 앞에 있습니다.

4. 렌더링된 다이어그램을 읽고, 화살표 하나하나를 본문과 대조하세요. 순서도에는 “복사 → 확인 → 삭제”라고 되어 있는데 단계 설명은 다르다면, 그것이 발견입니다. 이 계획에는 다이어그램이 없으니 오늘은 넘어갑니다. 다이어그램이 있다면 Mermaid 소스가 아니라 이미지를 보세요. 미리 보기를 지원하는 에디터가 많으며, Mac에서 Markdown 파일 보는 법과 다른 곳에서 Markdown 보기에서 선택지를 살펴볼 수 있습니다. MarsDawn에서는 렌더링된 다이어그램이 소스 옆에 표시되고(⌘2), 깨진 다이어그램은 소스와 그 아래 오류를 보여 주는데, 그 자체로 코멘트할 거리입니다.

5. 계획이 건드리는 파일과 시스템을 나열하고, 요청하지 않은 것은 무엇이든 질문하세요. (4단계와 5단계를 합쳐 약 1분) 여기서는 스토리지 설정, 템플릿, 서버의 폴더 하나, 버킷 하나입니다. 버킷은 누가 읽을 수 있나요? 공개로 해 달라고 한 적은 없습니다. 에이전트의 작업 폴더를 MarsDawn에서 열어 두었다면(파일 ▸ 폴더 열기…, ⇧⌘O) 에이전트가 쓰는 새 파일이 1초 정도 안에 파일 탭에 나타나고, 헤더에 git 브랜치나 worktree가 표시되어 어느 체크아웃을 검토하고 있는지 알 수 있습니다.

6. 피드백은 위치, 문제, 수정 방법의 형식으로, 한 줄에 문제 하나씩 쓰세요. (마지막 1분)

plan.md:10: deletes the avatars before step 5 copies them. Copy first, check the count, then delete, and wait for my OK before deleting.
plan.md:14: which tests? Add one that loads an old avatar URL after the switch.
plan.md:6: nothing about keeping old links working. Add a step for that, and a way to undo the switch.

줄 번호가 있는 에디터라면 무엇이든 괜찮습니다. MarsDawn에서는 편집 ▸ 참조 복사(⌥⌘C)로 현재 위치를 plan.md:10 형식으로 복사하고, AI용으로 복사(⌃⌥⌘C)로 선택한 텍스트를 그 아래에 덧붙일 수 있습니다.

1분밖에 없다면

2단계를 하세요. 끝났다고 믿는 에이전트를 잡아내는 곳이 바로 여기입니다.

5분으로 부족할 때

어떤 단계가 맞는지 알 수 없을 때가 있습니다. 여러분이 아는 범위를 벗어나기 때문입니다. Jess Ou는 2026년 LangChain의 에이전트 해설 글에서 이를 두 문장으로 말합니다. “평가할 수 없는 판단은 위임하지 마세요. 좋은 답을 알아보지 못한다면 에이전트도 마찬가지입니다.” 저희의 결론은 이렇습니다. 어떤 단계를 판단할 수 없다는 것은 더 빨리 승인할 이유가 아니라, 판단할 수 있는 사람에게 물어볼 이유입니다.

여기서 MarsDawn이 하는 일과 하지 않는 일

MarsDawn에는 AI 모델이 들어 있지 않습니다. 이 계획의 문제를 찾아내지 않으며, 2단계도 3단계도 하지 않습니다. 작업하는 동안 파일을 읽기 쉽게 유지해 줄 뿐입니다. 1단계에는 개요를, 4단계에는 렌더링된 다이어그램을, 5단계에는 파일 탭을, 6단계에는 줄 참조를 제공합니다. 그리고 읽는 도중에 에이전트가 계획을 수정하면, 저장하지 않은 변경 사항이 없는 한 MarsDawn이 파일을 다시 불러오면서 읽던 위치를 유지합니다.

계획이 확정된 뒤 다른 사람도 봐야 한다면, 내보낸 PDF 공유하기와 Markdown을 PDF로에서 PDF로 보내는 방법을 확인하세요.

사용해 보기

MarsDawn은 Mac App Store에 있습니다. 무료 명령줄 도구 marsdawn도 있습니다.

brew install redtear1115/tap/marsdawn

앱 없이 Markdown을 PDF로 내보냅니다.

명령줄 · 구매 전에 알아 두세요: MarsDawn이 하지 않는 것

더 읽어 보기

출처