Guide

AI를 팀원처럼 쓰는
문서 운영법

대화 말고, 문서

대화는 휘발되고,
파일은 남습니다

2편대로 시작해서 며칠 쓰다 보면 반드시 이 순간이 옵니다. "아까 그렇게 하지 말라고 했잖아." 지난주에 정한 규칙을 잊고, 새 기능을 붙이다 멀쩡하던 걸 망가뜨리고, 같은 설명을 세 번째 하게 됩니다.

이건 AI가 멍청해서가 아니라 구조 때문입니다. AI에게는 컨텍스트 윈도우라고 부르는 작업 기억의 한도가 있습니다. 한 번의 대화에서 붙들고 있을 수 있는 분량이 정해져 있어서, 대화가 길어져 한도에 가까워지면 오래된 내용부터 압축되거나 밀려납니다. 창을 닫으면 아예 처음부터고요. 성능이 부족해서가 아니라 원래 그렇게 설계된 도구입니다.

직원으로 치면 실력은 뛰어난데 매일 아침 기억이 리셋되는 직원입니다. 그런데 이런 직원을 다루는 방법을 회사는 이미 알고 있습니다 — 문서로 남기는 것. 규정집과 인수인계서가 존재하는 이유와 정확히 같습니다. AI와 일할 때도 똑같이 하면 됩니다.

파일 두 개면 됩니다

거창한 시스템이 아닙니다. 프로젝트 폴더마다 텍스트 파일 두 개를 두는 게 전부입니다. 둘을 나누는 기준은 바뀌는 속도입니다.

파일역할담는 것갱신 주기
규칙서 (CLAUDE.md)안 바뀌는 것이 프로젝트가 뭔지, 지켜야 할 규칙, 하면 안 되는 것규칙이 생길 때마다
인계장 (STATUS.md)계속 바뀌는 것지금 상태, 다음 할 일, 결정 안 된 것, 날짜별 기록작업 끝날 때마다

왜 한 파일이 아니라 두 개냐면, 바뀌는 속도가 다른 정보를 한곳에 섞으면 둘 다 망가지기 때문입니다. 규칙은 상태 기록에 묻혀 안 읽히고, 상태는 규칙 사이에 끼어 낡은 채 방치됩니다. 회사에서 규정집과 인수인계서를 한 문서로 쓰지 않는 것과 같은 이유입니다.

클로드 코드는 폴더 안의 CLAUDE.md라는 파일을 시작할 때마다 자동으로 읽습니다. 그러니 규칙을 거기 적어두면 매번 다시 말할 필요가 없습니다. 인계장은 자동으로 읽히지 않으니, 저희는 규칙서에 이 한 줄을 넣어뒀습니다 — "새 세션은 STATUS.md부터 읽고 이어서 간다." 이러면 인계장 읽기까지 자동이 됩니다.

그리고 이 파일들, 직접 쓰는 게 아닙니다. "지금까지 정한 규칙을 CLAUDE.md로 정리해줘"라고 시키면 됩니다. 문서 담당도 AI입니다.

저희가 실제로 굴리는 방식

저희 회사는 프로젝트 폴더 30여 개 전부에 이 두 파일이 있고, 그 위에 전 프로젝트 공통 규칙서가 하나 더 있습니다. 어느 폴더에서 일하든 적용되는 회사 공통 수칙 — "작업을 마치면 인계장을 갱신한다" 같은 것들이 거기 있고, 프로젝트 규칙서에는 그 프로젝트만의 규칙을 적습니다. 2계층입니다. 본사 규정과 지점 규정을 나누는 것과 같습니다.

운영 원칙은 세 줄입니다.

원칙실제로는 이렇게
진척의 진실은 대화가 아니라 인계장대화에서 뭐라고 했든, 인계장에 없으면 안 한 일로 칩니다. 그래서 갱신을 건너뛸 수 없습니다
갱신은 AI 몫, 확인은 사람 몫작업 끝에 "오늘 한 거 인계장에 반영해줘" 한마디. 정리는 AI가 하고, 사람은 훑어보며 틀린 것만 잡습니다
기록은 다음 사람이 읽는다는 전제로"어제·아까" 같은 상대 날짜 금지(몇 주 뒤엔 못 알아봄), 확인 안 된 사실은 "미확인"이라고 적습니다

이렇게 하면 대화가 끊겨도, 다음 날 새로 시작해도, 심지어 몇 주 뒤에 열어도 "지난번에 어디까지 했지?"가 없습니다. 이어서 일하는 비용이 0에 수렴합니다. 인계장 자체는 네 칸이면 됩니다.

인계장에 넣는 칸예시
지금 상태 (한 줄)"신청 폼 라이브, 알림 연결 완료, 관리 화면은 미착수"
다음 할 일 (체크박스)"[ ] 관리 화면 만들기 / [ ] 완료 문자 문구 확정"
열린 결정"알림을 카톡으로만 할지 문자 병행할지 미정"
기록 (날짜 한 줄씩)"8/16 폼 배포. 8/17 알림 연결, 테스트 통과"

중요한 건 마지막 습관 하나입니다. 작업을 마칠 때 "오늘 한 거 인계장에 반영해줘" — 이 한마디만 붙이면 됩니다. 정리는 AI가 합니다.

규칙서에 꼭 들어가야 하는 것

규칙서는 세 부분이면 충분합니다. ①이 프로젝트가 뭔지(정의) ②일하는 방식(규칙) ③하면 안 되는 것(금지 목록). 앞의 둘은 프로젝트마다 내용이 갈리지만, 어떤 프로젝트든 반드시 있어야 하는 건 세 번째 — 금지 목록입니다.

왜 필요한가저희 규칙서의 실제 예
AI는 시키면 뭐든 하려고 함 — 위험한 것도"검수 없이 자동 발행 금지. 발송 버튼은 항상 사람이 누른다"
선의의 과잉 — 안 시킨 것까지 고침"요청한 파일 외에는 건드리지 않는다"
실수는 반복됨 — 같은 사고 두 번"과거에 이 방식으로 장애 났음. 이렇게 하지 말 것" (사고 나면 그때그때 추가)

세 번째 줄이 핵심입니다. 사고가 나면 그 자리에서 규칙 한 줄을 추가합니다. 사람은 같은 실수를 반복하지만, 규칙서에 적힌 실수는 반복되지 않습니다. 이게 쌓이면 규칙서가 그 프로젝트의 사고 이력이자 백신 목록이 됩니다.

한 가지 주의 — 규칙서는 짧아야 합니다. 규칙이 50줄을 넘으면 중요한 규칙이 나머지에 희석됩니다. 위키를 만드는 게 아니라 근무 수칙을 만드는 겁니다. 한 화면을 넘어가면 "이 중에 이제 안 지키는 것 지워줘"라고 정리를 시키세요. 정리 담당도 AI입니다.

이렇게 하면 무너집니다 — 실패 패턴 3가지

같은 방식을 도입하고도 한 달 뒤에 그만두는 팀이 있습니다. 저희가 겪었거나 옆에서 본 패턴은 셋 중 하나였습니다.

실패 패턴왜 무너지나처방
규칙서가 위키가 됨좋다는 걸 다 적어 수십 줄 — AI도 사람도 안 읽게 됨규칙은 사고에서만 나옵니다. 실제로 겪은 문제만 적기
인계장을 사람이 손으로 씀바빠지면 제일 먼저 생략됨 — 한 번 밀리면 다시 안 씀갱신은 AI에게 시키고, 사람은 마지막에 한마디만
대화 로그를 통째로 보관결정이 잡담에 묻혀 다시 못 찾음 — 없는 것과 같음남기는 건 결정과 상태뿐. 과정은 버립니다

셋의 공통점은 하나입니다 — 문서 유지에 사람의 성실함이 필요해지는 순간 무너집니다. 그래서 이 체계의 진짜 설계 포인트는 "잘 쓰는 것"이 아니라, 쓰고 정리하는 일 자체를 AI에게 넘기는 것입니다.

효과는 복리로 붙습니다

대화만매번 처음부터 설명
같은 실수 반복
vs
문서와 함께어제의 결정이 복원된 채 시작
사고가 재발 방지 규칙으로 축적
프롬프트를 잘 쓰는 사람과 문서를 잘 남기는 사람의 차이는 한 달 뒤에 벌어집니다.

첫 주에는 오히려 느립니다. 문서 만드는 시간이 들어가니까요. 차이는 쌓이는 쪽에서 납니다. 사고 1건이 규칙 1줄이 되면 그 사고는 영구히 사라지고, 결정 1건이 기록 1줄이 되면 같은 논의를 두 번 하지 않습니다. 대화만 쓰는 사람은 매달 같은 자리에서 시작하고, 문서를 쌓는 사람은 지난달 위에서 시작합니다.

이제 도구도 있고(2편) 일 시키는 방법도 있습니다. 다음 4편은 그래서 뭘 먼저 만들 것인가 — 첫 프로젝트를 고르는 기준입니다. 여기서 잘못 고르면 도구 탓을 하며 접게 되고, 잘 고르면 한 달 안에 두 번째, 세 번째가 나옵니다.

우리 프로젝트에 맞는
규칙서가 궁금하다면?

더 알아보기

→ 1편 — 바이브 코딩이 뭐길래, 개발자 없이 회사 도구 10개

→ 2편 — 클로드 코드 시작하기, 준비물 4가지와 첫 30분

→ 콘텐츠 칼럼 전체 보기

저희가 쓰는 인계장 양식, 방에 있습니다

저희 회사 전 프로젝트 폴더에 들어가는 STATUS.md 실제 양식과 규칙서 예시를 방에 올려뒀습니다. 복사해서 그대로 쓰시면 됩니다.

바이브 코딩 살롱 입장하기 →