Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
AI 에이전트의 컨텍스트 유지와 자율적 업무 수행을 위해 GitHub와 Markdown을 활용한 상태 관리(State Management) 아키텍처를 제안합니다. 채팅 UI의 한계를 극복하고 AI와 인간이 공유하는 '공통의 기억 영역'을 구축하는 실천적인 방법을 다룹니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기ChatGPT나 Claude 등의 AI 도구를 업무에 도입했지만, 「채팅 대화가 산만해진다」, 「매번 같은 전제를 설명하는 것이 번거롭다」, 「며칠이 지나면 AI가 문맥을 잊어버린다」와 같은 벽에 부딪히고 계시지 않습니까?
AI를 단순한 「채팅 상대」나 「부분적인 자동화 도구」에서 「자율적으로 프로젝트를 진행하는 파트너」로 끌어올리기 위해서는, **AI와 인간 양측이 읽고 쓸 수 있는 「공통의 기억 영역 (상태 관리, State Management)」**이 필요합니다.
이 기사에서는 GitHub와 Markdown의 조합을 통해, AI 에이전트에게 프로젝트의 상태를 올바르게 인식시키고, 다음에 수행해야 할 태스크를 자율적으로 판단·실행하게 하기 위한 실천적인 아키텍처를 해설합니다.
통상적인 채팅 UI로 AI와 일할 경우, 다음과 같은 문제가 발생합니다.
기억의 휘발과 컨텍스트 윈도우 (Context Window)의 한계: 긴 대화 속에서 초기 제약 사항이나 결정 사항이 잊혀진다. -
채택·기각 안의 혼재: 브레인스토밍 단계의 아이디어와 최종 결정된 사실이 동일한 타임라인상에 섞여 AI가 혼란을 겪는다. -
인간의 수작업 의존: AI가 생성한 텍스트를 인간이 복사하여 파일을 업데이트하는 수고가 남는다.
이러한 문제를 해결하려면 「채팅 이력」에 의존하는 것이 아니라, 「확정된 현재 상태」를 파일로서 유지하는 메커니즘이 필요합니다.
AI에게 프로젝트의 상태를 인식시키기 위해, 리포지토리 내에 역할별 Markdown 파일을 배치합니다.
AGENTS.md / START.md00_CURRENT_STATE.md04_NEXT_ACTIONS.mdthinking_logs/ / EXPERIMENT_LOG.md이 체제를 구축하면 인간과 AI의 작업은 다음과 같이 분리·비동기화됩니다.
START.md와 현재 위치를 읽어 들여, 스스로 플랜을 세우고, 코드나 문서를 다시 쓰고, 검증 로그를 업데이트하며, Pull Request를 작성한다.이 메커니즘은 문서나 시스템 구축뿐만 아니라, 콘텐츠 판매와도 직결됩니다.
예를 들어 이 Zenn 기사 자체도, AI가 과거의 검증 로그를 읽고 과제(AI 운용에 고민하는 계층)를 추출하여, 자동으로 Markdown 파일을 생성·커밋함으로써 집필되었습니다.
인간이 Zenn과 GitHub 리포지토리를 연계(배포 설정)해 두면, AI가 기사를 쓰고 푸시(Push)하는 것만으로, 인간이 Zenn 관리 화면을 열지 않고도 유료 기사로서 자동으로 출판되는 워크플로우가 완성됩니다.
AI의 성능은 급격히 향상되고 있지만, 그것을 최대한으로 끌어내는 것은 **「환경의 설계」**입니다.
GitHub와 Markdown을 통한 상태 관리를 도입함으로써, 인간의 「지시·복사·관리」 수고를 최소화하고, AI가 자율적인 가치 창조를 수행하도록 만드는 것이 가능해집니다.
우선은 당신의 프로젝트 디렉토리에 AGENTS.md
및 CURRENT_STATE.md를 생성하여, AI에게 "현재 상황"을 알려주는 것부터 시작해 보세요.
