미안하게도 설명이 더 길어졌습니다.
저녁 시간, 나는 AI에게 다음 작업을 부탁하기 위해 지시문을 작성하고 있었다.
전제를 작성하고, 쓰기 조도를 명시하며, 판단 기준을 제시했습니다. 내용을 마무리하고 다시 읽어보니, 요청 사항은 마지막 한 줄에만 있었습니다.
이거, 설명이 더 길지 않아?
끝나기가 너무 길었습니다. 설명이 8할을 차지했고, 요청 사항은 2할이었습니다.
게다가, 그 설명은 매번 거의 같았습니다. 요청하는 내용은 매번 달라는데, 그 전에 입력하는 프리피어만 계속 사용하는 바람에 손으로 다시 작성해야 했습니다.
한 사람에게 모든 것을 의존했던 것이 원인이었습니다.
그 이유는 지시 사항의 방식이 아니었습니다. 한 명의 AI에게 조사, 결정, 작성 등 모든 것을 한 번에 의뢰했던 것이었습니다.
한 사람이 모든 것을 겸하는 경우, 그 한 사람은 매번 맑은 상태에서 시작합니다. 그래서 요청하는 사람이 조사 방법, 판단 기준, 쓰기 방식 등을 다시 알려주어야 합니다. 다시 알려준 만큼 지시문이 길어집니다.
전제가 어디에도 존재하지 않았다는 것뿐이었습니다.
그래서 담당을 1명만 선택하는 것으로 결정했습니다. 모두를 만들려고 하면 그 날이 끝나지 않을 것입니다. 1명만 하겠습니다.
AI 사원의 정체는 마크다운 한 페이지였습니다.
제시된 자료는 폴더 하나와 Markdown 파일 하나입니다. 새로운 앱이나 서버, 계약이 필요하지 않습니다.
저장 위치는 `~/Documents/CompanyOS`라는 폴더로 설정했습니다. “CompanyOS”는 제가 붙인 이름이며, 정해진 규칙은 아닙니다. 내용물은 전부 단순 텍스트 파일입니다.
각 직원에게는 1개의 파일만 제공되며, 파일은 `01_Employees` 폴더에 넣고 파일 이름은 그대로 직책으로 사용됩니다.
파일 상단에 있는 `---`로 구분된 부분을 frontmatter라고 합니다. 파일 설정 정보를 작성하는 부분으로, 첫 번째 항목은 `역할`의 한 줄만 입력하면 됩니다.
다음은 본문으로, 제목은 4가지입니다. 직책, 역할, 책임, 권한. 이 4가지만 다룹니다.
같은 폴더를 Obsidian으로 열어보면, 누구나 읽을 수 있는 단순한 메모처럼 보입니다. Claude Code에 읽히면, 직책을 가진 담당자로서 행동합니다. 내용 자체는 동일하며, 읽는 사람의 차이일 뿐입니다.
바로 이것이 “에이전트 AI”라고 불리는 방식입니다. 한 번 질문하고 한 번 답변을 받는 방식이 아니라, 역할을 부여하고 스스로 결정할 수 있는 범위를 정해준 다음, 그 이후의 절차는 본인이 스스로 결정하고 실행하도록 하는 형태입니다. 특별한 시스템은 필요하지 않습니다. 전달하는 것이 이 Markdown 한 장입니다.
권한을 쓰지 않으면 자의적으로 결정되는
처음 만든 것은 제목만 있었습니다. 직책 이름을 쓰고, 책임과 권한은 비워둔 채로 움직였습니다.
그래, 작동할 거야.
움직였다. 어색한 움직임이었다.
제가 스스로 판단할 때까지 기다리지 않고, 이미 결정을 내리고 먼저 나아갔던 것입니다. 돈이 들어가는 결정도 확인 없이 진행했던 것입니다.
이유는 단순했습니다. 권한을 명시하지 않았기에, 해당 담당자는 ‘상관에게 문의’하는 방법을 선택할 수 없었습니다. 빈칸은 “맘대로 해도 된다”로 해석됩니다.
책임과 권한을 보완했습니다. 결정할 수 있는 범위는 쓴 만큼으로 제한되며, 닫힌 영역은 “스스로 결정할 수 없는 공간”이 됩니다.
그 날부터, 제가 다시 되물어 오기 시작했습니다. 특별히 화려한 기능을 추가한 것은 아니었어요. 그냥 쓰지 않았던 것을 적어놓은 것뿐입니다.
현재 직원 수는 30명입니다. 늘어난 것은 나중에 이야기할 내용이며, 처음에는 1명이었었습니다.
그대로 따라 할 수 있는 절차
이제부터는 오늘 처음 Claude Code를 사용하는 사람들을 위해 설명하겠습니다. 파일을 직접 만들 필요는 없습니다. 입력해야 할 것은 전부 Claude Code에 말하는 문장들입니다.
단계 0: 먼저, 앞으로 무엇을 할 것인지
할 일은 두 가지입니다. 폴더를 하나 만들고, 그 안에 담당자 한 분당 Markdown을 하나씩 넣습니다. 제목은 직책, 역할, 책임, 권한의 네 가지만 사용합니다.
1단계: 저장 위치 폴더를 생성합니다.
무엇 때문에: 담당자의 파일을 1곳에 모아야 합니다. 흩어져 있으면 전달할 때 지정을 할 수 없기 때문입니다.
할 일: 터미널(검은 화면)을 열고 다음 줄을 그대로 입력합니다.
잘 되었는지 확인: Finder에서 “문서” 폴더를 열어 `CompanyOS`라는 폴더가 생성되었는지 확인하면 됩니다.
단계 2: 담당자를 한 명만 지정한다.
무엇 때문에: 한 번에 모든 사람이 만들려고 하면 끝나지 않기 때문입니다. 어려움을 겪고 있는 작업을 하나만 선택합니다.
할 일: 종이든 메모든 상관없습니다. 다음 2행을 자신의 말로 채워 넣겠습니다.
잘 되었나: 이름이 하나로 결정되었다면 그것은 신호입니다. 둘 이상이라면 오늘은 그 중 하나에만 하겠습니다.
3단계: 해당 이미지를 Claude Code에 생성하도록 합니다.
무엇 때문에: 파일의 형태를 기억할 필요 없이, 내용물이 제대로 들어가는지 확인하기 위해서입니다.
할 일: 터미널에서 `claude`를 입력하여 Claude Code를 열고, 그대로 다음 명령어를 입력합니다. (괄호 안의 내용은 본인에게 맞춰 변경해주세요).
성공 여부 확인: `open ~/Documents/CompanyOS/01_Employees` 명령어를 입력하면 폴더가 열리고, 그 안에 파일이 하나라도 있으면 성공 신호입니다.
단계 4: 책임과 권한을 비워두지 마십시오.
무엇 때문에: 빈칸을 “좋아해도 괜찮다”라고 읽히기 때문입니다. 여기를 쓰지 않으면, 듣지 않고 결정될 수 있습니다.
할 일은 제작된 1장을 펼쳐서 다음 형태로 더합니다. “책임”은 부여하는 것이고, “권한”은 스스로 결정해도 괜찮습니다.
클루드 코드에 부탁드려도 됩니다. “전에 수정했던 파일의 책임과 권한을 이대로 바로잡아 줘”라고 말씀하시면서 위에 있는 내용을 그대로 붙여주세요.
잘 되었는지: 파일 안에 “## 책임”과 “## 권한”이 나란히 있고, 둘 다 빈칸이어야 한다는 신호입니다.
단계 5: 호출하고 활용하기
무엇 때문에: 아무것도 만들었다고 해서 바뀌지 않습니다. 요청할 때 특정 대상을 지칭함으로써 불필요한 مقدم을 줄일 수 있습니다.
할 일: 클로드 코드에게 이렇게 말합니다.
잘 풀렸다는 의미는 아직 판단의 기준을 정하지 않았거나 기준을 세우지 않은 상태에서 그 기준을 바탕으로 한 답변이 오면 그것이 신호라는 뜻입니다.
단계 6: 진행이 되지 않을 때 확인
파일 위치를 매번 말씀드리는 것이 번거로우시다면, `CLAUDE.md` 파일에 위치 정보를 한 줄에 작성해 두면 됩니다. “담당자의 파일은 `~/Documents/CompanyOS/01_Employees`에 있습니다.” 정도로 충분합니다.
상황을 알지 못하고 결정할 때마다 권한의 범위가 지나치게 넓습니다. “실행 전에 반드시 사람에게 확인받아야 한다”는 점을 책임을 뒷받침하는 근거로 활용할 수 없습니다.
답신이 이전과 동일한 경우에는 파일을 읽어보실 기회가 없었습니다. 요청하신 내용 중 파일 위치 정보가 있는지 확인해 보겠습니다.
알 수 없는 부분이 있습니다.
이까지 읽어보니 의미가 제대로 전달되지 않는 부분이 있는 것 같습니다. 프론트매터인지, 터미널인지, 아니면 전부인지를 확인해야 할 것 같습니다.
모르는 것은 클로드 코드 본인에게 물어보는 것이 좋습니다. 모든 것을 알려주십니다. 저 또한 이 한 장의 형태를 듣는 동안 결정했습니다.
듣는 방법은 이것으로 충분합니다.
마법 같은 한마디 “회사를 만들고 싶으니 직원 5명을 고용하고 싶다.”
네, 괜찮습니다. 이렇게 길게 설명드렸지만 여기까지만 말씀드립니다.
다음 예고와 동일한 시스템을 만들고 싶으신 분들께 드립니다.
다음 회차는 이 담당자가 늘어난 후의 이야기입니다. 2명, 3명 정도 만들었을 때 “이게 누가 결정하는 거지?”라는 혼란이 생겼습니다. 상하 관계에 대한 이야기를 진행할 것입니다.
좋다면 팔로우하고 다음에도 함께 읽어오세요.
업무적으로 동일한 시스템을 만들고 싶으신 분은 Note의 메시지 또는 X를 통해 연락 주시기 바랍니다. 가능한 일은 3가지입니다.
매번 수정하고 있는 전제를 해당 담당자의 파일로 옮깁니다.
책임과 권한을 명확히 분담하여, 자의적으로 진행되지 않도록 하는 방식을 구축하는 것입니다.
작업 담당자를 해당 작업의 용어에 연결합니다.
출처: note 원문
번역: Gemma 3(.44) 초벌 + 교정 47청크
원문 보기 | 출처: note.com