프로젝트 정리, 관리 시도
2026.10.15
📝 한줄 요약
AI와 콘텐츠 자동 제작 프로젝트를 5일 동안 굴리다가 지침서가 감당이 안 돼서 역할별 파일(AGENTS·SOUL·USER·MEMORY·STATUS)로 나눴습니다. 그런데 나눈 뒤에도 AI가 이미 버린 결정을 다시 따르는 문제가 생겼고, 그 원인과 해결법을 정리한 뒤 지금은 여러 에이전트를 묶는 오케스트레이션을 시험하고 있습니다.
바쁘시면 이것만 읽어도 돼요:
사용한 도구와 목표: Claude Code와 Codex CLI로 기획부터 제작, 검수, 발행까지 이어지는 반복 작업을 자동화하는 중
과정 중 깨달은 점: 지침서를 나누는 것보다 규칙 하나를 한 곳에만 두는 것이 더 중요했다
핵심 문제: 같은 규칙이 여러 문서에 복사돼 있어서, 한 곳을 고쳐도 나머지 사본의 옛 규칙을 AI가 계속 읽었다
인상적인 순간: AI에게 "너 왜 오해했어?"라고 물었더니 원인이 내가 만든 문서 구조에 있었다
확장성: 이 구조를 그대로 두고 총괄 에이전트와 작업자 에이전트를 붙이는 단계로 넘어가는 중
배운 교훈: 이어받기는 옛 대화 기록이 아니라 "지금 상태" 문서에서 시작하게 해야 한다
🎯 이런 분들께 도움돼요
한 프로젝트를 AI와 며칠 이상 이어서 작업하는 분
CLAUDE.md 같은 지침서가 점점 길어져서 AI가 규칙을 헷갈리기 시작한 분
여러 AI 에이전트를 나눠 쓰는 구조(멀티 에이전트)를 고민 중인 분
😫 문제 상황 (Before)
처음에는 지침서 한 파일에 규칙을 계속 덧붙이면서 작업했습니다. "이건 이렇게 해 줘", "앞으로는 저렇게 하자" 같은 말을 할 때마다 한 줄씩 늘었습니다. 5일쯤 지나자 지침서는 길어졌고, 앞쪽 규칙과 뒤쪽 규칙이 서로 반대인 경우도 생겼습니다.
더는 미룰 수 없었던 이유는 사람 손을 빼는 자동화로 넘어가려 했기 때문입니다. 제가 옆에서 "그거 아니야"라고 바로잡아 줄 수 없는 상태에서는 규칙이 헷갈리는 순간 결과물이 틀어집니다.
🛠️ 사용한 도구
도구명: Claude Code(주 작업), Codex CLI(교차 검수와 협업 설계 상담), Orca(여러 에이전트를 묶는 도구)
모델: Claude Fable·Opus·Sonnet, Codex
특이사항: 맥북과 맥미니 두 대를 오가며 같은 프로젝트를 작업
🔧 작업 과정
지침서 한 장을 역할별 다섯 장으로
지침서가 너무 길어져서, 내용을 성격별로 나눠 담기로 했습니다.
AGENTS.md: 어떤 AI든 지켜야 할 공통 작업 규칙
SOUL.md: AI의 역할과 말투
USER.md: 제 취향
MEMORY.md: 계속 기억해야 할 결정
STATUS.md: 지금 할 일과 막힌 일
원래 지침서인 CLAUDE.md는 "AGENTS.md부터 읽으라"는 안내만 남기고, 예전 내용은 보관 폴더로 옮겼습니다. "새 규칙이 생기면 어느 파일에 적는가"를 정한 관리 안내도 따로 만들었습니다.
나누고 나니 읽기는 훨씬 편해졌습니다. 그런데 진짜 문제는 그다음에 나왔습니다.
버린 결정이 자꾸 되살아나다
구조를 바꾼 뒤 작업을 이어 가는데, AI가 이미 빼기로 한 절차를 다시 넣었습니다.
제목 검수 -> 이거 넘 과해서 빼기로 하지 않았어?자동화로 가기로 했는데 사람이 고르는 단계가 다시 들어오기도 했습니다.
방향 선택을 왜 사용자가 해 완전 자동화로 세팅할려고 했는데한두 번이면 실수라고 넘기겠지만 계속 반복됐습니다. 그래서 고치라고 하는 대신 원인을 물어봤습니다.
이게 왜 다른 곳은 수정되어도 협업 설계도는 적용안되고 그러는거야?
너가 한번에 잘못 오해했었던 이유가 뭐야?답을 듣고 나니 AI 잘못이라기보다 제 문서 구조 탓이었습니다.
같은 규칙이 여러 문서에 복사돼 있었습니다. 작업 스킬 파일에서는 "블라인드 검수는 선택"으로 고쳤지만, 협업 설계 문서와 상태 문서에는 "필수"가 그대로 남아 있었습니다. AI는 어느 쪽을 읽느냐에 따라 다르게 행동했습니다.
이어받을 때 옛 대화 기록을 넘겨주고 있었습니다. 새 세션이 이전 대화를 참고 자료로 받으면서, 그 안에 있던 옛 결정을 최신인 것처럼 읽었습니다.
파일을 나눈다고 해결되는 문제가 아니었습니다. 나누면서 오히려 사본이 늘어난 셈이었습니다.
그래서 정한 다섯 가지 원칙
이 문제를 막으려고 원칙 다섯 가지를 정했습니다.
규칙 하나는 정본 한 곳에만 둡니다. 다른 문서에는 내용을 복사하지 않고 "이 문서를 보라"고만 씁니다.
바꾼 규칙은 대체 관계를 남깁니다. 결정 기록에 "이전 내용 → 새 내용, 날짜, 영향받는 파일"을 적어서, 무엇이 폐기됐는지 AI가 알 수 있게 합니다.
보관본에는 경고를 붙입니다. 예전 지침은 "이유를 찾을 때만 읽고, 지금 규칙으로 적용하지 않는다"고 적힌 보관 폴더에 둡니다.
이어받기는 STATUS.md에서 시작합니다. 옛 대화 기록은 빠진 정보를 채울 때만 참고합니다.
규칙을 고칠 때마다 반대 지시를 찾습니다. 다른 문서에 반대되는 옛 문장이 남았는지 검색합니다. 사람이 기억해서 하면 빠뜨리니, 앞으로는 점검 스크립트로 자동화할 생각입니다.
지금: 오케스트레이션 시도 중
문서가 정리되자 그다음 단계로 넘어갔습니다. 먼저 Codex에게 지금 폴더 구조로 어떤 팀을 꾸릴 수 있는지 물었습니다.
현재 폴더 내에서 멀티 에이전트를 구축해보고 싶은데, (협업까지도 가능하다면)
현 폴더 구조 파악해보고 너가 제안해볼 수 있어? (제안할때 각 에이전트를 어떤 모델로 주면 좋을지도 제안해줘)처음 제안은 검수 단계가 너무 많았습니다. 비용이 걱정돼서 다시 물었습니다.
현재 역할과 추천 모델에서, 너무 과하게 측정되지 않았을지? (왜냐면 너무 검수가 많이 들어갈수록 비용이 드니까)그 결과 구조를 이렇게 정리했습니다. 총괄 에이전트(Opus)가 방향을 정하고 작업을 나눕니다. 작업자 에이전트(Sonnet)가 만들고, 다른 모델의 교차 검수는 문제가 생긴 결과물에만 붙입니다. 이 구조를 Orca로 묶어서 명령 한 줄로 시작하게 했습니다.
첫 시험에서 1편이 끝까지 통과했습니다. 작업자 배정, 완료 보고, 수정 2회, 다음 단계 대기열 등록까지 모두 돌아갔습니다. 다만 대기열 다음 단계인 실제 예약 발행이 끝까지 이어지는지는 아직 확인하지 못했습니다.
✅ 결과 (After)
Before vs After
항목 | Before | After |
|---|---|---|
지침 관리 | 지침서 한 파일에 계속 덧붙임 | 역할별 5개 파일 + "어디에 적나" 안내 |
규칙이 바뀔 때 | 여러 사본 중 일부만 고쳐짐 | 정본 한 곳만 고치고 결정 기록에 대체 관계 남김 |
세션 이어받기 | 옛 대화 기록부터 읽음 | 상태 문서부터 읽고, 대화 기록은 보조로만 참고 |
작업 실행 | 한 세션에서 내가 계속 지시 | 총괄 + 작업자 구조, 명령 한 줄로 시작(시험 1편 통과) |
결과물
(여기에 폴더 구조 캡처와 Orca 화면 캡처를 넣습니다)
💬 이 과정에서 배운 AI 활용 팁
효과적이었던 것
틀렸을 때 "고쳐"보다 "왜 그렇게 이해했어?"라고 묻기. 원인이 AI가 아니라 내 문서에 있다는 걸 알게 됐습니다.
다른 모델에게 설계를 물어보기. Claude로 만든 구조를 Codex에게 보여 주니 빈 곳이 보였습니다.
추천을 받으면 "과하지 않아?"라고 한 번 더 묻기. 검수 단계가 줄어 비용이 내려갔습니다.
이렇게 하면 안 돼요
같은 규칙을 여러 문서에 복사해 두기. 언젠가 한 곳만 고쳐집니다.
예전 지침을 지우지도 표시하지도 않고 그대로 두기. AI는 옛것과 새것을 구분하지 못합니다.
구조를 바꾸자마자 바로 자동화로 넘어가기. 문서끼리 맞는지 먼저 점검해야 합니다.
🌍 다른 업무에 적용한다면?
여러 사람이 같이 쓰는 업무 매뉴얼에도 똑같이 적용됩니다. 규칙은 한 곳에만 두고, 바뀐 규칙에는 "언제 무엇이 무엇으로 바뀌었는지"를 남기면, 사람이든 AI든 옛 규칙을 따를 일이 줄어듭니다.
🚀 앞으로의 계획
문서끼리 반대 지시가 남았는지 자동으로 찾는 점검 스크립트 만들기
오케스트레이션을 1편에서 여러 편 묶음으로 늘리고, 실제 발행까지 이어지는지 확인하기
발행 결과를 다음 기획에 다시 넣는 성과 분석 단계 붙이기
📋 재사용 가능한 프롬프트
프롬프트 1: 지침서 역할별로 나누기
지금 [지침서 파일명]이 너무 길어져서 규칙끼리 부딪혀. AGENTS(공통 규칙), SOUL(AI 역할·말투), USER(내 취향), MEMORY(계속 기억할 결정), STATUS(지금 할 일)로 나눠 줘. 규칙 하나는 한 파일에만 두고, 다른 곳에서는 그 파일을 가리키게 해 줘. 원본은 지우지 말고 "지금 규칙으로 적용하지 않음"이라고 표시한 보관 폴더로 옮겨 줘.
프롬프트 2: 오해한 이유 묻기
방금 [AI가 잘못 따른 규칙]을 따랐는데, 그건 [날짜]에 빼기로 한 거야. 고치기 전에 먼저, 왜 그렇게 이해했는지 어느 문서의 어느 문장을 읽었는지 찾아서 알려 줘. 그리고 같은 옛 문장이 남아 있는 문서를 전부 찾아 줘.
프롬프트 3: 멀티 에이전트 설계 받기
지금 폴더 구조를 파악하고, [작업 단계들]을 나눠 맡을 에이전트 구성을 제안해 줘. 각 역할에 어떤 모델이 맞는지도 실제 작업 기록을 근거로 추천해 줘. 단, 검수가 많을수록 비용이 드니 꼭 필요한 곳에만 넣어 줘.

![[Paseo + Claude Code] 만들어 둔 리센느빵 테트리스 세션을 그대로 이어받아, 메뉴·2인 대전·배경음악·효과음까지 한 번에 붙였다 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2Fdfa7f86bd93d21caba20bf53.jpg&w=3840&q=75)

