Claude Code로 SNS 게시물 대량 생산하기: 유형과 설정을 분리한 에이전트 지시서 작성 방법

AI에게 SNS 게시물 작성을 맡기면, 어딘가에서 본 듯한 일반론이나 과도하게 자극적인 문구(소위 '바즈 구문')가 출력되기 쉽습니다. 또한, 매번 프롬프트를 직접 입력하면 게시물마다 톤이나 구성이 흔들려, 과거에 검증된 반응 좋은 유형을 재현하기 어렵습니다.

이번에는 SNS 게시물 제작을 담당하는 AI 에이전트에서 '판단 절차(유형)'와 '발신자 또는 계정의 제약(설정)'을 명확하게 분리하는 설계를 도입했습니다.

뼈대 작성이나 구성 패턴 적용은 AI에게 맡길 수 있게 되었습니다. 다만, 실제 경험에 기반한 구체적인 수치 확인과 공개 최종 판단은 사람에게 남겨두었습니다.

장기 연재 '1인 법인 1000마력화 계획'의 제2회로, 제작 에이전트 지시서 설계와 실제로 맡긴 범위 및 사람에게 남은 작업 경계를 기록합니다 (제1회 비서 에이전트 설계에 대해서는 'Claude Code의 태스크 관리: 기한과 PR 전달을 한 장으로 만드는 방법'을 참조하십시오).

제가 운영하는 마이크로 법인에서는 현재 2개의 SNS를 운영하고 있습니다.

문화도 독자층도 다른 두 매체에서, 매일 총 10개의 게시물을 손으로 처음부터 구상하거나 수시로 채팅창에 '이 내용으로 X 스타일로 요약해 줘'라고 지시하고 있다가는 아무리 시간이 남아도 모자랍니다.

게다가 프롬프트를 그때그때 직접 입력하면 다음과 같은 문제가 빈번하게 발생했습니다.

• 일반론으로의 회귀: 배경지식이나 입장을 지정하는 것을 잊으면, '〜하는 것이 중요합니다'와 같은 무난한 설교조가 됩니다. - 검증된 패턴 상실: '낙차형(Before/After)'이나 '결론 선출시형' 등 과거에 반응이 확인된 구성을 재현하지 못하고, 즉흥적인 글이 됩니다. - 금지 사항의 재발: 외부 링크 유도 문구나 과도한 자극적 표현 등 계정으로서 금지하는 형식이 섞여 들어갑니다.

이를 해결하기 위해 '게시물 작성 절차 자체'와 '계정 고유 규칙'을 분리하여 관리하게 되었습니다.

사내에서 구동되는 에이전트 지시서는 다음 3개 계층으로 나누어 관리하고 있습니다.

agents/post-generate/
AGENT.md 유형. 어떤 일을 하는 에이전트인지, 판단 절차. 어느 회사・매체에서도 공통
config.schema.md 설정 항목. 구동하기 위해 채워 넣을 값 목록 (매체 제약, 발신자, 유형, 금지 사항)
...

가장 큰 특징은, 유형(AGENT.md) 안에 회사 고유의 단어(글자 수 상한, 특정 계정명, 테마명 등)를 전혀 적지 않는다는 점입니다.

AGENT.md

여기서는 어떤 소재로부터 어떤 절차로 게시물을 구성할지에 대한 프로세스만을 규정합니다.

• 소재 정리 및 사실 추출: 주제에서 '구체적인 사건', '수치', '독자적인 판단 기준', '수정한 경위'를 뽑아내고, 미확인 성과나 가상의 체험담을 배제합니다. - 구성 패턴(유형) 선택: 설정의 patterns
  （검증된 유형 목록）에서 소재의 성격에 가장 적합한 유형을 1개 선택합니다. - 본문 작성: 플랫폼의 글자 수 제약을 지키고, 본문 단독으로 독자가 지식을 가져갈 수 있는 구조로 만듭니다. 설정된 1인칭이나 톤을 유지합니다. - 금지 사항 자체 점검: 설정의 forbidden
  （금지어・금지 패턴）에 위배되지 않는지 스스로 검사합니다. - 보충 정보 작성: 참조 원문 기사의 URL이나 추가 해설이 필요한 경우, 메인 게시물과는 별도의 답글/스레드용 텍스트로 만듭니다.

이 절차 자체는 X에서도 Threads에서도, 장래에 다른 매체나 타사에게 전개할 경우에도 공통입니다.

반면, 계정별 개성이나 제약은 설정 파일(config) 측에서 정의합니다.

예를 들어, X 담당으로 구동되는 '010 카시와기 하시라'와 Threads 담당의 '001 이쿠타 안'은 같은 제작 절차를 사용하면서도, 설정을 다음과 같이 전환하고 있습니다.

⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.

유형을 공통화하고 설정만 교체하는 구조로 만들면서, '프롬프트를 처음부터 다시 작성해야 한다'는 낭비가 사라졌고, 새로운 플랫폼이나 다른 장르로의 전개도 설정 파일 추가만으로 가능해졌습니다.

실제로 블로그 기사의 기술 검증 로그를 소재로 X 담당 에이전트에게 게시물 작성을 의뢰했을 때의 입출력 예시입니다.

주제: Claude Code 실행 전 훅(Pre-tool hook) 도입 기록
사실:
- Bash 도구 실행 전에 스크립트를 끼워 넣어, 보호 대상 브랜치(main)로의 직접 push를 기계적으로 차단함
...

【메인 게시물 (218 weight)】
main 브랜치로의 직push 금지는 운영 규칙으로 철저히 하려고 하면 반드시 빠져나간다.
최근 병행 작업에서 아찔한 경험이 있어, Bash 도구 실행 전 훅을 도입했다.
...

본문 단독으로 '무엇이 문제였고, 어떻게 대책을 세웠으며, 무엇이 교훈인지'가 완결되어 있어서, 외부 링크를 열지 않아도 독자가 배움을 얻을 수 있는 구성입니다. 또한, 글자 수나 금지 사항(본문 내 URL 직작성 금지)도 올바르게 지켜졌습니다.

이 에이전트를 일일 운영에 통합한 결과, 맡길 수 있는 영역과 아무래도 인간에게 남는 경계가 명확해졌습니다.

【AI 에이전트에게 맡긴 것】
- 소재로부터 논점 추출 및 검증된 패턴(유형)에 적용
- 글자 수 카운트와 줄 바꿈 밀도 조정
...

특히 주의가 필요한 것이 수치나 실적의 사실 확인입니다.

AI는 문장의 흐름을 좋게 만들기 위해, '작업 시간이 30% 감소했다', '3분 만에 도입할 수 있었다'와 같이 소재에 쓰여 있지 않은 구체적인 숫자를 자연스럽게 보완하는 경향이 있습니다. 하지만 실록을 간판으로 하는 계정에서 가상의 숫자를 섞어버리면, 발신 전체의 신뢰도가 떨어집니다.

따라서 '소재에 명기되지 않은 숫자나 기간은 절대 출력하지 않는다', '미확인 수치는 반드시 확인 사항으로 인간에게 반환한다'라는 규율을 프롬프트 쪽에 설정한 후, 인간이 원 데이터(커밋 로그, 장부, Google 스프레드시트 등)와 대조하여 확인하는 과정을 반드시 거치고 있습니다.

또한, 버튼을 눌러 SNS 상에 예약/공개하는 조작은 의도적으로 인간의 손에 남겨두었습니다 (절대 규칙 '공개는 사용자의 명시적인 GO가 필요').

사내 업무에서 AI에게 텍스트 작성이나 게시물 작성을 맡기고 싶다면, 다음 세 가지를 의식하면 재현성이 높아집니다.

'절차(유형)'에 고유한 값을 쓰지 않기: 프롬프트에 글자 수나 계정 고유의 사정을 그대로 적지 않고, 설정 항목으로 외부로 분리합니다. 절차가 범용화되면 다른 부서나 매체에도 그대로 전용할 수 있습니다.
-'구성 패턴'을 선택하게 하기: '자유롭게 써라'라고 부탁하면 AI는 평균적인 문장에 수렴합니다. '결론 선출형', 'Before/After형', '3점 요약형'처럼 반향이 생기기 쉬운 골격 패턴을 정의하고, 소재에 따라 선택하게 합니다.
-금지 사항에는 '이유'를 덧붙이기: 'URL을 붙이지 마라', '자극하지 마라'라고만 적는 것이 아니라, '왜 금지인지(역할 분담이 무너질 것이기 때문에, 신뢰도를 손상시키기 때문에)'를 명시함으로써, AI의 문맥 이해가 안정되고 규칙 위반을 막을 수 있습니다.

게시물을 안정적으로 대량 생산할 체제는 갖추어졌습니다. 하지만, 한 번 정한 구성 패턴(유형)이 현재도 독자에게 받아들여지고 있는지는 별개의 문제입니다.

게시물 제작 에이전트가 사용하는 '검증된 유형'은, 생각나는 대로 늘리는 것이 아니라, 공개 후의 실적 데이터를 분석하여, 실제로 엔게이지먼트가 높았던 게시물로부터 역산하여 추출해야 합니다.

다음 회차에는, 공개된 게시물의 반향 데이터(조회수, 좋아요, 답글, 리포스트)를 집계하고, 다음 승리 패턴을 추출하는 '반향 분석 에이전트(post-analyze)'의 설계와 운영에 대해 기록하겠습니다.