Storybloq/storybloq

storybloq은(는) 무엇을 하나요?

Claude Code용 세션 간 컨텍스트 관리 도구입니다. CLI, MCP 서버, /story 스킬을 통해 .story/ 디렉토리에서 티켓, 이슈, 핸드오버, 로드맵을 추적합니다.

개요

Storybloq/storybloq는 Claude Code와 같은 AI 에이전트 환경에서 세션 간 컨텍스트를 유지하는 데 도움을 줍니다. 주요 기능은 다음과 같습니다:

• CLI: 터미널에서 직접 .story/ 디렉토리를 관리합니다.
• MCP 서버: MCP(Model Context Protocol)를 통해 에이전트가 구조화된 방식으로 컨텍스트를 읽고 쓸 수 있게 합니다.
• /story 스킬: 에이전트 프롬프트에 /story 명령어를 포함시켜 현재 작업 컨텍스트를 기록하고 복원합니다.

작동 방식

1. 프로젝트 루트에 .story/ 디렉토리를 생성합니다.
2. 각 작업은 별도의 티켓 파일(.story/tickets/)로 관리됩니다.
3. 이슈는 .story/issues/에 저장됩니다.
4. 핸드오버는 .story/handovers/에 기록되어 세션 전환 시 컨텍스트를 전달합니다.
5. 로드맵은 .story/roadmap/에 저장되어 장기적인 계획을 추적합니다.

사용 예시

# 새로운 티켓 생성
storybloq ticket create "UI 버그 수정"

# 현재 세션 컨텍스트 저장
storybloq save

# 이전 세션 컨텍스트 복원
storybloq restore

MCP 설정

MCP 서버를 사용하려면 Claude Code 설정에 다음을 추가하세요:

{
  "mcpServers": {
    "storybloq": {
      "command": "npx",
      "args": ["-y", "@storybloq/mcp"]
    }
  }
}

/story 스킬 사용

에이전트 프롬프트에 /story를 포함시키면 현재 작업 상태가 자동으로 .story/ 디렉토리에 기록됩니다. 이전 /story 호출의 컨텍스트를 복원하려면 /story restore를 사용하세요.

라이선스

MIT