1. 현상과 원인을 구분해 기록합니다
타임아웃 인시던트와 영향을 받는 결제 구성요소를 부채 제안에 연결합니다. 관찰된 지연과 공통 의존성을 리팩터링해야 한다는 가설은 구분하세요.
CLAUDE · CODEX 플러그인 기반 무료 PRD·SOT 기획서
기술 부채 관리 시스템 PRD 템플릿 | 무료 기획서
기술 부채를 어떤 근거로 등록하고, 영향과 작업량을 비교하며, 개선 승인과 효과 검증으로 이어갈지 정리하세요. 기술 부채 대장과 검토 흐름을 설계하는 무료 PRD·기획서를 제공합니다.
가이드 업데이트:
GitHub 원본 보기 · MIT licensed
USE CASE
이 템플릿이 필요한 팀
기술 부채를 발견·평가·해결하는 엔지니어링 리더·개발자·제품 담당자 및 엔지니어링 생산성·아키텍처 운영 담당자를 위한 사내 운영 시스템을 설계하는 팀
CONTENTS
기획안에 포함된 내용
- 부채 항목·영향 범위·증거·위험·예상 작업량·개선 제안 등록
- 부채 인벤토리·영향·증거·우선순위·해결 계획·진행·검증 이력 조회
- 부채 식별·영향과 증거 검토·우선순위 결정·개선 투자 승인·완화 작업·효과 검증·재평가 처리
- 부채 규모·우선순위·해결률·개선 리드타임·재작업·성능·위험 감소 리포트
VIBESPEC VIEWER
기획안을 화면으로 확인하세요
각 화면은 공개 SOT 파일에서 생성한 실제 기획 결과입니다.
라이브 데모에서 이 화면 열기 
라이브 데모에서 이 화면 열기 
라이브 데모에서 이 화면 열기 
라이브 데모에서 이 화면 열기 PRACTICAL GUIDE
기술 부채 관리 시스템을 바로 사용하고 우리 팀에 맞게 확장하는 방법
엔지니어링 리더, 개발자, 제품 담당자, 아키텍처 운영자가 기술 부채 투자를 비교할 수 있도록 부채 인벤토리, 영향 범위, 증거, 위험, 예상 작업량, 해결 계획과 검증 이력을 연결한 기획안입니다. 팀은 제품 작업과 부채 개선을 같은 기준으로 우선순위화하고, 투자 승인·완화·완료·재평가 결정을 근거와 함께 남깁니다. HTML로 운영 기준을 검토한 뒤 SOT JSON을 VibeSpec에서 조직의 계획 주기와 책임 구조에 맞게 수정할 수 있습니다.
활용 예시: 반복되는 결제 타임아웃
실제 개선 성과가 아닌 가상의 검토 연습입니다. 막연한 리팩터링 요청을 근거와 결정이 있는 제안으로 바꿔보세요.
2. 완화 조치와 개선 범위를 비교합니다
단기 완화와 큰 리팩터링의 작업량, 의존성, 우선 진행 또는 보류 이유를 담당자에게 확인합니다. 선택한 범위를 기획에서 명확히 표시하세요.
3. 해결과 재개방의 기준을 정합니다
변경 효과를 검증할 근거와 항목을 다시 여는 조건을 정합니다. SOT의 백분율 목표는 기획 목표이며 실제 개선이 일어났다는 증거가 아닙니다.
이 기술 부채 관리 시스템에 실제로 포함된 핵심 요소
근거가 있는 기술 부채 대장
SOT는 부채 항목·영향·증거·위험·예상 작업량·개선 제안을 다룹니다. 영향을 받는 구성요소와 문제를 적고, 관찰된 사실과 아직 확인하지 못한 가설을 구분하세요.
목록과 결정 이력
부채 목록, 담당자, 우선순위, 개선 계획, 검증 이력이 검토의 맥락을 이룹니다. 보류한 항목도 사유와 함께 남겨 이전 결정을 다시 확인할 수 있게 합니다.
투자 승인과 개선 흐름
근거 검토, 우선순위 결정, 투자 승인, 완화 작업, 효과 검증, 재평가를 기획합니다. 단계별 결정권자와 다음 상태로 이동할 근거를 합의하세요.
해결률과 효과 리포트
해결률, 개선 리드타임, 재작업, 성능, 위험 감소가 제안된 보고 범위입니다. 원본이 실제 성과를 제공하는 것은 아니므로 기준선과 완료 조건을 엔지니어링 담당자와 정해야 합니다.
권한과 변경 근거
접근 권한과 이력 기반에서 부채 제안, 개선 승인, 결과 확인의 역할을 구분하세요. 누가 왜 우선순위를 바꾸었는지 검토할 수 있어야 합니다.
기획 경험 없이 시작하는 3단계
1. 완성된 HTML을 팀과 함께 검토합니다
다운로드한 HTML은 별도 설치 없이 브라우저에서 열립니다. PRD, 기능 명세, 화면 구조, 유저 플로우를 보며 현재 업무와 다른 지점을 표시하세요.
2. 우리 조직의 기준을 정합니다
실제 사용자 역할, 필수 입력값, 승인 기준, 예외 상황, 성공 지표를 적습니다. 처음에는 부채 항목·영향 범위·증거·위험·예상 작업량·개선 제안 등록부터 부채 식별·영향과 증거 검토·우선순위 결정·개선 투자 승인·완화 작업·효과 검증·재평가 처리까지의 핵심 흐름에 집중하세요.
3. SOT JSON을 VibeSpec에 전달합니다
Claude 또는 Codex 대화에 SOT JSON을 첨부하고 바꾸고 싶은 내용을 평문으로 요청하세요. VibeSpec이 요구사항, 기능, 화면, 유저 플로우의 연결을 유지하며 수정안을 만듭니다.
우리 팀의 기술 부채 관리 시스템으로 바꾸는 순서
부채 항목의 필수 정보 정하기
영향 구성요소, 근거, 영향도, 작업량 추정, 담당자, 결정 이력을 정합니다. 모든 요청을 긴급으로 표시하기보다 검증하지 못한 영향을 따로 표시하세요.
우선순위 정책 선택하기
영향·위험을 작업량·의존성과 비교합니다. 동점, 보류, 개선 인력 투입의 승인자를 정의하세요. 이 템플릿이 모든 팀에 맞는 단일 점수 산식을 정해주는 것은 아닙니다.
검증과 재개방 기준 맞추기
완료 기준선, 검토 기간, 담당자, 근거를 합의합니다. 재개방한 항목을 해결률에 어떻게 반영할지 정한 다음 KPI 구현을 요청하세요.
다음 단계에서 추가할 수 있는 기술 부채 관리 시스템 기능
증거 수집 연동
정적 분석, 성능 모니터링, 장애·재작업 기록, 이슈 트래커에서 부채 근거 후보를 가져오되 중복 병합, 소유자 확인, 오탐 반려를 거쳐 인벤토리에 등록하도록 확장할 수 있습니다.
로드맵·용량 계획 연동
제품 로드맵과 팀 용량 계획에 승인된 개선 작업을 연결하고 분기별 투자 한도, 제품 일정 의존성, 연기 사유를 부채 결정 기록으로 되돌릴 수 있습니다.
개선 효과 검증
해결 전후의 리드타임, 재작업, 장애, 성능, 운영 위험 기준선을 비교하고 개선 효과가 없거나 부채가 재발했을 때 재평가하는 흐름을 추가할 수 있습니다.
VibeSpec에 바로 요청할 수 있는 예시
리팩터링 요청을 부채 제안으로 바꾸기
이 기술 부채 SOT를 바탕으로 반복되는 결제 타임아웃의 개선 제안을 만들어줘. 관찰 근거와 원인 가설을 나누고 영향·담당자·작업량·대안·검증 기준을 질문한 뒤 관련 기획을 수정해줘.두 개선 범위 비교
이 SOT에서 단기 완화와 큰 리팩터링을 비교하도록 도와줘. 장단점, 의존성, 승인, 보류 범위를 남겨줘. 코드를 분석했다거나 어느 대안이 문제를 해결한다고 단정하지 마.해결률 측정 기준 검토
분기 내 상위 우선순위 부채 해결률을 측정 준비도 관점에서 검토해줘. 우선순위 확정일, 분모, 완료 근거, 재개방 규칙, 마감 시점을 질문하고 목표 수치와 실측 성과를 구분해줘.기술 부채 관리 시스템 활용 FAQ
개발 경험이 없어도 이 템플릿을 사용할 수 있나요?
네. 완성된 HTML은 브라우저에서 바로 열어 검토하고 공유할 수 있습니다. 우리 팀에 맞춘 수정은 SOT JSON을 Claude 또는 Codex의 VibeSpec 플러그인에 전달하고 평문으로 요청하면 됩니다.
이 기획안에는 무엇이 포함되어 있나요?
부채 항목·영향 범위·증거·위험·예상 작업량·개선 제안 등록, 부채 인벤토리·영향·증거·우선순위·해결 계획·진행·검증 이력 조회, 부채 식별·영향과 증거 검토·우선순위 결정·개선 투자 승인·완화 작업·효과 검증·재평가 처리, 부채 규모·우선순위·해결률·개선 리드타임·재작업·성능·위험 감소 리포트의 핵심 요소와 역할·권한·감사·알림·연동을 확장할 수 있는 기준을 포함합니다.
HTML과 SOT JSON은 어떻게 다른가요?
HTML은 읽고 공유하는 완성된 기획안입니다. SOT JSON은 VibeSpec이 요구사항, 기능, 화면, 유저 플로우의 연결을 유지하며 수정할 수 있는 원본 데이터입니다.
KPI Measurement Check가 코드 품질을 자동 보증하나요?
아닙니다. KPI Measurement Check는 해결률이나 재작업 감소 KPI를 계산할 기록과 기준이 준비되었는지 검토합니다. 코드 품질 전반을 자동 진단하거나 보증하는 기능은 아닙니다.
기술 부채 자동 분석기나 Excel 대장을 제공하나요?
제공물은 HTML PRD와 수정 가능한 SOT JSON입니다. 기술 부채 대장과 검토 흐름을 설계할 수 있습니다. 스프레드시트 내보내기, 저장소 분석, 이슈 트래커 연동은 별도 확장 범위입니다.
WORKFLOW
VibeSpec으로 활용하는 법
- 완성된 HTML을 바로 열어 검토하거나 공유합니다.
- SOT JSON을 내려받아 VibeSpec 뷰어에서 불러옵니다.
- 내 팀의 기능·화면·플로우로 수정합니다.