MarsDawn

Chip Huyen의 read-only/write action 구분, 승인하기 전에 왜 중요한지

Chip Huyen의 2025년 1월 에세이 «Agents»는 교과서적 정의에서 시작해 더 구체적인 데로 갑니다. 에이전트의 행동은 세상을 보기만 하는 것과 바꾸는 것으로 나뉩니다. 그 구분은 주어진 5분 안에서, 계획의 어떤 줄이 승인 전에 더 자세히 볼 가치가 있는지 정하는 좋은 방법입니다.

글이 주장하는 것

Huyen은 담백하게 엽니다.

“An agent is anything that can perceive its environment and act upon that environment.”

거기서 에이전트에 필요한 것을 쌓아 올립니다. 행동할 환경, 그리고 할 수 있는 일을 정하는 도구 집합 — «tool inventory». 환경을 지각만 하게 하는 행동(«read-only actions»)과 환경에 작용하게 하는 행동(«write actions»)을 구분합니다. 두 번째 종류의 위험에 대해서도 직설적입니다. «Write actions enable a system to do more»이지만 «the prospect of giving AI the ability to automatically alter our lives is frightening» — 그녀의 말로 «you shouldn’t allow an unreliable AI to initiate bank transfers.» 에이전트에서 가장 맞추기 어려운 부분에 대해서도 솔직합니다.

“If you’ve ever been in any planning meeting, you know that planning is hard.”

Huyen은 이 에세이 어디에서도 MarsDawn을 언급하지 않고 Markdown 도구도 추천하지 않습니다. /reviewing-agent-plans/는 이미 같은 에세이에서 그녀 문장 셋을 인용합니다. 계획이 돌기 전에 감독을 건너뛰는 비용, 끝나지 않았는데 끝났다고 믿는 에이전트, 그리고 체크리스트 3단계 안의 «위험한 작업 앞에서 시스템 can ask for explicit human approval before executing»라는 줄. 이 노트는 그 인용을 반복하지 않습니다. 그 페이지를 아직 안 읽었다면 아래에 링크가 있습니다.

우리의 읽기이지 Huyen의 것이 아님

Huyen의 read-only/write 구분은 검토 조언으로 쓰인 것이 아닙니다 — 도구가 무엇을 하는지 분류하는 방식입니다. 하지만 그 체크리스트 3단계가 이미 천천히 보라고 하는, 위험한 작업 줄을 짚는 담백하고 범용적인 검사입니다. 파일 읽기, 검색 실행, 디렉터리 나열은 read-only이고, read-only 단계가 잘못되면 다시 돌리는 비용입니다. 데이터 삭제, force-push, 브랜치 병합, 메일 발송, 카드 결제는 write action이고 — 그녀가 말하듯 — write 단계가 잘못되면 무서운 쪽이며, 에이전트 보고서를 읽을 즈음에는 이미 벌어졌을 수 있습니다. 방에 모인 사람에게도 계획이 어렵다는 지적은, 형식이 감당할 수 있는 것보다 더 정밀한 계획을 기대하지 말라는 점검이 됩니다. 자신 있게 읽히는 계획이 곧 맞는 계획은 아닙니다.

MarsDawn이 돕는 곳, 돕지 않는 곳

MarsDawn은 계획에서 read-only 단계와 write 단계를 구분하지 못합니다 — 텍스트가 라벨을 붙이지 않은 판단이고, 앱 안에는 의미를 읽는 기능이 없습니다. AI 모델도 없습니다. 위험한 줄을 대신 표시해 주지도, «계획은 어렵다» 검사를 돌리지도, 계획에 점수를 매기지도 않습니다. 하는 일은 당신이 그 판단을 하는 동안 파일을 읽기 쉽게 유지하는 것입니다. 개요 탭(보기 ▸ 사이드바 보기, ⌃⌘S)으로 줄마다 읽기 전에 계획의 형태를 훑을 수 있고, 소스와 렌더링된 페이지를 나란히(⌘2) 두어 단계 다이어그램이 날 Mermaid로 남지 않게 하며, 편집 ▸ 참조 복사 (⌥⌘C)는 자리를 plan.md:10으로 만들어, 잘못된 순서의 write action을 보는 순간 피드백으로 붙여 넣을 수 있게 합니다.

사용해 보기

MarsDawn은 Mac App Store에 있습니다. 무료 marsdawn 명령줄 도구는 오늘부터 쓸 수 있습니다:

brew install redtear1115/tap/marsdawn

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

명령줄 · 구입 전에: MarsDawn이 하지 않는 일

다음

출처