VS Code 에이전트 칸반(Agent Kanban): AI 협업 개발자를 위한 작업 관리 확장 프로그램

커뮤니티 반응

작성자가 직접 개발한 도구를 공유했으며, AI 에이전트의 컨텍스트 관리 문제에 공감하는 개발자들에게 유용한 워크플로우를 제시했다.

실용적 조언

AI 에이전트에게 작업을 시킬 때 대화창에만 의존하지 말고, 별도의 마크다운 파일에 현재 계획과 상태를 기록하여 에이전트가 항상 최신 상태를 참조하게 하라.

섹션별 상세

AI 에이전트와의 협업 시 발생하는 '컨텍스트 부패(Context Rot)' 문제를 해결하기 위해 마크다운 파일을 활용한다. 대화가 길어지면 에이전트가 이전의 계획이나 중요한 결정을 잊어버리는 현상을 방지하기 위해, AGENTS.md와 같은 별도의 파일에 계획(Plan), 할 일(Todo), 구현(Implement) 흐름을 기록하여 에이전트가 이를 참조하게 한다.

이 확장 프로그램은 마크다운 파일을 기반으로 작동하므로 GitOps 친화적이며 팀 협업에 용이하다. 모든 작업 상태와 결정 사항이 텍스트 파일로 저장되어 버전 관리가 가능하며, VS Code 내부에서 칸반 보드 형태로 시각화하여 관리할 수 있다. 이는 대화 기록에만 의존할 때보다 정보의 영속성을 보장한다.

사용자가 이미 사용 중인 AI 에이전트 하네스(Harness)를 그대로 활용할 수 있도록 설계되었다. 별도의 AI 모델을 내장하는 대신, 기존의 워크플로우 내에서 @kanban 명령어를 통해 구조화된 작업을 관리하고 에이전트에게 명확한 지침을 제공하는 방식이다. 이를 통해 에이전트가 현재 작업의 맥락을 정확히 파악하도록 돕는다.

용어 해설

컨텍스트 부패(Context Rot): — LLM과의 대화가 길어짐에 따라 초기 지침이나 중요한 맥락 정보가 모델의 컨텍스트 윈도우에서 밀려나거나 주의력이 분산되어 성능이 저하되는 현상이다. 이를 방지하기 위해 중요한 정보는 별도의 영구적인 기록으로 관리하는 것이 권장된다.
깃옵스(GitOps): — Git 저장소를 시스템의 상태를 정의하는 단일 진실 공급원(Source of Truth)으로 삼아 인프라와 애플리케이션의 구성을 관리하는 방식이다. 텍스트 기반의 마크다운 파일을 Git으로 관리함으로써 AI 에이전트의 작업 내역을 투명하게 추적할 수 있다.
칸반(Kanban): — 작업의 흐름을 시각화하여 관리하는 애자일 방법론으로, 보통 '할 일', '진행 중', '완료' 등의 열로 구성된 보드를 사용한다. AI 에이전트의 복잡한 작업 단계를 시각적으로 파악하고 관리하는 데 효과적이다.

언급된 도구

Agent Kanban추천

AI 협업 개발자를 위한 마크다운 기반 VS Code 칸반 보드 확장 프로그램

언급된 리소스

문서Agent Kanban 공식 사이트