Backlog.md
마크다운 파일로 굴러가는 프로젝트 보드
npm i -g backlog.md폴더 하나를 마크다운 파일만으로 굴러가는 프로젝트 보드로 바꾸는 CLI 입니다. 에이전트가 만든 코드를 다 읽을 수 없다는 문제를 두고, 구현 전에 작업 명세와 인수 조건을 먼저 검토하는 세 단계 체크포인트를 제안합니다. MCP 서버로도 붙어 에이전트가 같은 백로그를 봅니다.
판단
이럴 때 씁니다
- 에이전트가 만든 코드량이 검토 가능한 범위를 넘어설 때
- 구현 전에 작업 명세와 인수 조건을 먼저 보고 싶을 때
- 작업 관리를 외부 서비스 없이 저장소 안에서 하고 싶을 때
- 사람과 에이전트가 같은 작업 목록을 봐야 할 때
이럴 땐 쓰지 마세요
- 이미 지라나 리니어 같은 도구가 팀에 자리 잡았을 때
- 작업이 단순해 목록 관리 자체가 과할 때
- 마크다운 파일이 저장소에 늘어나는 것이 부담일 때
차별점
- 폴더 하나를 마크다운만으로 굴러가는 보드로 바꿉니다.
- 설정 없이 시작하며 외부 서비스가 필요 없습니다.
- CLI·TUI·웹·MCP 에서 같은 데이터를 봅니다.
- 구현 전 명세 검토를 세 체크포인트 중 첫 단계로 명시합니다.
워크플로
- 01npm i -g backlog.md 로 설치합니다.
- 02프로젝트 폴더에서 초기화하면 마크다운 기반 보드가 생깁니다.
- 03아이디어를 작업으로 분해하고 인수 조건을 적습니다.
- 04구현 전에 명세를 검토하는 첫 체크포인트를 거칩니다.
- 05MCP 로 붙이면 에이전트가 같은 백로그를 보고 작업합니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm i -g backlog.md | CLI 를 전역 설치합니다. |
claude mcp add backlog --scope user -- backlog mcp start | 클로드 코드에 MCP 서버로 등록합니다. |
backlog board | 터미널에서 보드를 봅니다. |
함정
설치 전에 확인하세요
- 작업이 마크다운 파일로 쌓이므로 저장소에 파일이 늘어납니다.
- CLI·TUI·웹 모달·MCP 로 진입점이 여러 개라 팀에서 쓸 때 경로를 정해야 합니다.
- 의존 관계 그래프는 v1.51.0 부터입니다. 이전 버전에서는 볼 수 없습니다.
- 작업 분해 품질은 결국 에이전트와 사람에게 달려 있습니다.
비교
OpenSpec 이 무엇을 만들지 명세로 합의시키는 단계에 집중한다면, Backlog.md 는 그 결과를 작업으로 쪼개 진행을 관리합니다. 순서로 보면 OpenSpec 다음이 Backlog.md 에 가깝고, 둘 다 검토 지점을 만들려는 목적은 같습니다.
최근 변경
2026-09-02 v1.51.0 에서 작업 상세에 의존 관계 그래프가 들어갔습니다. 직접·간접 의존을 CLI·plain·json·TUI·웹 모달·MCP 모두에서 보여주며 그래프는 코어에서 한 번만 계산합니다.