안녕하세요! 사랑받는 IT 프로덕트의 첫 스텝, 똑똑한개발자입니다 :)

AI 에이전트에게 프로젝트를 맡기면 세션이 바뀔 때마다 컨텍스트가 날아갑니다. 홈페이지 하나 만드는 데도 유저 서비스, 관리자 어드민, 콘텐츠 생성 에이전트가 각각 따로 동작하면서 코드 스타일도, 비즈니스 로직도 제각각이 되고말죠. 저희 팀에서도 AI 여행사 프로젝트를 진행하면서 이 문제를 직접 겪었고, 해결책으로 LLM 위키 기반의 중앙 관리 구조를 설계했습니다.

이 글에서는 오르카(Orca) IDE 위에 LLM 위키와 멀티 에이전트를 결합해 명령어 한 줄로 블로그를 자동 생성·발행하는 시스템을 설치부터 실행까지 다룹니다.

이번에 저희가 무료로 배포하는 코드에는 블로그 웹사이트와 콘텐츠 관리 어드민, 코드 구조와 에이전트 사용법을 담은 LLM 위키 및 장기·단기 메모리 세팅, 그리고 슈퍼베이스 연동과 구글 서치 콘솔·네이버 서치 어드바이저·빙 등 SEO 기본 세팅이 모두 포함되어 있습니다.

상세 설치 가이드와 GitHub 주소는 위 유튜브 영상의 자세히 보기와 댓글에서 확인하실 수 있습니다.

AI 프로젝트에서 컨텍스트가 사라지는 이유

AI 코딩 도구를 쓰다 보면 한 프로젝트 안에서도 여러 영역이 생깁니다. 유저향 웹, 관리자 어드민, 콘텐츠 에이전트가 각자 다른 세션에서 돌아가는 구조가 되는 거죠. 에이전트마다 알고 있는 맥락이 달라집니다.

어드민에서 쓰는 데이터 스키마를 웹 에이전트는 모릅니다. 콘텐츠 생성 에이전트는 프로젝트의 SEO 전략 자체를 인식하지 못하고요. 개별로는 잘 동작하는데 합치면 통일성이 깨집니다.

이걸 해결하려면 프로젝트의 모든 정보를 한곳에 모아야 합니다. 그래서 도입한 것이 LLM 위키입니다. 프로젝트 개요부터 코드 설명, 에이전트별 사용법, 문서 간 연결 구조까지 위키 폴더에 마크다운으로 정리해두면 어떤 에이전트가 세션을 열든 같은 맥락을 공유하게 됩니다.

블로그 자동화 프로젝트의 폴더 구조와 에이전트 구성

저희가 공개한 샘플 프로젝트는 블로그입니다. 폴더 구조를 보면 app 하위에 web(블로그 웹사이트)과 admin(콘텐츠 관리 어드민)이 들어가 있습니다. SEO와 테크니컬 세팅은 이미 완료된 상태이죠.

블로그 라이터 & 이미지 메이커, 두 에이전트 체제

에이전트는 블로그 글을 쓰는 블로그 라이터와 본문 이미지를 만드는 이미지 메이커로 나뉩니다. 블로그 라이터는 클로드(Claude) 기반으로 동작하고, 이미지 메이커는 코덱스(Codex) 기반이며 내부적으로 GPT의 이미지 생성 모델을 활용합니다.

왜 모델을 나눴을까요. 클로드는 텍스트 생성에 강하지만 이미지 생성 기능이 없고, GPT는 2025년 기준 이미지 생성 품질이 가장 높기 때문입니다. 각 모델의 강점을 살려서 병렬로 작업하는 겁니다. 패키지는 Supabase와 콘텐츠 관련 부분을 공통으로 관리하도록 설계했고, 새 에이전트가 필요하면 크리에이터 에이전트 스킬로 추가 생성할 수 있습니다.

세션이 바뀌어도 맥락을 유지하려면?

에이전트가 매번 위키를 수동으로 읽게 하면 비효율적입니다. 그래서 클로드 훅을 설정해 세션이 열릴 때 LLM 위키 내용이 자동으로 컨텍스트에 로드되도록 만들었습니다. 별도 명령을 입력할 필요가 없습니다.

메모리는 장기와 단기로 나뉩니다. 작업이 끝나면 사용자가 세이브 메모리 스킬을 호출해 단기 메모리에 저장하고, 중요한 아젠다는 장기 메모리로 승격시킵니다. 일자별로 작업 내역이 쌓이기 때문에 에이전트가 이전에 어떤 작업을 수행했는지 추적이 됩니다.

오르카 IDE 블로그 자동화 시스템 설치 방법 총정리!

설치 과정 자체도 AI가 처리합니다. 순서는 간단합니다.

오르카 IDE를 열고 프로젝트 추가 버튼을 누릅니다. 빈 폴더를 하나 만들어서 열어주면 워크스페이스에 "파일 없음"이 표시됩니다. 여기서 클로드 터미널을 실행한 뒤 제공되는 설치 명령어를 붙여넣으면 됩니다.

이 명령어는 LLM이 이해하는 인스톨 가이드 문서에 따라 동작합니다. git clone뿐 아니라 환경 변수 설정, Node.js와 npm 라이브러리 세팅까지 한 번에 진행됩니다. Git이 없으면 Git부터 설치합니다. 완료되면 초록색 박스가 뜹니다.

주의할 점이 하나 있습니다. 설치 후 반드시 세션을 새로 열어야 합니다. 클로드 훅이 세션 오픈 시점에 위키를 읽도록 설정되어 있어서 기존 세션에서는 스킬이 인식되지 않습니다. 새 세션에서 세이브 메모리 커맨드를 실행해보면 스킬이 정상적으로 보이는 걸 확인합니다.

명령어 한 줄로 블로그 글과 이미지 자동 생성

설치가 끝났으면 블로그 작성을 요청하는 명령을 입력합니다. "블로그 하나 써줘" 라고만 말해도 충분합니다.

에이전트가 블로그 콘텐츠를 만드는 과정을 설명드리겠습니다. 가장 먼저 AI가 위키를 읽습니다. 프로젝트 구조와 에이전트 역할, 스킬 정보를 파악한 뒤 블로그 라이터와 이미지 메이커를 순서대로 실행합니다. 블로그 라이터가 클로드 기반으로 글을 작성하고, 완성된 글을 바탕으로 이미지 메이커가 어떤 위치에 어떤 콘텐츠의 이미지를 넣을지 판단해 생성합니다.

이때 이미지 메이커는 백그라운드에서 별도 터미널을 띄워 작업합니다. 화면이 멈춘 것처럼 보여도 하단의 터미널 탭을 눌러보면 작업이 돌아가고 있습니다. 이미지 생성에는 GPT의 최상위 모델이 사용되어 텍스트만 있는 블로그보다 완성도가 높아집니다. 실제 시연에서는 글 작성부터 이미지 2장 생성까지 약 5~10분 내에 완료됐습니다.

생성된 블로그 검수부터 발행까지

작업이 완료되면 로컬 환경에서 바로 확인합니다. 웹을 실행하면 블로그 사이트가 뜨고 어드민에 들어가면 생성된 글이 "검수 중" 상태로 표시됩니다. 에이전트가 직접 발행하지 못하도록 설정해 두었기 때문이죠. 사람이 내용을 확인한 뒤 발행으로 변경하면 블로그 최신글에 노출됩니다.

Supabase 연동이 되도록 구성되어 있어 환경 변수만 세팅하면 정상 동작합니다. 구글 서치 콘솔, 네이버 서치 어드바이저, 빙 등 검색 엔진 연동도 지원합니다. 이 보일러플레이트를 기반으로 댓글 기능을 추가하거나, 추가 콘텐츠를 연결하거나, 블로그가 아닌 새로운 서비스를 개발하는 것까지 확장될 수 있습니다.

AI 블로그 자동화, 구조 설계가 핵심입니다

오르카 IDE와 LLM 위키를 활용한 이 시스템의 핵심은 도구 자체가 아니라 컨텍스트 관리 구조입니다. 위키로 프로젝트 정보를 중앙화하고 클로드 훅으로 자동 로딩하고, 메모리로 작업 이력을 추적하는 세 가지가 맞물려야 에이전트가 일관된 품질을 유지합니다.

코드는 똑똑한개발자 GitHub에 퍼블릭으로 오픈되어 있습니다. 환경 세팅 중 문제가 생기거나 개선 아이디어가 있으시다면 편하게 문의해 주세요.

감사합니다!

AI 네이티브 조직 똑똑한개발자와 사내 AI 도입, AX, 개발을 함께하고 싶다면 아래 링크에 문의를 남겨주세요. 

👉 [똑똑한개발자 문의 남기러 가기]