---
title: "Codereport: repo 안에서 TODO, 리팩터, 버그를 구조적으로 추적하는 CLI 도구"
published: 2026-02-18T23:23:24.000Z
canonical: https://jeff.news/article/997
---
# Codereport: repo 안에서 TODO, 리팩터, 버그를 구조적으로 추적하는 CLI 도구

repo 내 TODO, 리팩터, 버그를 .codereports/ 폴더에 YAML로 저장해 구조적으로 추적하는 CLI 도구. 외부 서비스 의존 없이 CI 블로킹, HTML 대시보드 생성까지 지원함.

- `.codereports/` 폴더에 YAML로 리포트를 저장하는 방식이라 외부 서비스 의존 없이 repo 안에서 모든 추적이 완결됨. 파일+라인 범위, 태그(todo/refactor/buggy/critical), 심각도, 만료일, 소유자까지 구조화해서 관리함
- CI에서 `codereport check`를 돌리면 블로킹 또는 만료된 항목이 있을 때 머지를 막을 수 있음. 히트맵과 KPI가 포함된 HTML 대시보드 생성도 지원함
- TODO가 코드 여기저기 흩어져서 영원히 방치되는 문제를 정면으로 겨냥한 도구임. PR 코멘트나 티켓으로는 실제 행동으로 이어지지 않는다는 현실적 불만에서 출발함

## 핵심 포인트

- .codereports/ 폴더에 YAML로 저장, 파일+라인 범위·태그·심각도·만료일·소유자 추적
- CI에서 블로킹/만료 항목 체크로 머지 차단 가능, HTML 대시보드 생성 지원

## 인사이트

TODO 관리를 외부 티켓 시스템이 아닌 코드 저장소 자체에 구조화해 넣는 접근이 흥미로움. 다만 YAML 파일이 쌓이면서 repo가 지저분해질 수 있다는 트레이드오프가 있음.