개발 프로젝트에서 어떤 기능이 구현되었는지 추적하고 문서화하는 작업은 많은 개발자가 번거롭게 여기는 부분입니다. 이러한 문제를 해결하기 위해 '피처 렛저(feature-ledger)'라는 새로운 오픈소스 도구가 등장했습니다. 이 도구는 프로젝트에 구현된 모든 기능을 자동으로 기록하고, 이를 고객, 경영진, 또는 신규 팀원이 쉽게 이해할 수 있는 형태의 문서로 변환해줍니다. 커밋 로그나 일반적인 변경 이력(changelog)과는 달리, 제품의 핵심 역량에 초점을 맞춰 가독성 높은 보고서를 생성하는 것이 특징입니다.
피처 렛저의 핵심은 프로젝트 저장소 내에 작은 JSON 형태의 코퍼스(.ledger/ 디렉토리)로 기능 정보를 관리한다는 점입니다. 각 기능은 하나의 JSON 파일로 저장되며, 릴리스 타임라인도 함께 기록됩니다. 이 코퍼스를 기반으로 FEATURES.md, FEATURES_EXTENDED.md, DEV_FEATURES.md와 같은 마크다운 문서와 릴리스별 PDF 보고서가 자동으로 생성됩니다. 특히, 이 도구는 언어나 코딩 에이전트에 구애받지 않고 작동하도록 설계되어 파이썬, 고(Go), 레일즈 등 어떤 프로젝트에서도 활용할 수 있습니다. CLI(명령줄 인터페이스)를 통해 기능 추가, 업데이트, 삭제, 빌드 등의 작업을 수행하며, 수십에서 수백 개의 기능이 있는 대규모 프로젝트에서도 효율적인 관리가 가능합니다.
이 도구의 가장 큰 장점은 '기능의 고도(altitude)'를 일관되게 유지한다는 것입니다. 즉, 제품을 사용하는 사람이 인지할 수 있는 '하나의 역량'을 하나의 항목으로 정의하여, 불필요하게 세분화되거나 너무 추상적인 문서가 되는 것을 방지합니다. 예를 들어, '데모할 수 있는가?', '옆의 기능과 데모가 확연히 다른가?'와 같은 기준을 통해 핵심 기능을 명확히 구분합니다. 이는 고객에게 제품의 변화를 명확하게 전달하고, 경영진에게는 개발 초점을 효과적으로 보고하며, 신규 팀원에게는 프로젝트의 전체적인 맥락을 빠르게 파악하도록 돕는 중요한 역할을 합니다. 결과적으로, 개발팀은 문서화 부담을 줄이고, 이해관계자들은 제품의 현재 상태와 변화를 정확하게 파악할 수 있게 되어 소통 효율성이 크게 향상될 것으로 기대됩니다.