refactor: hwp2markdown에서 hwp2md로 프로젝트 이름 변경

Breaking Change: 프로젝트 및 바이너리 이름 변경
- Go 모듈: github.com/roboco-io/hwp2md
- CLI 바이너리: hwp2md
- 설정 디렉토리: ~/.hwp2md

변경 내용:
- go.mod 모듈 이름 변경
- cmd/hwp2markdown → cmd/hwp2md 디렉토리 이동
- 모든 Go 파일 import 경로 업데이트
- Makefile, .goreleaser.yml 업데이트
- README.md, docs/ 문서 업데이트
- 테스트 파일 바이너리 참조 업데이트
- CLAUDE.md 프로젝트 컨텍스트 추가

Closes #17

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: serithemage

.goreleaser.yml

@@ -1,16 +1,16 @@
 version: 2
 
-project_name: hwp2markdown
+project_name: hwp2md
 
 before:
   hooks:
     - go mod tidy
     - go generate ./...
 
 builds:
-  - id: hwp2markdown
-    main: ./cmd/hwp2markdown
-    binary: hwp2markdown
+  - id: hwp2md
+    main: ./cmd/hwp2md
+    binary: hwp2md
     env:
       - CGO_ENABLED=0
     goos:
@@ -67,12 +67,12 @@ changelog:
 release:
   github:
     owner: roboco-io
-    name: hwp2markdown
+    name: hwp2md
   draft: false
   prerelease: auto
   mode: replace
   header: |
-    ## hwp2markdown {{ .Version }}
+    ## hwp2md {{ .Version }}
 
     HWP(한글 워드프로세서) 문서를 Markdown으로 변환하는 CLI 도구입니다.
 
@@ -83,7 +83,7 @@ release:
 
     #### Go 설치
     ```bash
-    go install github.com/roboco-io/hwp2markdown/cmd/hwp2markdown@{{ .Version }}
+    go install github.com/roboco-io/hwp2md/cmd/hwp2md@{{ .Version }}
     ```
 
     ### 주요 기능
@@ -95,15 +95,15 @@ release:
 
     ---
 
-    **Full Changelog**: https://github.com/roboco-io/hwp2markdown/compare/{{ .PreviousTag }}...{{ .Tag }}
+    **Full Changelog**: https://github.com/roboco-io/hwp2md/compare/{{ .PreviousTag }}...{{ .Tag }}
 
-    자세한 변경 내역은 [CHANGELOG.md](https://github.com/roboco-io/hwp2markdown/blob/main/CHANGELOG.md)를 참조하세요.
+    자세한 변경 내역은 [CHANGELOG.md](https://github.com/roboco-io/hwp2md/blob/main/CHANGELOG.md)를 참조하세요.
 
 # Homebrew (향후 지원 예정)
 # brews:
 #   - repository:
 #       owner: roboco-io
 #       name: homebrew-tap
-#     homepage: https://github.com/roboco-io/hwp2markdown
+#     homepage: https://github.com/roboco-io/hwp2md
 #     description: HWP to Markdown converter CLI tool
 #     license: MIT

CHANGELOG.md

@@ -7,6 +7,23 @@
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-01-10
+
+### 변경
+- **Breaking Change**: 프로젝트 이름 변경 `hwp2markdown` → `hwp2md`
+  - Go 모듈: `github.com/roboco-io/hwp2md`
+  - CLI 바이너리: `hwp2md`
+  - GitHub 저장소: `roboco-io/hwp2md`
+
+### 마이그레이션 안내
+```bash
+# 기존 설치 제거
+go clean -i github.com/roboco-io/hwp2markdown/cmd/hwp2markdown
+
+# 새 버전 설치
+go install github.com/roboco-io/hwp2md/cmd/hwp2md@latest
+```
+
 ## [0.2.2] - 2025-01-10
 
 ### 변경
@@ -46,7 +63,7 @@
 ## [0.1.0] - 2024-01-10
 
 ### 추가
-- hwp2markdown CLI 도구 초기 릴리즈
+- hwp2md CLI 도구 초기 릴리즈
 - 2단계 파이프라인 아키텍처:
   - Stage 1: 중간 표현(IR)을 사용한 HWPX 파서
   - Stage 2: LLM 기반 Markdown 포맷팅 (선택적)
@@ -78,8 +95,9 @@
 - 모듈형 LLM 프로바이더 아키텍처
 - 종합적인 테스트 커버리지
 
-[Unreleased]: https://github.com/roboco-io/hwp2markdown/compare/v0.2.2...HEAD
-[0.2.2]: https://github.com/roboco-io/hwp2markdown/compare/v0.2.1...v0.2.2
-[0.2.1]: https://github.com/roboco-io/hwp2markdown/compare/v0.2.0...v0.2.1
-[0.2.0]: https://github.com/roboco-io/hwp2markdown/compare/v0.1.0...v0.2.0
-[0.1.0]: https://github.com/roboco-io/hwp2markdown/releases/tag/v0.1.0
+[Unreleased]: https://github.com/roboco-io/hwp2md/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/roboco-io/hwp2md/compare/v0.2.2...v0.3.0
+[0.2.2]: https://github.com/roboco-io/hwp2md/compare/v0.2.1...v0.2.2
+[0.2.1]: https://github.com/roboco-io/hwp2md/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/roboco-io/hwp2md/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/roboco-io/hwp2md/releases/tag/v0.1.0

CLAUDE.md

@@ -0,0 +1,72 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build & Test Commands
+
+```bash
+make build          # Build binary to bin/hwp2md
+make test           # Run all tests with race detection and coverage
+make lint           # Run golangci-lint
+make fmt            # Format code
+make tidy           # Run go mod tidy
+
+# Run a single test
+go test -v -run TestName ./internal/parser/hwpx/
+
+# E2E tests
+make test-e2e
+```
+
+## Architecture
+
+hwp2md uses a **2-stage pipeline** to convert HWP/HWPX documents to Markdown:
+
+```
+HWP/HWPX → Stage 1 (Parser) → IR → Stage 2 (LLM, optional) → Markdown
+```
+
+### Stage 1: Parser (`internal/parser/`)
+- **HWPX Parser** (`hwpx/parser.go`): Native XML-based parser for HWPX format (default)
+- **Upstage Parser** (`upstage/upstage.go`): Optional external API parser, outputs `RawMarkdown` directly (bypasses IR conversion)
+
+### IR - Intermediate Representation (`internal/ir/`)
+- `Document`: Root container with `Metadata`, `Content` (blocks), and optional `RawMarkdown`
+- Block types: `Paragraph`, `Table`, `Image`, `List`
+- Upstage parser stores markdown directly in `doc.RawMarkdown`, skipping block-level IR
+
+### Stage 2: LLM Providers (`internal/llm/`)
+- Common interface: `Provider` with `Format(ctx, doc, opts)` method
+- Providers: `anthropic/`, `openai/`, `gemini/`, `upstage/`, `ollama/`
+- Model name auto-detection: `claude-*` → Anthropic, `gpt-*` → OpenAI, etc.
+
+### CLI (`internal/cli/`)
+- Entry point: `cmd/hwp2md/main.go`
+- Commands: `convert` (default), `extract`, `config`, `providers`
+- `convert.go`: Main conversion logic, parser selection, LLM formatting
+
+## Key Files
+
+| File | Purpose |
+|------|---------|
+| `internal/cli/convert.go` | Main conversion pipeline, parser/LLM orchestration |
+| `internal/parser/hwpx/parser.go` | HWPX XML parsing, table/cell span handling |
+| `internal/ir/ir.go` | IR document structure definitions |
+| `internal/llm/provider.go` | LLM provider interface |
+| `internal/llm/prompt.go` | System prompts for LLM formatting |
+
+## Environment Variables
+
+| Variable | Purpose |
+|----------|---------|
+| `HWP2MD_PARSER` | Parser selection: `native` (default), `upstage` |
+| `HWP2MD_LLM` | Enable Stage 2: `true` |
+| `HWP2MD_MODEL` | Model name (auto-detects provider) |
+| `HWP2MD_BASE_URL` | Private API endpoint (Bedrock, Azure, local) |
+| `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_API_KEY`, `UPSTAGE_API_KEY` | Provider API keys |
+
+## Conventions
+
+- Korean is the primary language for CLI messages, comments, and documentation
+- Cell merge handling: rowspan → `〃`, colspan → empty cell
+- Special whitespace elements (`<hp:fwSpace/>`, `<hp:hwSpace/>`) → regular space

Makefile

@@ -2,10 +2,10 @@
 
 VERSION ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev")
 LDFLAGS := -ldflags="-s -w -X main.version=$(VERSION)"
-BINARY := hwp2markdown
+BINARY := hwp2md
 
 build:
-	go build $(LDFLAGS) -o bin/$(BINARY) ./cmd/hwp2markdown
+	go build $(LDFLAGS) -o bin/$(BINARY) ./cmd/hwp2md
 
 test:
 	go test -v -race -cover ./...
@@ -27,10 +27,10 @@ hooks:
 
 release: clean
 	mkdir -p dist
-	GOOS=windows GOARCH=amd64 go build $(LDFLAGS) -o dist/$(BINARY)-windows-x64.exe ./cmd/hwp2markdown
-	GOOS=darwin GOARCH=amd64 go build $(LDFLAGS) -o dist/$(BINARY)-macos-x64 ./cmd/hwp2markdown
-	GOOS=darwin GOARCH=arm64 go build $(LDFLAGS) -o dist/$(BINARY)-macos-arm64 ./cmd/hwp2markdown
-	GOOS=linux GOARCH=amd64 go build $(LDFLAGS) -o dist/$(BINARY)-linux-x64 ./cmd/hwp2markdown
+	GOOS=windows GOARCH=amd64 go build $(LDFLAGS) -o dist/$(BINARY)-windows-x64.exe ./cmd/hwp2md
+	GOOS=darwin GOARCH=amd64 go build $(LDFLAGS) -o dist/$(BINARY)-macos-x64 ./cmd/hwp2md
+	GOOS=darwin GOARCH=arm64 go build $(LDFLAGS) -o dist/$(BINARY)-macos-arm64 ./cmd/hwp2md
+	GOOS=linux GOARCH=amd64 go build $(LDFLAGS) -o dist/$(BINARY)-linux-x64 ./cmd/hwp2md
 
 run: build
 	./bin/$(BINARY) $(ARGS)

README.md

@@ -1,9 +1,9 @@
-# hwp2markdown
+# hwp2md
 
 [![Go Version](https://img.shields.io/badge/Go-1.24+-00ADD8?style=flat&logo=go)](https://go.dev/)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Build](https://github.com/roboco-io/hwp2markdown/actions/workflows/test.yml/badge.svg)](https://github.com/roboco-io/hwp2markdown/actions/workflows/test.yml)
-[![Go Report Card](https://goreportcard.com/badge/github.com/roboco-io/hwp2markdown)](https://goreportcard.com/report/github.com/roboco-io/hwp2markdown)
+[![Build](https://github.com/roboco-io/hwp2md/actions/workflows/test.yml/badge.svg)](https://github.com/roboco-io/hwp2md/actions/workflows/test.yml)
+[![Go Report Card](https://goreportcard.com/badge/github.com/roboco-io/hwp2md)](https://goreportcard.com/report/github.com/roboco-io/hwp2md)
 
 HWP(한글 워드프로세서) 문서를 Markdown으로 변환하는 CLI 도구
 
@@ -61,34 +61,34 @@ Stage 1만으로도 기본적인 변환이 가능하지만, 복잡한 레이아
 ### Go 설치 (권장)
 
 ```bash
-go install github.com/roboco-io/hwp2markdown/cmd/hwp2markdown@latest
+go install github.com/roboco-io/hwp2md/cmd/hwp2md@latest
 ```
 
 ### 바이너리 다운로드
 
-[GitHub Releases](https://github.com/roboco-io/hwp2markdown/releases)에서 플랫폼별 바이너리를 다운로드할 수 있습니다.
+[GitHub Releases](https://github.com/roboco-io/hwp2md/releases)에서 플랫폼별 바이너리를 다운로드할 수 있습니다.
 
 | 플랫폼 | 아키텍처 | 파일 |
 |--------|----------|------|
-| Windows | x64 | `hwp2markdown_*_windows_amd64.zip` |
-| macOS | Intel | `hwp2markdown_*_darwin_amd64.tar.gz` |
-| macOS | Apple Silicon | `hwp2markdown_*_darwin_arm64.tar.gz` |
-| Linux | x64 | `hwp2markdown_*_linux_amd64.tar.gz` |
+| Windows | x64 | `hwp2md_*_windows_amd64.zip` |
+| macOS | Intel | `hwp2md_*_darwin_amd64.tar.gz` |
+| macOS | Apple Silicon | `hwp2md_*_darwin_arm64.tar.gz` |
+| Linux | x64 | `hwp2md_*_linux_amd64.tar.gz` |
 
 ## 사용법
 
 ### 기본 변환 (Stage 1만)
 
 ```bash
 # HWPX 파일을 Markdown으로 변환
-hwp2markdown document.hwpx -o output.md
+hwp2md document.hwpx -o output.md
 
 # 표준 출력으로 변환
-hwp2markdown document.hwpx
+hwp2md document.hwpx
 ```
 
 > **Note**: `convert` 명령어는 기본 명령이므로 생략할 수 있습니다.
-> `hwp2markdown document.hwpx`와 `hwp2markdown convert document.hwpx`는 동일합니다.
+> `hwp2md document.hwpx`와 `hwp2md convert document.hwpx`는 동일합니다.
 
 ### Upstage Document Parse 사용 (Stage 1 - 선택적)
 
@@ -97,11 +97,11 @@ hwp2markdown document.hwpx
 ```bash
 # Upstage Document Parse 사용
 export UPSTAGE_API_KEY="your-api-key"
-hwp2markdown document.hwpx --parser upstage
+hwp2md document.hwpx --parser upstage
 
 # 환경변수로 설정
 export HWP2MD_PARSER="upstage"
-hwp2markdown document.hwpx
+hwp2md document.hwpx
 ```
 
 > **Note**: Upstage Document Parse는 API 키가 필요하며 사용량에 따라 비용이 발생합니다. 대부분의 HWPX 문서는 내장 파서로 충분히 변환됩니다.
@@ -113,32 +113,32 @@ LLM을 사용하면 더 자연스럽고 읽기 쉬운 Markdown을 생성할 수
 ```bash
 # Anthropic Claude 사용 (기본)
 export ANTHROPIC_API_KEY="your-api-key"
-hwp2markdown convert document.hwpx --llm
+hwp2md convert document.hwpx --llm
 
 # OpenAI GPT 사용
 export OPENAI_API_KEY="your-api-key"
-hwp2markdown convert document.hwpx --llm --provider openai
+hwp2md convert document.hwpx --llm --provider openai
 
 # Google Gemini 사용
 export GOOGLE_API_KEY="your-api-key"
-hwp2markdown convert document.hwpx --llm --provider gemini
+hwp2md convert document.hwpx --llm --provider gemini
 
 # Upstage Solar 사용
 export UPSTAGE_API_KEY="your-api-key"
-hwp2markdown convert document.hwpx --llm --provider upstage
+hwp2md convert document.hwpx --llm --provider upstage
 
 # Ollama 사용 (로컬)
-hwp2markdown convert document.hwpx --llm --provider ollama --model llama3.2
+hwp2md convert document.hwpx --llm --provider ollama --model llama3.2
 ```
 
 ### IR 추출
 
 ```bash
 # JSON 형식으로 IR 추출
-hwp2markdown extract document.hwpx -o output.json
+hwp2md extract document.hwpx -o output.json
 
 # 텍스트 형식으로 추출
-hwp2markdown extract document.hwpx --format text
+hwp2md extract document.hwpx --format text
 ```
 
 ### 환경 변수
@@ -168,13 +168,13 @@ AWS Bedrock, Azure OpenAI, 로컬 서버 등 프라이빗 엔드포인트를 사
 
 ```bash
 # AWS Bedrock
-hwp2markdown convert document.hwpx --llm --model claude-3-sonnet --base-url https://bedrock-runtime.us-east-1.amazonaws.com
+hwp2md convert document.hwpx --llm --model claude-3-sonnet --base-url https://bedrock-runtime.us-east-1.amazonaws.com
 
 # Azure OpenAI
-hwp2markdown convert document.hwpx --llm --model gpt-4 --base-url https://your-resource.openai.azure.com
+hwp2md convert document.hwpx --llm --model gpt-4 --base-url https://your-resource.openai.azure.com
 
 # 로컬 서버
-hwp2markdown convert document.hwpx --llm --model llama3.2 --base-url http://localhost:8080
+hwp2md convert document.hwpx --llm --model llama3.2 --base-url http://localhost:8080
 ```
 
 ## 지원 포맷
@@ -205,8 +205,8 @@ hwp2markdown convert document.hwpx --llm --model llama3.2 --base-url http://loca
 
 ```bash
 # 저장소 클론
-git clone https://github.com/roboco-io/hwp2markdown.git
-cd hwp2markdown
+git clone https://github.com/roboco-io/hwp2md.git
+cd hwp2md
 
 # 의존성 다운로드
 go mod download
@@ -224,8 +224,8 @@ make lint
 ### 프로젝트 구조
 
 ```
-hwp2markdown/
-├── cmd/hwp2markdown/      # CLI 엔트리포인트
+hwp2md/
+├── cmd/hwp2md/      # CLI 엔트리포인트
 ├── internal/
 │   ├── cli/               # CLI 명령 구현
 │   ├── config/            # 설정 관리

cmd/hwp2markdown/main.go cmd/hwp2md/main.gocmd/hwp2markdown/main.go renamed to cmd/hwp2md/main.go

@@ -3,7 +3,7 @@ package main
 import (
 	"os"
 
-	"github.com/roboco-io/hwp2markdown/internal/cli"
+	"github.com/roboco-io/hwp2md/internal/cli"
 )
 
 var version = "dev"