Skip to main content
Glama
deenesjakoruzh
backloghq

backlog

by backloghq
OverviewSchemaRelated ServersScoreDiscussions
TypeScript

backlog

GitHub stars License: MIT CI Docs

Claude Code를 위한 지속적이고 세션 간 작업 관리 도구입니다. 작업이 세션 간에 유지되므로 한 에이전트가 시작한 작업을 다른 에이전트가 이어받을 수 있습니다.

@backloghq/agentdb를 기반으로 구축되었으며, 타입이 지정된 스키마, 자동 증가 ID, 가상 필터, 블롭 저장소를 지원합니다. 순수 TypeScript로 작성되었으며 네이티브 종속성이 없습니다.

설치

/plugin marketplace add backloghq/backlog
/plugin install backlog@backloghq-backlog

소스에서 설치

git clone https://github.com/backloghq/backlog.git
cd backlog && npm install && npm run build
claude --plugin-dir /path/to/backlog

독립형 MCP 서버

프로젝트의 .claude/settings.json에 추가하세요:

{
  "mcpServers": {
    "backlog": {
      "command": "node",
      "args": ["/path/to/agent-teams-task-mcp/dist/index.js"],
      "env": {
        "TASKDATA": "/path/to/task-data"
      }
    }
  }
}

스킬

스킬

설명

/backlog:tasks

현재 백로그 표시 — 대기 중, 활성, 차단됨, 기한 초과 작업

/backlog:plan

목표를 종속성, 우선순위, 사양을 포함한 작업으로 세분화

/backlog:standup

일일 스탠드업 — 완료됨, 진행 중, 차단됨, 다음 작업

/backlog:refine

백로그 정리 — 모호한 작업 수정, 누락된 우선순위, 깨진 종속성, 오래된 항목 수정

/backlog:spec

구현 전 작업에 대한 사양 문서 작성

/backlog:implement

작업을 선택하고 사양을 읽은 후 구현하고 완료 표시

/backlog:handoff

다음 세션 준비 — 진행 상황 주석 달기, 활성 작업 중지, 상태 요약

에이전트

task-planner 에이전트는 누군가 작업을 계획해야 할 때 Claude에 의해 자동으로 호출될 수 있습니다. 코드베이스를 읽고, 목표를 종속성이 있는 작업으로 분해하며, 복잡한 항목에 대한 사양을 작성합니다.

후크

이벤트

기능

SessionStart

세션 시작 시 대기 중인 작업 수 표시

TaskCreated

Claude의 내장 작업을 지속적 백로그와 동기화

TaskCompleted

Claude가 내장 작업을 완료하면 일치하는 백로그 작업을 완료로 표시

SubagentStart

생성된 에이전트에 할당되지 않은 대기 중인 작업을 자동 할당

도구 (MCP)

전체 작업 수명 주기 관리를 위한 24개의 도구:

도구

설명

task_list

필터 구문을 사용하여 작업 쿼리. 모든 필드가 포함된 JSON 배열 반환.

task_count

필터와 일치하는 작업 수 계산. task_list와 동일한 구문.

task_add

새로운 대기 중인 작업 생성. 설명만 필수이며, 다른 모든 필드는 선택 사항.

task_log

이미 완료된 작업을 완료 상태로 직접 기록.

task_modify

필터와 일치하는 하나 이상의 작업을 부분 업데이트. 제공된 필드만 변경됨.

task_duplicate

선택적 필드 재정의를 사용하여 기존 작업 복사.

task_done

종료 타임스탬프와 함께 작업을 완료로 표시.

task_delete

작업을 소프트 삭제. task_undo로 복원 가능. 영구 삭제는 task_purge 사용.

task_annotate

타임스탬프가 찍힌 메모 추가. 더 긴 내용은 task_doc_write 사용.

task_denotate

정확한 텍스트 일치를 통해 주석 제거.

task_start

작업을 활발히 작업 중인 상태로 표시. +ACTIVE 쿼리에서 확인 가능.

task_stop

작업 중지. 대기 중 상태로 되돌림.

task_undo

가장 최근 작업 취소. 반복적으로 호출 가능.

task_info

ID 또는 UUID로 단일 작업의 전체 JSON 세부 정보 가져오기.

task_import

JSON 배열에서 작업을 대량 생성. 원자적 배치 작업.

task_purge

삭제된 작업을 영구적으로 제거. 되돌릴 수 없음.

task_doc_write

작업에 마크다운 문서(사양, 메모, 컨텍스트) 첨부/교체.

task_doc_read

작업에 첨부된 마크다운 문서 읽기.

task_doc_delete

작업의 문서 제거. 영구적임.

task_archive

오래된 완료/삭제된 작업을 분기별 아카이브 세그먼트로 이동.

task_archive_list

사용 가능한 아카이브 세그먼트 나열.

task_archive_load

읽기 전용 검사를 위해 아카이브된 작업 로드.

task_projects

대기 중/반복 작업이 있는 프로젝트 이름 나열.

task_tags

대기 중/반복 작업이 있는 태그 나열.

필터 구문

status:pending                    # all pending tasks
project:backend +bug              # bugs in backend project
priority:H due.before:friday      # high priority due before friday
+OVERDUE                          # overdue tasks
+ACTIVE                           # tasks currently being worked on
+BLOCKED                          # tasks blocked by dependencies
+READY                            # actionable tasks (past scheduled date)
agent:explorer                    # tasks assigned to the explorer agent
( project:web or project:api )    # boolean with parentheses
description.contains:auth         # substring match

속성 수정자(.before, .after, .by, .has, .not, .none, .any, .startswith, .endswith), 태그(+tag, -tag), 가상 태그(+OVERDUE, +ACTIVE, +BLOCKED, +READY, +TAGGED, +ANNOTATED 등) 및 불리언 연산자(and, or)를 지원합니다.

작업 문서

모든 작업에 마크다운 문서(사양, 컨텍스트, 인수인계 메모)를 첨부하세요:

task_doc_write  id:"1"  content:"# Spec\n\nBuild the auth flow.\n"
task_doc_read   id:"1"
task_doc_delete id:"1"

문서를 작성하면 +doc 태그와 has_doc:yes가 추가되어 에이전트가 문서가 있는 작업을 검색할 수 있습니다:

task_list filter:"+doc"
task_list filter:"has_doc:yes"

에이전트 식별

작업은 어떤 에이전트가 작업을 소유하는지 추적하기 위한 agent 필드를 지원합니다:

task_add  description:"Investigate bug"  agent:"explorer"
task_list filter:"agent:explorer status:pending"

프로젝트 격리

각 프로젝트는 자동으로 자체 작업 데이터를 가집니다. 플러그인으로 사용될 때 작업 데이터는 ~/.claude/plugins/data/backlog/projects/<project-slug>/에 저장됩니다. 독립형으로 사용될 때는 TASKDATA를 명시적으로 설정하세요.

변수

설명

TASKDATA

작업 데이터 디렉토리에 대한 명시적 경로 (자동 파생보다 우선)

TASKDATA_ROOT

자동 파생된 프로젝트별 작업 데이터의 루트 디렉토리

BACKLOG_BACKEND

저장소 백엔드: 파일 시스템(기본값)은 생략, Amazon S3는 s3

BACKLOG_S3_BUCKET

S3 버킷 이름 (BACKLOG_BACKEND=s3일 때 필수)

BACKLOG_S3_REGION

AWS 리전 (기본 자격 증명 사용 시 선택 사항)

S3 백엔드

팀 공유 또는 클라우드 지속성을 위해 S3에 작업 데이터를 저장합니다. @backloghq/opslog-s3가 필요합니다:

npm install @backloghq/opslog-s3

.claude/settings.json의 환경 변수를 통해 구성하세요:

{
  "mcpServers": {
    "backlog": {
      "command": "node",
      "args": ["/path/to/backlog/dist/index.js"],
      "env": {
        "TASKDATA": "my-project/tasks",
        "BACKLOG_BACKEND": "s3",
        "BACKLOG_S3_BUCKET": "my-team-backlog",
        "BACKLOG_S3_REGION": "us-east-1"
      }
    }
  }
}

S3를 사용할 때 TASKDATA는 파일 시스템 경로 대신 버킷의 키 접두사가 됩니다.

Docker

docker build -t backlog .
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \
  | docker run --rm -i backlog

개발

npm install
npm run build          # compile TypeScript
npm run lint           # run ESLint
npm test               # run tests (189 tests)
npm run test:coverage  # run tests with coverage
npm run dev            # watch mode

커뮤니티

backlog가 유용하다면 별표를 눌러주세요. 다른 사람들이 프로젝트를 찾는 데 도움이 됩니다.

라이선스

MIT

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/backloghq/backlog'

If you have feedback or need assistance with the MCP directory API, please join our Discord server