Atelier: Claude Code 연동 및 스펙 관리를 위한 VS Code 확장 프로그램

실용적 조언

Claude Code를 사용하는 개발자는 Atelier를 통해 터미널과 에디터 사이의 컨텍스트 스위칭을 줄일 수 있다.
TODO.md 파일을 활용해 에이전트의 작업 진행 상황을 칸반 보드 형태로 시각화하여 관리할 수 있다.

섹션별 상세

Atelier는 VS Code 내에서 에이전트 워크플로우와 스펙 관리를 돕는 도구로 설계됐다. 모든 데이터는 Markdown 파일과 TODO.md를 기반으로 저장되어 저장소 내에서 직접 관리할 수 있는 파일 기반 아키텍처를 채택했다. 사용자가 문서를 작성하면 이를 기반으로 칸반 보드가 자동 생성되어 작업 상태를 추적한다. 별도의 외부 데이터베이스 없이도 프로젝트의 요구사항과 진행 상황을 투명하게 유지할 수 있는 구조이다.

v0.3 업데이트에서 도입된 핵심 기능은 Markdown 문서의 특정 섹션을 하이라이트하여 Claude Code에 수정을 요청하는 기능이다. 사용자가 피드백을 보내면 에이전트가 이를 읽고 Markdown 에디터 내에서 직접 타겟팅된 수정을 제안하는 방식으로 작동한다. 터미널을 오가며 변경 사항을 대조할 필요 없이 에디터 내에서 즉각적인 피드백 루프를 형성한다. 이 기능은 특히 기술 문서의 반복적인 수정 작업에서 개발자의 인지 부하를 크게 줄여준다.

에이전트가 제안한 수정 사항은 개별적으로 수락하거나 거부할 수 있는 인터페이스를 제공한다. 각 수정 제안은 어떤 피드백에 기반했는지와 에이전트의 작업 설명이 포함되어 있어 변경 의도를 명확히 파악할 수 있다. 사용자는 에이전트의 응답을 기다리는 동안에도 직접 코드를 수정할 수 있어 작업 흐름이 끊기지 않는 장점이 있다. 이는 AI와 인간 개발자 간의 비동기적 협업을 원활하게 만드는 핵심 메커니즘이다.

작성자는 이 도구를 통해 기술 문서(Specs)를 최신 상태로 유지하는 부담이 줄었다고 언급했다. 에이전트가 코드베이스를 리서치하고 문서 수정을 돕기 때문에 개발자가 모든 세부 사항을 기억하지 않고도 새로운 기능을 설계할 수 있다. 실제 사용 사례에서 터미널 스크롤링 없이 에디터 내에서 에이전트의 작업을 확인하는 방식이 생산성 향상에 기여했다. 이는 복잡한 프로젝트에서 문서화와 구현 사이의 간극을 좁히는 실무적 이점을 제공한다.

용어 해설

에이전트 워크플로우(Agent Workflow): — AI 에이전트가 특정 작업을 수행하기 위해 거치는 일련의 단계나 처리 과정이다. Atelier는 이를 파일 기반으로 관리하여 개발자가 복잡한 작업을 구조화하고 추적할 수 있게 돕는다.
클로드 코드(Claude Code): — Anthropic에서 개발한 터미널 기반의 AI 코딩 에이전트이다. 코드베이스를 이해하고 직접 코드를 수정하거나 리서치를 수행하는 기능을 제공한다.
칸반 보드(Kanban Board): — 작업의 흐름을 시각화하여 관리하는 도구로, 보통 '할 일', '진행 중', '완료' 등의 상태로 구분한다. 이 툴에서는 TODO.md 파일을 기반으로 칸반 보드를 자동 생성한다.

언급된 도구

Atelier추천

VS Code extension for agent workflow and spec management

Claude Code추천

AI coding agent for research and revisions