Claude와 Obsidian — QA 업무에 두 도구를 활용하는 방법

AI 요약

AI 도구로 업무 속도가 빨라질수록 QA 담당자는 테스트 시나리오를 빠뜨리지 않고 다루는 방법을 고민하게 됩니다. 글쓴이는 노트를 체계적으로 관리하고 반복 작업을 줄이기 위해 Obsidian을 Claude와 함께 사용합니다.

Obsidian을 선택한 이유

Obsidian은 Markdown 파일을 컴퓨터에 로컬로 저장하는 노트 및 지식 관리 앱입니다. 글쓴이는 시각적 설정에 시간을 많이 쓰게 되는 Notion 대신, 노트 작성에 집중할 수 있는 Obsidian으로 옮겼습니다. 업무 환경에서 데이터 보안을 중요하게 여겨 로컬 저장을 선호하며, Markdown 형식이 AI 도구와 연동하기에도 편리하다고 설명합니다.

QA 업무용 템플릿

글쓴이는 자주 작성하는 문서에 맞춰 템플릿을 만듭니다. 기술 작업용 템플릿은 데이터베이스 마이그레이션, consumer, API 작업의 테스트 계획을 작성할 때 사용합니다. 비즈니스 작업용 템플릿은 Product Owner와 product discovery를 진행하며 기능의 테스트 범위와 위험, 위험 완화 방안, 성공 측정 방법을 정리하는 데 씁니다. 회의록 템플릿에는 회의 기본 정보와 기록을 남기거나 직접 진행할 회의의 순서를 준비합니다.

Claude Skills로 반복 작업 줄이기

테스트 계획 생성 Skill은 Jira 작업 ID를 입력받아 작업 내용을 확인합니다. 글쓴이가 CLAUDE.md에 지정한 기준에 따라 Confluence의 참고 자료도 찾은 뒤, 앞서 만든 템플릿을 활용해 Markdown 테스트 계획 파일을 작성합니다.

다른 Skill은 Atlassian MCP와 연동해 테스트 계획 작성 플래그가 설정된 작업을 찾고, 결과를 Obsidian Kanban 플러그인에서 관리하는 Markdown 파일에 추가합니다. Zephyr용 Skill은 계획한 테스트를 테스트 관리 도구 Zephyr에 게시합니다.

Obsidian에서 Claude Code와 Skills 실행

글쓴이는 Kanban 플러그인 외에도 Obsidian을 벗어나지 않고 Claude Code를 실행하고, 자신이 만든 Skills를 확인하고 실행하고 싶었습니다. 커뮤니티 플러그인 목록에서 필요한 기능을 찾지 못해 두 플러그인을 직접 만들었습니다. 하나는 작업 중인 vault 폴더에서 터미널을 열어 Claude Code를 실행합니다. 다른 하나는 사용 가능한 Skills를 보여주고 Obsidian에서 바로 실행합니다. 두 플러그인은 아직 완성판이 아니며 커뮤니티 스토어에도 등록되지 않았습니다.

생성 결과 검토와 개선

AI가 만든 테스트 계획과 데이터가 적절한지, 설명이 분명한지, 빠진 항목은 없는지 팀 피드백을 받아 확인합니다. 템플릿도 검토 결과에 따라 맥락을 더하거나 불필요한 내용을 빼며 수정합니다. 글쓴이는 자동 생성에만 맡기지 않고 검증과 반복적인 개선을 업무 흐름에 포함합니다.

원문: dev.to / 번역·요약: Trawling