필수 핵심 도구만 모은 NECESSARY.md 문서 추가

2026-10-14 16:03:42 +09:00
1 parent 1de104e30c
commit 8f2177b3b5
@@ -0,0 +1,37 @@
+# 필수 유틸 모음 문서 작성 계획 (NECESSARY-DOC-IMP-PLAN)
+
+## 1. 개요
+사용자가 지정한 핵심 필수 유틸리티만 선별하여 별도의 단독 문서인 `NECESSARY.md`를 구성합니다.
+
+선정 대상 도구:
+- **터미널 관리**: tmux
+- **시스템 & 컨테이너**: bottom, Docker, ctop
+- **개발 유틸리티**: lazygit, uv
+- **AI 개발 에이전트 & 도우미**: Antigravity CLI (agy), Claude Code, Codex CLI, graphify
+
+```mermaid
+flowchart TD
+    Start([시작]) --> Plan[계획서 작성]
+    Plan --> Filter[README.md에서 지정 도구 추출]
+    Filter --> CreateDoc[NECESSARY.md 작성<br/>Bash/Windows 설치 명령어 및 핵심 사용법]
+    CreateDoc --> Report[완료 보고서 작성]
+    Report --> Graphify[graphify 지식 그래프 갱신]
+    Graphify --> GitCommit[Git 커밋 및 푸시]
+    GitCommit --> Done([완료])
+```
+
+## 2. 작업 단계 및 체크리스트
+
+### 단계 1: 실행 계획 수립 및 구조 설계
+- [x] 작업 계획서(`VIBE-WORK/261014/NECESSARY-DOC-IMP-PLAN.md`) 작성
+
+### 단계 2: `NECESSARY.md` 작성
+- [x] 개요 및 카테고리 구성 (터미널, 시스템/컨테이너, 개발 도구, AI 에이전트 및 도우미)
+- [x] 각 도구별 원클릭 설치 스크립트 (macOS/Linux bash & Windows PowerShell/CMD)
+- [x] 각 도구별 핵심 단축키 및 기본 사용법 정리
+- [x] 문서 서식 및 링크 점검
+
+### 단계 3: 완료 보고서 작성 및 Graphify 갱신 / Git 배포
+- [x] 완료 보고서(`VIBE-WORK/261014/NECESSARY-DOC-PHASE01.md`) 작성
+- [x] `uv tool run --from graphifyy graphify update .` 실행
+- [x] Git commit 및 push
@@ -0,0 +1,42 @@
+# 필수 유틸 모음 문서 작성 완료 보고서 (NECESSARY-DOC-PHASE01)
+
+## 1. 개요
+사용자 요청에 따라 전체 도구 목록 중 꼭 필요한 핵심 도구만을 선별하여 간결하고 명확하게 정리한 `NECESSARY.md` 문서를 작성하였습니다.
+
+선별된 핵심 도구:
+- **tmux**: 터미널 세션 관리 및 화면 분할
+- **bottom (btm)**: 경량 TUI 시스템 리소스 모니터링
+- **Docker**: 컨테이너 가상화
+- **ctop**: 실시간 컨테이너 모니터링
+- **lazygit**: 키보드 중심의 직관적 Git TUI
+- **uv**: 초고속 차세대 Python 패키지/프로젝트 관리자
+- **agy (Antigravity CLI)**: Google DeepMind 기반 터미널 코딩 에이전트
+- **claude (Claude Code)**: Anthropic 공식 코딩 어시스턴트
+- **codex (Codex CLI)**: OpenAI 공식 로컬 코딩 에이전트
+- **graphify**: 코드베이스 지식 그래프 분석 및 에이전트 연동 도구
+
+```mermaid
+mindmap
+  root((NECESSARY.md))
+    터미널 관리
+      tmux / psmux
+    시스템 및 컨테이너
+      bottom
+      Docker
+      ctop
+    개발 유틸리티
+      lazygit
+      uv
+    AI 에이전트 및 도우미
+      agy
+      claude
+      codex
+      graphify
+```
+
+## 2. 주요 구성 내용
+1. **도구 소개 및 공식 링크**: 카테고리별 10개 핵심 도구 요약
+2. **원클릭 빠른 설치 가이드**:
+   - macOS / Linux (Bash 단일 명령)
+   - Windows PowerShell 및 CMD 원클릭 스크립트
+3. **도구별 핵심 사용법 및 단축키 요약**: 실무에서 가장 자주 쓰이는 단축키와 커맨드 위주로 집약 구성