Claude Code용 프로젝트 트래커 'Storybloq' 오픈소스 공개: .story/ 디렉토리에 티켓, 이슈, 세션 기록 저장
I open sourced a project tracker for Claude Code that lives in .story/: tickets, issues, and session handovers as files
핵심 요약
Claude Code 세션 간의 맥락 유실을 방지하기 위해 프로젝트 상태를 로컬 파일로 저장하는 오픈소스 도구 'Storybloq'을 소개함.
- 프로젝트 기억력 — Claude Code 세션 간의 맥락 유실을 방지하기 위해 티켓, 이슈, 세션 핸드오버를 파일로 저장함.
- 로컬 저장 방식 — 외부 도구 대신 프로젝트 내 .story/ 디렉토리에 데이터를 보관하여 git으로 관리함.
- 간편한 연동 — npm으로 설치 가능하며 Claude가 세션 시작 시 상태를 불러오고 종료 시 자동으로 저장함.
- 개발자 도구 — 솔로 개발자나 소규모 프로젝트를 위해 설계되었으며 실시간 칸반 보드를 지원하는 맥 앱도 제공함.
저는 제 Claude Code 워크플로우를 위해 Storybloq(이전 명칭 Claude Story)을 만들었고, Storybloq을 만드는 데 Storybloq 자체를 사용했습니다. 리포지토리의 .story/ 디렉토리는 프로젝트 개발 전반에 걸쳐 모든 티켓, 이슈, 세션 핸드오버를 추적해왔으므로, 이 도구는 그 자체로 가장 오래 실행된 테스트 케이스입니다. 유용할 것 같아 공유합니다. 무료이며 오픈소스입니다.
문제는 모든 새로운 Claude Code 세션이 이전 세션을 잊어버린다는 것입니다. 그래서 아키텍처를 다시 설명하고, 이미 해결한 트레이드오프를 다시 논쟁해야 하며, 긴 프로젝트에서는 코드베이스가 조금씩 표류하게 됩니다.
Storybloq은 리포지토리에 일반 JSON 및 마크다운으로 구성된 .story/ 디렉토리를 제공합니다. 티켓, 이슈, 로드맵 단계, 메모, 교훈, 세션 핸드오버 등 모든 것이 사람이 편집 가능하고 git으로 추적됩니다. 세션 시작 시 /story를 입력하면 Claude가 모든 것을 불러옵니다. 세션이 끝나면 상태가 다시 기록되어 다음 세션이 이전 세션이 끝난 지점부터 시작할 수 있습니다.
추적 항목:
- 로드맵 단계별로 정리된 티켓
- 세션 중간에 발견된 버그에 대한 이슈
- 세션 전반에 걸쳐 축적되는 메모와 교훈
- 세션 핸드오버(결정 사항, 차단 요소, 다음 단계)
- 리포지토리에 모두 포함된 현재 상태
Claude가 작업함에 따라 업데이트되는 라이브 칸반이 포함된 무료 네이티브 Mac 앱도 있습니다.
설치:
npm install -g @storybloq/storybloq@latest
storybloq setup-skill
이 도구는 팀을 위한 GitHub Issues, Linear, Jira를 대체하려는 것이 아닙니다. Claude Code를 사용하는 솔로 개발자와 소규모 프로젝트를 위해 리포지토리 내부에 가벼운 프로젝트 메모를 남기려는 목적입니다.
공개: 제가 만들었습니다. 무료, 오픈소스, 계정 필요 없음, 유료 티어 없음, 추천 링크 없음. 데이터는 어떤 에디터에서든 읽을 수 있는 파일 형태로 리포지토리에 남습니다.
멀티 세션 Claude Code 작업을 하시는 분들께 한 가지 궁금한 점이 있습니다. 이 상태를 리포지토리 내부의 파일로 추적하시겠습니까, 아니면 외부 도구(Linear, Jira, GitHub Issues)에 보관하고 Claude가 거기서 읽게 하시겠습니까? 저는 gh repo clone을 해도 유지된다는 이유로 리포지토리 내부 방식을 선택했지만, 반대쪽 주장도 일리가 있다고 봅니다.
