인수인계서 — 세션 19 (자주 쓰는 명령어 뷰 추가)
작성일: 2026-02-17 이전 세션: session18
작업 요약
00-UI-program에 "자주 쓰는 명령어" 뷰를 9번째 뷰로 추가. 14개 기본 명령어를 4개 카테고리(Claude Code, Git, 개발 도구, 시스템)로 분류하여 카드 형태로 표시. 검색+카테고리 필터+복사 기능 포함.
수정 파일 (6개)
| # | 파일 | 변경 내용 |
|---|---|---|
| 1 | 00-UI-program/ui/views/tabletop/command_list_view.py | 신규 — CommandListView 클래스 + CommandEntry 데이터 모델 + 14개 기본 명령어 |
| 2 | 00-UI-program/app/config.py | TABLETOP_NAV_ITEMS에 ("command_list", "자주 쓰는 명령어") 추가 |
| 3 | 00-UI-program/ui/components/navigation.py | ICONS에 "command_list": "⌨" 추가 |
| 4 | 00-UI-program/ui/views/tabletop/__init__.py | CommandListView import + all 추가 |
| 5 | 00-UI-program/ui/main_window.py | CommandListView import + views 딕셔너리에 등록 |
| 6 | 00-UI-program/CLAUDE.md | 뷰 목록에 "명령어목록" 추가 |
상세 변경 사항
1. CommandListView 구현
- 데이터 모델:
CommandEntry데이터클래스 (title, command, description, category, tags) - 4개 카테고리: Claude Code(5), Git(4), 개발 도구(3), 시스템(2) = 14개 명령어
- 핵심 명령어:
claude --dangerously-skip-permissions(첫 번째 항목) - UI 기능:
- 카테고리 필터 버튼 (전체/Claude Code/Git/개발 도구/시스템)
- 검색 (제목/명령어/설명/태그 전문 검색)
- 명령어 복사 버튼 (복사 완료 피드백)
- 카테고리별 색상 뱃지
- "전체" 모드에서 카테고리별 그룹 헤더
등록된 기본 명령어 (14개)
| # | 카테고리 | 명령어 | 설명 |
|---|---|---|---|
| 1 | Claude Code | claude --dangerously-skip-permissions | 권한 스킵 자동승인 모드 |
| 2 | Claude Code | claude | CLI 대화형 모드 실행 |
| 3 | Claude Code | claude --continue | 마지막 대화 이어서 실행 |
| 4 | Claude Code | claude -p "..." | 프롬프트 직접 전달 |
| 5 | Claude Code | claude --model claude-opus-4-6 | 모델 지정 실행 |
| 6 | Git | git status | 변경 상태 확인 |
| 7 | Git | git add -A && git commit -m "..." && git push | 전체 커밋+푸시 |
| 8 | Git | git log --oneline -20 | 최근 로그 간략 보기 |
| 9 | Git | git diff | 변경 비교 |
| 10 | 개발 도구 | npm run dev | Next.js 개발 서버 |
| 11 | 개발 도구 | uv run python main.py | UV 환경 Python 실행 |
| 12 | 개발 도구 | npm install | 의존성 설치 |
| 13 | 시스템 | netstat -ano | findstr :3000 | 포트 사용 확인 |
| 14 | 시스템 | taskkill /F /PID <PID> | 프로세스 종료 |
터치하지 않은 영역
- 기존 8개 뷰 (대시보드, 시스템맵, 시나리오, 검증, 갭분석, 커버리지, 규칙검증, 스킬카탈로그)
- 서비스 레이어 전체
- 데이터 모델/로더
- _COMPONENT_MAP.md, 레퍼런스 파일들
알려진 이슈
- 명령어 데이터가
command_list_view.py에 하드코딩 → 외부 JSON/YAML 분리 권장
다음 작업 제안
- 명령어 데이터를
data/commands.json으로 분리 (사용자가 직접 편집 가능하도록) - 명령어 추가/편집/삭제 UI 기능
- 명령어 즐겨찾기/핀 기능
- 실 프로젝트에서
/kdygenesis실전 검증