VS Code용 확장 프로그램으로 TODO를 Kanban 보드와 Jira의 실제 이슈로 변환

Source: Dev.to

코드에 TODO가 많이 포함되는 경우가 흔합니다.
그리고 팀은 대부분의 TODO가 실제 작업으로 이어지지 않을 것이라는 것을 알고 있습니다.
주석 속에 묻혀 잊혀지고, 점점 보이지 않는 기술 부채가 됩니다.

문제점

대부분의 프로젝트에서 기술 부채는 코드 주석에 흩어져 있습니다:

// TODO: refatorar isso
// FIXME: tratar edge case
// NOTE: melhorar performance

이것들은 실제로 해결해야 할 일들이지만 Jira에 등록되지 않고, 스프린트에도 포함되지 않으며, 우선순위도 없고 보통 담당자도 없습니다.
즉, 백로그가 코드의 현실을 반영하지 못하고 있습니다.

아이디어

TODO를 실제 백로그 아이템처럼 다루면 어떨까요?

TODO Board는 VS Code용 확장 프로그램으로:

• 프로젝트를 스캔하여 TODO, FIXME, NOTE 등을 찾습니다.
• 에디터 내에서 Kanban 스타일 보드에 모두 정리하고, 검색, 라벨, 텍스트 및 날짜 필터를 제공합니다.
• 클릭 한 번으로 TODO를 Jira 이슈로 변환할 수 있어 복사·붙여넣기 없이 컨텍스트를 잃지 않습니다.

확장 기능이 하는 일

• TODO, FIXME, NOTE 등을 찾아 프로젝트를 스캔합니다.
• VS Code 내 보드에 모두 정리합니다.
• 파일, 라인, 연령, 우선순위를 표시합니다.
• 에디터에서 바로 Jira 이슈를 생성합니다.
• 코드 컨텍스트를 자동으로 이슈에 채워 넣습니다.
• 재스캔 시 TODO ↔ 이슈 연관성을 유지합니다.
• 라벨 및 우선순위 추가가 가능합니다.

설정

TODO Board는 프로젝트 내 스캐너 동작 방식을 완전히 사용자 정의할 수 있습니다.

파일 확장자

"todo-board.fileExtensions": [
  "ts", "tsx", "js", "jsx", "vue", "py", "go", "rb", "php", "rs", "swift"
]

검색 패턴

"todo-board.searchPatterns": ["@TODO", "FIXME", "BUG"]

TODO당 최대 라인 수

"todo-board.maxTodoLines": 4

시각적 강조

"todo-board.highlight.enabled": true,
"todo-board.highlight.highPriorityColor": "#e74c3c",
"todo-board.highlight.mediumPriorityColor": "#ffa94d",
"todo-board.highlight.lowPriorityColor": "#4dabf7"

Jira와의 올바른 통합

통합은 OAuth 2.0 (3LO)와 안전한 백엔드를 사용하므로:

• 확장 프로그램이 Jira API와 직접 통신하지 않습니다.
• 모든 통신은 백엔드를 거칩니다.
• 토큰은 안전하게 저장됩니다.
• 앱은 최소한의 권한만 요청합니다.
• 사용자는 자신이 접근 권한이 있는 프로젝트에만 이슈를 생성할 수 있습니다.

왜 유용한가

• 기술 부채가 눈에 보이게 됩니다.
• 백로그가 코드 현실을 반영하게 됩니다.
• 보다 예측 가능한 계획 수립이 가능합니다.
• 잊혀진 TODO가 줄어듭니다.
• 재작업이 감소합니다.

코드가 드디어 백로그와 대화하게 됩니다.

오픈 소스

프로젝트는 오픈 소스로, 여기서 확인할 수 있습니다:

• GitHub:
• 공식 마켓플레이스의 확장:

피드백, 이슈 및 PR을 언제든 환영합니다 🙂