Fix - Backlog Manager

Track bugs, improvements, and tech debt in backlog.md.
버그, 개선사항, 기술 부채를 backlog.md로 관리하는 스킬입니다.

Usage / 사용법

/fix                        # Show open items / 미해결 목록 표시
/fix "description"          # Auto-classify and add / 자동 분류 등록
/fix bug "description"      # Add to Bugs / Bugs 섹션에 등록
/fix improve "description"  # Add to Improvements / Improvements 섹션에 등록
/fix debt "description"     # Add to Tech Debt / Tech Debt 섹션에 등록
/fix done                   # Complete (select) / 완료 처리 (선택형)
/fix done [ID]              # Complete specific / 특정 항목 완료
/fix clean                  # Clean completed / 완료 항목 정리

The first argument determines the command: $ARGUMENTS

---

Project Detection / 프로젝트 감지 규칙

1. CWD-based - Uses current working directory as project root / 현재 작업 디렉토리를 프로젝트 루트로 사용
2. Git root detection - git rev-parse --show-toplevel / Git root로 프로젝트 루트 확인
3. Project name - Git root folder name / git root 폴더명 사용

backlog.md search order / backlog.md 탐색 순서:

1. .claude-docs/backlog.md
2. .claude/docs/backlog.md
3. docs/backlog.md
4. BACKLOG.md
5. backlog.md

Document folder (for new files) / 문서 폴더 결정 (신규 생성 시):

1. .claude-docs/ if exists / 존재하면 여기에 생성
2. .claude/docs/ if exists / 존재하면 여기에 생성
3. docs/ if exists / 존재하면 여기에 생성
4. Otherwise: backlog.md in CWD / 그 외: CWD에 생성

---

Argument Parsing / 인수 파싱 규칙

Check first token of $ARGUMENTS:

1. bug, improve, debt, done, clean → subcommand / 서브커맨드로 처리
2. Anything else (or starts with quotes) → treat as description, auto-classify / 전체를 설명으로 취급, 자동 분류

Examples / 예시:

/fix bug Login keyboard overlap         → bug subcommand
/fix improve Loading speed              → improve subcommand
/fix debt deprecated API replacement    → debt subcommand
/fix Card animation flickering          → auto-classify (not a subcommand)
/fix done B1                            → done subcommand, ID: B1
/fix done                               → done subcommand, no ID (select)
/fix clean                              → clean subcommand
/fix                                    → no args, show open items
/fix 카드 애니메이션 깜빡임              → auto-classify

---

backlog.md Format / backlog.md 형식

# Backlog

**Last Updated:** YYYY-MM-DD

## Bugs
- [ ] B1 Login keyboard overlap (2026-02-03)
- [x] B2 Card animation flicker (2026-02-03) -- 2026-02-03

## Improvements
- [ ] I1 Loading speed optimization (2026-02-03)

## Tech Debt
- [ ] T1 deprecated API replacement (2026-02-03)

ID System / ID 체계

• Bugs: B1, B2, B3...
• Improvements: I1, I2, I3...
• Tech Debt: T1, T2, T3...
• IDs are never reused (gaps allowed: B1, B3 OK) / ID는 재사용하지 않음

Date Recording / 날짜 기록

• Registered: (YYYY-MM-DD) in parentheses / 등록일
• Completed: -- YYYY-MM-DD appended after checkbox / 완료일 추가

Next ID Logic / 다음 ID 결정 방법

Find highest number in the section and add 1.
해당 섹션의 기존 항목에서 가장 큰 번호를 찾아 +1합니다.

• Bugs has B1, B3 → next is B4
• Improvements is empty → I1

---

Command: (default) - Open Items / 미해결 목록 표시

Shows open items from backlog.md.
backlog.md의 미해결 항목을 표시합니다.

Runs when no arguments are given. / 인수가 없는 경우 실행됩니다.

Steps / 수행 단계:

1. Search for backlog.md (see search order) / backlog.md 파일 탐색
2. Read file / 파일 읽기
3. Filter open (- [ ]) items only / 미해결 항목만 필터링
4. Group by section and output / 섹션별로 그룹화하여 출력

Output format / 출력 형식:

📋 Backlog Status / 현황

🐛 Bugs (2 open / 2개)
- B1 Login keyboard overlap (2026-02-03)
- B3 Network error handling missing (2026-02-03)

💡 Improvements (1 open / 1개)
- I1 Loading speed optimization (2026-02-03)

🔧 Tech Debt (1 open / 1개)
- T1 deprecated API replacement (2026-02-03)

Total: 4 open items / 총 4개 미해결

If no file found / 파일 없는 경우:

📋 No backlog found / Backlog 없음

💡 Add your first item with / 첫 항목 등록:
   /fix bug "description"
Example / 예: /fix bug Login keyboard overlap

---

Command: bug / improve / debt - Add Item / 항목 등록

Adds an item to the specified section.
지정된 섹션에 항목을 등록합니다.

Syntax / 구문:

/fix bug description
/fix improve description
/fix debt description

Section mapping / 섹션 매핑:

Subcommand	Section	ID Prefix
bug	Bugs	B
improve	Improvements	I
debt	Tech Debt	T

Steps / 수행 단계:

1. Search backlog.md (create if missing) / backlog.md 탐색 (없으면 생성)
2. Find last ID in section / 해당 섹션에서 마지막 ID 확인
3. Assign new ID (last + 1) / 새 ID 부여
4. Add item with today's date / 오늘 날짜와 함께 추가
5. Update Last Updated / 갱신
6. Save / 저장

Output format / 출력 형식:

✅ Added / 등록: B3 Login keyboard overlap

📍 Section / 섹션: Bugs
📅 Date / 등록일: 2026-02-03

---

Command: Auto-classify / 자동 분류 등록

When first token is not a subcommand, the full text is treated as description and auto-classified by keywords.
첫 토큰이 서브커맨드가 아닌 경우, 전체 텍스트를 설명으로 취급하고 키워드로 자동 분류합니다.

Syntax / 구문:

/fix Card animation flickering
/fix deprecated package cleanup

Auto-classify keywords / 자동 분류 키워드:

Category	Keywords
Bug	버그, 에러, 오류, 깨짐, 안됨, 깜빡, crash, error, bug, fix, broken, fail, 실패, not working, issue, problem
Improve	개선, 향상, 빠르게, 속도, UX, UI, improve, better, enhance, 최적화, optimize, performance, slow
Tech Debt	deprecated, 리팩토링, 정리, 마이그레이션, refactor, cleanup, migrate, legacy, 레거시, upgrade

Classification rules / 분류 규칙:

1. Case-insensitive keyword search in description / 대소문자 무관 키워드 검색
2. If matched: use that category / 매칭되면 해당 분류
3. Multiple matches: first match wins (Bug > Improve > Tech Debt) / 먼저 매칭된 분류 우선
4. No match: default to Bug / 매칭 없으면 기본값: Bug

Output format / 출력 형식:

✅ Added / 등록: B3 Card animation flickering

📍 Section / 섹션: Bugs (auto-classified / 자동 분류: "flickering" keyword)
📅 Date / 등록일: 2026-02-03

---

Command: done - Mark Complete / 완료 처리

Marks an item as completed.
항목을 완료로 표시합니다.

Syntax / 구문:

/fix done B1       # Specific item / 특정 항목 완료
/fix done          # Select from list / 선택형 완료 (AskUserQuestion)

Steps (with ID) / 수행 단계 (ID 지정 시):

1. Find item by ID in backlog.md / backlog.md에서 해당 ID 찾기
2. Change - [ ] → - [x] / 변경
3. Append -- YYYY-MM-DD completion date / 완료일 추가
4. Update Last Updated / 갱신
5. Save / 저장

Steps (no ID) / 수행 단계 (ID 미지정 시):

1. Extract open items from backlog.md / 미해결 항목 추출
2. AskUserQuestion to select items (multiSelect: true) / 항목 선택
3. Mark selected items as complete / 선택된 항목 완료 처리
4. Save / 저장

Output format / 출력 형식:

✅ Done / 완료: B1 Login keyboard overlap

📅 Completed / 완료일: 2026-02-03
📋 Remaining open / 남은 미해결: 3

If ID not found / ID를 찾을 수 없는 경우:

❌ B99 not found / 찾을 수 없습니다.

📋 Open items / 미해결 항목:
- B1 Login keyboard overlap
- B3 Network error handling missing

---

Command: clean - Remove Completed / 완료 항목 정리

Removes completed items ([x]) from backlog.md.
완료된 항목을 backlog.md에서 제거합니다.

Steps / 수행 단계:

1. Find - [x] items in backlog.md / 완료 항목 찾기
2. AskUserQuestion to confirm / 정리 확인:
   • "Remove N completed items? / 완료된 N개 항목을 정리하시겠습니까?"
   • Options: "Clean / 정리" / "Cancel / 취소"
3. Remove on confirm / 확인 시 완료 항목 제거
4. Update Last Updated / 갱신
5. Save / 저장

Output format / 출력 형식:

🧹 Cleaned / 정리 완료

Removed items / 삭제된 항목 (3):
- B2 Card animation flicker (completed / 완료: 2026-02-03)
- I2 Loading indicator added (completed / 완료: 2026-02-03)
- T1 deprecated API replacement (completed / 완료: 2026-02-03)

📋 Remaining open / 남은 미해결: 2

If no completed items / 완료 항목이 없는 경우:

📋 No completed items to clean / 정리할 완료 항목이 없습니다.

---

backlog.md Initial Template / 초기 생성 템플릿

Auto-created when first item is added and no backlog.md exists.
backlog.md가 없을 때 첫 항목 등록 시 자동 생성합니다.

# Backlog

**Last Updated:** YYYY-MM-DD

## Bugs

## Improvements

## Tech Debt

Key Rules / 핵심 규칙:

1. 3 sections required - Bugs, Improvements, Tech Debt / 3개 섹션 필수
2. Section headings - Exact match: ## Bugs, ## Improvements, ## Tech Debt / 정확히 일치
3. Item format - - [ ] {ID} {description} (YYYY-MM-DD) / 항목 형식
4. Completed format - - [x] {ID} {description} (YYYY-MM-DD) -- YYYY-MM-DD / 완료 형식
5. Last Updated - Refresh on every change / 변경 시마다 갱신

---

Integration with /plan, /task / 연계

/plan  →  plan.md    (Feature planning / 기능 기획)
/task  →  plan.md    (Task progress tracking / 기획서 내 진행률 추적)
/fix   →  backlog.md (Bugs/fixes/improvements / 버그/수정/개선)

• Each tool works independently / 각 도구는 독립적으로 동작
• Large backlog items → /plan add to escalate → /fix done to close / 큰 항목은 plan으로 이관
• Bugs found during plan work → /fix bug "description" to register / plan 진행 중 발견된 버그 등록

---

Command Reference / 명령어 정리

Command	Action	Agent	Purpose
/fix	Open items list / 미해결 목록	No	Check status / 현황 확인
/fix "desc"	Auto-classify add / 자동 분류 등록	No	Quick add / 빠른 등록
/fix bug "desc"	Add to Bugs / 등록	No	Report bug / 버그 등록
/fix improve "desc"	Add to Improvements / 등록	No	Suggest improvement / 개선 등록
/fix debt "desc"	Add to Tech Debt / 등록	No	Log tech debt / 기술부채 등록
/fix done [ID]	Mark complete / 완료 처리	No	Close item / 항목 완료
/fix clean	Clean completed / 완료 정리	No	Tidy up / 정리

---

Related Skills

Part of the plan-task-fix suite:

• /plan - Plan document management (plan.md) / 기획서 관리
• /task - Task tracking and progress (plan.md) / 태스크 추적
• /fix - Bug/improvement backlog (backlog.md) / 백로그 관리

Install: npx skills add wintree86/plan-task-fix