From b956d8ae81a3c037003604c98a69ade54b759a29 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EC=A1=B0=EC=9E=AC=EC=A4=91?=
 <126754298+m-a-king@users.noreply.github.com>
Date: Sun, 12 Jul 2026 00:32:46 +0900
Subject: [PATCH] =?UTF-8?q?chore:=20=EC=98=9B=20=EC=84=9C=EB=B9=84?=
 =?UTF-8?q?=EC=8A=A4=EB=AA=85=20=EC=82=B0=EB=AC=B8=20=ED=91=9C=EA=B8=B0?=
 =?UTF-8?q?=EB=A5=BC=20core=C2=B7renderer=20=EB=A1=9C=20=EC=A0=95=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- org 이관·repo 소문자화(PIKI-Server→core, PIKI-Extractor→extractor, PIKI-HeadlessBrowser→renderer)에 맞춰 CLAUDE.md·README·docs/api-contract.md·build.gradle.kts·코드 주석·테스트 주석에 남아있던 옛 이름 표기를 새 이름으로 정리
- README 의 관련 repo 링크(https://github.com/depromeet/PIKI-Server)도 이관된 좌표(https://github.com/TeamPiKi/core)로 갱신
- telemetry 값이 있는 application.yml(main·test)은 다른 세션이 rename 작업 중인 핫존이라 스킵
- 이 repo 를 가리키는 단독 'Extractor' 표기(PIKI 접두 없음)는 이번 정리 대상이 아니라 그대로 둠
- 기능 변경 없음, 산문만 수정
---
 .github/workflows/ci.yml                      |  2 +-
 CLAUDE.md                                     | 20 +++++++-------
 README.md                                     |  6 ++---
 build.gradle.kts                              | 10 +++----
 docs/api-contract.md                          | 26 +++++++++----------
 .../extractor/api/ExtractionController.java   |  2 +-
 .../extractor/api/ExtractionResponse.java     |  2 +-
 .../common/exception/ExtractionErrorCode.java |  2 +-
 .../common/storage/ImageStorage.java          |  2 +-
 .../common/storage/ImageStorageException.java |  2 +-
 .../common/storage/S3ImageStorage.java        |  2 +-
 .../piki/extractor/domain/ProductLink.java    |  2 +-
 .../extractor/domain/ProductSnapshot.java     |  2 +-
 .../FallbackProductLinkExtractor.java         |  2 +-
 .../HeadlessExtractionProperties.java         |  4 +--
 .../HeadlessProductLinkExtractor.java         |  2 +-
 .../extraction/ProductLinkExtractor.java      |  2 +-
 .../extraction/gemini/GeminiProperties.java   |  2 +-
 .../extraction/headless/HeadlessRenderer.java |  2 +-
 .../headless/HttpHeadlessRenderer.java        |  2 +-
 .../image/ImageExtractionService.java         |  2 +-
 .../image/domain/ProductImageException.java   |  2 +-
 .../api/ExtractionImageIntegrationTest.java   |  2 +-
 .../api/ExtractionLinkIntegrationTest.java    |  2 +-
 .../extractor/domain/ProductLinkTest.java     |  2 +-
 .../FallbackProductLinkExtractorTest.java     |  4 +--
 .../extractor/support/TestConventionTest.java |  2 +-
 27 files changed, 56 insertions(+), 56 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 98f68b5..45a943d 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -1,4 +1,4 @@
-# PIKI-Server 의 ci.yml 과 같은 구조를 따르되, 이 서비스는 DB 가 없어 Testcontainers/Docker 없이 test 까지 그냥 돈다.
+# core 의 ci.yml 과 같은 구조를 따르되, 이 서비스는 DB 가 없어 Testcontainers/Docker 없이 test 까지 그냥 돈다.
 name: CI
 
 on:
diff --git a/CLAUDE.md b/CLAUDE.md
index bc303d6..eb91bbe 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,13 +1,13 @@
-# PIKI-Extractor 프로젝트 컨벤션
+# extractor 프로젝트 컨벤션
 
 ## 이 서비스의 정체
 
-PIKI-Server(코틀린)에서 분리된 **상품 추출 서비스**다. 상품 URL(또는 S3 이미지)을 받아 fetch → 구조화 파싱(JSON-LD/OG) → LLM(Gemini) fallback → 정규화를 거쳐 추출 결과를 돌려준다.
+core(코틀린)에서 분리된 **상품 추출 서비스**다. 상품 URL(또는 S3 이미지)을 받아 fetch → 구조화 파싱(JSON-LD/OG) → LLM(Gemini) fallback → 정규화를 거쳐 추출 결과를 돌려준다.
 
-- **무상태.** DB 없음, 호출 간 상태 없음. 상태를 넣고 싶어지면 설계 경고 신호다. 재시도·내구성·상태 전이는 전부 호출자(PIKI-Server outbox)의 몫이다.
-- **소비자는 PIKI-Server 워커 하나뿐.** 공개 API 가 아니다. 보안그룹 내부망 전용, 인증 없음.
+- **무상태.** DB 없음, 호출 간 상태 없음. 상태를 넣고 싶어지면 설계 경고 신호다. 재시도·내구성·상태 전이는 전부 호출자(core outbox)의 몫이다.
+- **소비자는 core 워커 하나뿐.** 공개 API 가 아니다. 보안그룹 내부망 전용, 인증 없음.
 - **계약의 single source 는 `docs/api-contract.md`.** 응답은 3갈래뿐이다: 2xx(성공) / 422+code(확정 실패) / 그 외 전부(일시 실패). 진화는 additive-only, 배포는 Extractor 먼저.
-- 차단 우회 **방법론**(스텔스·프록시·IP 전략)은 private repo(PIKI-HeadlessBrowser)에만 둔다. 이 repo(public)에는 "이 호스트는 헤드리스로 라우팅" 수준까지만 담는다.
+- 차단 우회 **방법론**(스텔스·프록시·IP 전략)은 private repo(renderer)에만 둔다. 이 repo(public)에는 "이 호스트는 헤드리스로 라우팅" 수준까지만 담는다.
 
 ## 언어: Java 25
 
@@ -16,7 +16,7 @@ PIKI-Server(코틀린)에서 분리된 **상품 추출 서비스**다. 상품 UR
 
 ### Null 처리
 
-PIKI-Server 의 Elvis 규칙에 대응하는 Java 규칙:
+core 의 Elvis 규칙에 대응하는 Java 규칙:
 
 - 파라미터·필드의 non-null 강제는 `Objects.requireNonNull(x, "메시지")`.
 - "없을 수 있음"을 반환할 땐 `Optional<T>` 또는 도메인 결과 타입(sealed). **null 반환 금지.**
@@ -28,7 +28,7 @@ PIKI-Server 의 Elvis 규칙에 대응하는 Java 규칙:
 
 ## 예외 정책
 
-판단 기준 한 줄은 PIKI-Server 와 같다: **"정상 호출로 여기 닿을 수 있나?"** 단, 이 서비스의 클라이언트는 PIKI-Server 워커다.
+판단 기준 한 줄은 core 와 같다: **"정상 호출로 여기 닿을 수 있나?"** 단, 이 서비스의 클라이언트는 core 워커다.
 
 - 닿는다 → **계약** → `ExtractionException`(커스텀, code + 일시/확정 구분 내장) → 핸들러가 422 또는 502 로 매핑.
 - 못 닿는다 → **불변식** → `IllegalStateException`/`IllegalArgumentException` → 일반 500. 호출자는 이를 "일시 실패"로 보고 bounded 재시도하므로 안전하다.
@@ -45,12 +45,12 @@ PIKI-Server 의 Elvis 규칙에 대응하는 Java 규칙:
 ## 포팅 규율 (이관 기간 한정)
 
 - **동작 등가(파리티)가 목표다.** Kotlin 원본의 분기·상수·메시지를 그대로 옮기고, 개선·리팩터링은 이관 완료 후 별도 작업으로 뺀다.
-- 포팅한 클래스 상단 주석에 원본 경로를 남긴다: `// PIKI-Server: product/service/http/HttpPageFetcher.kt 포팅`.
+- 포팅한 클래스 상단 주석에 원본 경로를 남긴다: `// core: product/service/http/HttpPageFetcher.kt 포팅`.
 - 하드코딩이던 상수(fetch 3MB cap·UA·타임아웃·LLM 200K char cap)는 `@ConfigurationProperties` 로 외부화하되 **기본값은 원본과 동일**하게 둔다.
 
 ## 테스트
 
-PIKI-Server 테스트 컨벤션의 Java 번역판. 원문 규약이 더 자세하다 (PIKI-Server `.claude/rules/testing-convention.md`).
+core 테스트 컨벤션의 Java 번역판. 원문 규약이 더 자세하다 (core `.claude/rules/testing-convention.md`).
 
 - **분류**: 단위(Spring 없이 분기 망라) / 통합(HTTP 진입 계약 검증, 외부는 stub) / E2E(실제 몰·Gemini 호출, env 격리). **DB 가 없으므로 Testcontainers·Docker 불필요** — `./gradlew test` 가 그냥 돈다.
 - **모킹 금지, stub 우선.** Mockito/`@MockBean` 금지. 외부 경계(GeminiClient·PageFetcher·S3)는 `IntegrationStubs` 한 곳에 `@Primary` stub 빈으로 등록, default 람다는 throw.
@@ -64,7 +64,7 @@ PIKI-Server 테스트 컨벤션의 Java 번역판. 원문 규약이 더 자세
 
 - 버전의 single source 는 `build.gradle.kts`. 문서에 버전 숫자를 박지 않는다.
 - 새 의존성은 Maven Central 최신 안정 버전(pre-release 제외), Spring Boot BOM 관리 대상은 버전 명시 금지.
-- PIKI-Server 와 공유하는 라인(jsoup·guava·AWS SDK·springdoc)은 그쪽과 버전을 맞춘다.
+- core 와 공유하는 라인(jsoup·guava·AWS SDK·springdoc)은 그쪽과 버전을 맞춘다.
 
 ## 브랜치·PR
 
diff --git a/README.md b/README.md
index b95f6f5..f75dadd 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,10 @@
-# PIKI-Extractor
+# extractor
 
-PIKI 의 상품 추출 서비스. 상품 URL(또는 S3 이미지)을 받아 fetch → 구조화 파싱(JSON-LD/OpenGraph) → LLM(Gemini) fallback → 정규화를 거쳐 추출 결과를 반환한다. PIKI-Server 의 파싱 파이프라인을 분리한 것으로, 소비자는 PIKI-Server 의 outbox 워커 하나뿐인 내부 서비스다.
+PIKI 의 상품 추출 서비스. 상품 URL(또는 S3 이미지)을 받아 fetch → 구조화 파싱(JSON-LD/OpenGraph) → LLM(Gemini) fallback → 정규화를 거쳐 추출 결과를 반환한다. core 의 파싱 파이프라인을 분리한 것으로, 소비자는 core 의 outbox 워커 하나뿐인 내부 서비스다.
 
 - **API 계약**: [docs/api-contract.md](docs/api-contract.md) — 응답 3갈래(2xx / 422 / 그 외=재시도), additive-only 진화
 - **스택**: Java 25 · Spring Boot 4 · virtual threads · 무상태(DB 없음)
-- **관련 repo**: [PIKI-Server](https://github.com/depromeet/PIKI-Server) (호출자), PIKI-HeadlessBrowser (차단 우회 렌더링, private)
+- **관련 repo**: [core](https://github.com/TeamPiKi/core) (호출자), renderer (차단 우회 렌더링, private)
 
 ## 실행
 
diff --git a/build.gradle.kts b/build.gradle.kts
index c0ca2e3..9b6e1e0 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -17,7 +17,7 @@ repositories {
     mavenCentral()
 }
 
-// 이미지(OCR) 경로의 S3 raw 읽기·크롭 업로드용. 버전 라인은 PIKI-Server 와 동일하게 유지한다.
+// 이미지(OCR) 경로의 S3 raw 읽기·크롭 업로드용. 버전 라인은 core 와 동일하게 유지한다.
 val awsSdkVersion = "2.44.11"
 
 dependencyManagement {
@@ -31,15 +31,15 @@ dependencies {
     implementation("org.springframework.boot:spring-boot-starter-validation")
 
     // OpenAPI 문서 노출(/v3/api-docs, UI 없음). 계약의 원문은 docs/api-contract.md.
-    // Spring Boot 4 / Jackson 3 호환 라인 — PIKI-Server 와 동일.
+    // Spring Boot 4 / Jackson 3 호환 라인 — core 와 동일.
     implementation("org.springdoc:springdoc-openapi-starter-webmvc-api:3.0.3")
 
     // 상품 페이지 HTML 에서 구조화 데이터(JSON-LD <script>·OpenGraph <meta>)를 파싱한다.
-    // PIKI-Server product 파이프라인 포팅 대상(그쪽 #425). Spring Boot BOM 미관리라 버전 명시.
+    // core product 파이프라인 포팅 대상(그쪽 #425). Spring Boot BOM 미관리라 버전 명시.
     implementation("org.jsoup:jsoup:1.22.2")
 
     // redirect 추적 시 "같은 회사 도메인(eTLD+1)" 판정에 guava InternetDomainName(Public Suffix List)을 쓴다.
-    // 점 개수 어림은 a.co.kr↔b.co.kr 을 같은 회사로 오판해 SSRF 구멍 (PIKI-Server #440 과 동일 근거).
+    // 점 개수 어림은 a.co.kr↔b.co.kr 을 같은 회사로 오판해 SSRF 구멍 (core #440 과 동일 근거).
     implementation("com.google.guava:guava:33.6.0-jre")
 
     // SSRF IP-pin: 가드가 검증한 IP 로만 연결하도록 DnsResolver 를 끼울 수 있는 HTTP 클라이언트.
@@ -50,7 +50,7 @@ dependencies {
     implementation("software.amazon.awssdk:s3")
 
     // 관측: /actuator/health(상태)·/actuator/prometheus(Alloy scrape) + OTLP tracing.
-    // 구성 근거(왜 OTel 3종인지)는 PIKI-Server build.gradle.kts 의 동일 블록 주석 참고.
+    // 구성 근거(왜 OTel 3종인지)는 core build.gradle.kts 의 동일 블록 주석 참고.
     implementation("org.springframework.boot:spring-boot-starter-actuator")
     implementation("io.micrometer:micrometer-registry-prometheus")
     implementation("org.springframework.boot:spring-boot-micrometer-tracing-opentelemetry")
diff --git a/docs/api-contract.md b/docs/api-contract.md
index a5169da..622be4a 100644
--- a/docs/api-contract.md
+++ b/docs/api-contract.md
@@ -1,18 +1,18 @@
-# PIKI-Extractor API 계약
+# extractor API 계약
 
 이 문서가 계약의 single source 다. 구현(springdoc `/v3/api-docs`)과 어긋나면 이 문서를 기준으로 구현을 고친다.
 
-소비자는 PIKI-Server 의 outbox 워커 하나뿐이다. 공개 API 가 아니며, 보안그룹으로 내부망에서만 접근한다(별도 인증 없음).
+소비자는 core 의 outbox 워커 하나뿐이다. 공개 API 가 아니며, 보안그룹으로 내부망에서만 접근한다(별도 인증 없음).
 
 ## 0. 설계 불변식
 
 - Extractor 는 **무상태**다. DB 없음, 호출 간 상태 없음. 같은 요청이 중복 도착해도 상태 오염이 없다(중복의 대가는 LLM 비용 한 번뿐). Extractor 에 상태를 넣고 싶어지면 설계 경고 신호다.
-- 재시도·내구성·상태 전이는 전부 호출자(PIKI-Server 의 item_snapshots outbox)의 책임이다. Extractor 는 "단건 시도 1회"에만 답한다.
+- 재시도·내구성·상태 전이는 전부 호출자(core 의 item_snapshots outbox)의 책임이다. Extractor 는 "단건 시도 1회"에만 답한다.
 - 에스컬레이션(plain fetch → headless 브라우저)은 Extractor 내부 관심사다. 응답 계약에 드러나지 않는다 — 호출자는 어떤 fetch 전략이 쓰였는지 모른다. 단 "어느 플랫폼을 처음부터 헤드리스로 보낼지"의 **정책**은 호출자(DB·백오피스)가 주인이라, 요청 필드 `headlessFirst` 로 힌트만 받는다(§2) — 무상태 불변식을 지키는 선에서의 유일한 정책 수용 지점이다.
 
 ## 1. 응답 3갈래 (전이 규약)
 
-| Extractor 응답 | 의미 | PIKI-Server 전이 |
+| Extractor 응답 | 의미 | core 전이 |
 |---|---|---|
 | 2xx + 추출 결과 | 성공 | `markReady` |
 | 422 + `{code}` | 확정 실패 (재시도 무의미) | 즉시 `markFailed` |
@@ -31,7 +31,7 @@
 { "url": "https://www.musinsa.com/products/12345", "headlessFirst": false }
 ```
 
-- `url` (필수): https 스킴의 상품 페이지 URL. 형식·스킴·미지원 플랫폼의 동기 검증은 호출자(PIKI-Server 등록 경계)가 이미 끝냈다는 전제이나, Extractor 도 자기 경계에서 방어 검증한다(다층 방어).
+- `url` (필수): https 스킴의 상품 페이지 URL. 형식·스킴·미지원 플랫폼의 동기 검증은 호출자(core 등록 경계)가 이미 끝냈다는 전제이나, Extractor 도 자기 경계에서 방어 검증한다(다층 방어).
 - `headlessFirst` (선택, 기본 false — additive, 이관 7단계): 호출자의 플랫폼 라우팅 정책(`HEADLESS_FIRST`, DB·백오피스 동적 설정) 힌트. true 면 plain(정적 fetch)을 건너뛰고 처음부터 헤드리스 브라우저로 추출한다. 정책의 단일 진실은 호출자 DB 에 있고 무상태인 Extractor 는 요청 단위로만 받는다. Extractor 의 `product.extract.headless.enabled` 가 꺼져 있으면 무시된다(스위치가 힌트보다 우선).
 - 헤더 `X-Correlation-Id` (선택): 호출자의 item_snapshot id. 로그·trace 상관용이며 동작에 영향 없다.
 
@@ -41,7 +41,7 @@
 { "name": "나이키 에어포스", "imageUrl": "https://...", "currentPrice": 99000, "currency": "KRW" }
 ```
 
-- **`name`(non-blank)·`imageUrl`·`currentPrice` 의 non-null 을 Extractor 가 보장한다** — PIKI-Server 의 READY 불변식(`requireReadyInvariant`: name·price·imageUrl·extractedAt, extractedAt 은 호출자가 전이 시점에 채움)과 동일 조건이다. 보장할 수 없으면 성공이 아니라 422(`UNTRUSTWORTHY_VALUE`)다. `currency` 는 READY 필수가 아니라 **nullable** 이다. 호출자의 엔티티 불변식은 최후 보루로 유지된다.
+- **`name`(non-blank)·`imageUrl`·`currentPrice` 의 non-null 을 Extractor 가 보장한다** — core 의 READY 불변식(`requireReadyInvariant`: name·price·imageUrl·extractedAt, extractedAt 은 호출자가 전이 시점에 채움)과 동일 조건이다. 보장할 수 없으면 성공이 아니라 422(`UNTRUSTWORTHY_VALUE`)다. `currency` 는 READY 필수가 아니라 **nullable** 이다. 호출자의 엔티티 불변식은 최후 보루로 유지된다.
 
 확정 실패 422:
 
@@ -49,7 +49,7 @@
 { "code": "NOT_PRODUCT_PAGE" }
 ```
 
-| code | PIKI-Server 기준 동등물 |
+| code | core 기준 동등물 |
 |---|---|
 | `NOT_PRODUCT_PAGE` | `ProductSnapshotException.notProductPage` — 상품 페이지가 아님 |
 | `UNTRUSTWORTHY_VALUE` | `ProductSnapshotException.untrustworthyValue` — 추출값이 범위·상식 위반 |
@@ -96,25 +96,25 @@
 
 | 층 | 값 | 근거 |
 |---|---|---|
-| PIKI-Server stale 판정 | 60s | `ItemParsingScheduler.STALE_TIMEOUT` (기존 값) |
-| PIKI-Server → Extractor HTTP read | 55s (connect 2s) | stale 미만 — recover 의 유령 중복 발주 방지. link·image 공용 |
+| core stale 판정 | 60s | `ItemParsingScheduler.STALE_TIMEOUT` (기존 값) |
+| core → Extractor HTTP read | 55s (connect 2s) | stale 미만 — recover 의 유령 중복 발주 방지. link·image 공용 |
 | Extractor 내부 합계 (link) | 약 50s | 아래 합 + 여유 |
 | 대상 몰 fetch (link) | connect 5s / read 15s | 현행 유지 |
 | 헤드리스 render (link, 7단계) | connect 2s / read 20s | 실측 전형 1.6~5.5s(kream 프록시 포함) 대비 약 4배 여유. headless-first 최악(connect 2 + render 20 + LLM 30 = 약 52s)이 호출자 read 55s 안에 들도록 상한 |
 | Gemini | read 30s | 현행 유지 (link LLM fallback·image OCR 동일) |
 | Extractor 내부 합계 (image) | 약 40s | S3 download + Gemini OCR 30s + crop + 결과 upload. S3 는 동일 리전이라 수 초 |
 
-**안쪽 예산은 항상 바깥보다 작아야 한다.** link 와 image 가 호출자 read 55s 를 공유하므로, 어느 경로든 Extractor 내부 값을 늘릴 땐 이 표를 갱신하고 PIKI-Server 쪽 read 타임아웃과 함께 재검증한다.
+**안쪽 예산은 항상 바깥보다 작아야 한다.** link 와 image 가 호출자 read 55s 를 공유하므로, 어느 경로든 Extractor 내부 값을 늘릴 땐 이 표를 갱신하고 core 쪽 read 타임아웃과 함께 재검증한다.
 
 예외적으로 **에스컬레이션 경로(plain 실패 → headless)의 최악 스택**은 호출자 read 55s 를 넘을 수 있다. plain fetch 는 수동 redirect 추적(hop 상한 3 = 요청 최대 4회)마다 connect/read 타임아웃이 **새로 적용**되므로 fetch 단독의 이론 최악이 이미 약 88s 다(이 특성은 headless 이전부터 존재). 여기에 render 22s + LLM 30s 가 얹히면 이론 최악 약 140s — 단, 각 단이 전부 타임아웃까지 끄는 경우는 실측상 없다시피 하고(차단은 대개 즉시 4xx/5xx 로 떨어져 fetch 가 빨리 실패한다), 넘치면 호출자는 read 타임아웃 → 일시 실패로 처리해 recover 가 재시도한다. 그 사이 Extractor 가 계속 돌아 중복 발주가 겹쳐도 Extractor 는 무상태라 안전하고(§0 — 중복의 대가는 LLM 비용 한 번), attempt 상한 2 가 총비용을 바운드한다. 이 스택을 55s 안에 구겨 넣으려면 render 예산이 실측 대비 무의미하게 얇아져(5s 이하) recall 을 잃는다 — 의도된 트레이드오프다.
 
 ## 4. 진화 규칙
 
 - **additive-only**: 응답 필드 추가·422 code 추가는 자유. 필드 제거·의미 변경·타입 변경은 금지 — 필요하면 새 경로로 분리한다.
-- **배포 순서: Extractor 먼저, 소비자(PIKI-Server) 나중.** 본 서버 staging 이 extractor-prod 를 기본으로 바라보는 구성이 이 순서 위반을 릴리스 전에 잡는다.
+- **배포 순서: Extractor 먼저, 소비자(core) 나중.** 본 서버 staging 이 extractor-prod 를 기본으로 바라보는 구성이 이 순서 위반을 릴리스 전에 잡는다.
 - 호출자는 tolerant reader — 모르는 응답 필드·code 를 무시한다.
 
 ## 5. 관측
 
-- W3C `traceparent` 헤더를 수용해 PIKI-Server 의 `item.parse` span 아래로 연결된다(micrometer tracing 기본 동작).
-- 메트릭 `product.extract{via,reason}`·`product.extract.escalation{outcome,category}` 은 PIKI-Server 에서 이 서비스로 이동한다. `application=piki-extractor` 라벨로 본 서버 시계열과 구분된다.
+- W3C `traceparent` 헤더를 수용해 core 의 `item.parse` span 아래로 연결된다(micrometer tracing 기본 동작).
+- 메트릭 `product.extract{via,reason}`·`product.extract.escalation{outcome,category}` 은 core 에서 이 서비스로 이동한다. `application=piki-extractor` 라벨로 본 서버 시계열과 구분된다.
diff --git a/src/main/java/com/depromeet/piki/extractor/api/ExtractionController.java b/src/main/java/com/depromeet/piki/extractor/api/ExtractionController.java
index b1c0e0b..80e1f32 100644
--- a/src/main/java/com/depromeet/piki/extractor/api/ExtractionController.java
+++ b/src/main/java/com/depromeet/piki/extractor/api/ExtractionController.java
@@ -12,7 +12,7 @@
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
-// 내부 추출 API (docs/api-contract.md). 소비자는 PIKI-Server outbox 워커 하나뿐이고 보안그룹으로 격리되므로
+// 내부 추출 API (docs/api-contract.md). 소비자는 core outbox 워커 하나뿐이고 보안그룹으로 격리되므로
 // 인증·응답 래퍼 없이 계약 그대로 노출한다. 두 경로(link·image)가 같은 응답 모양(ExtractionResponse)을 공유한다.
 @RestController
 @RequestMapping("/internal/extractions")
diff --git a/src/main/java/com/depromeet/piki/extractor/api/ExtractionResponse.java b/src/main/java/com/depromeet/piki/extractor/api/ExtractionResponse.java
index b69f4b4..c372b56 100644
--- a/src/main/java/com/depromeet/piki/extractor/api/ExtractionResponse.java
+++ b/src/main/java/com/depromeet/piki/extractor/api/ExtractionResponse.java
@@ -5,7 +5,7 @@
 
 // 성공(200) 응답. link·image 두 엔드포인트가 같은 모양을 공유한다(둘 다 ProductSnapshot 을 내려보낸다).
 // 계약(docs/api-contract.md): name(non-blank)·currentPrice·imageUrl 의 non-null 을 이 서비스가 보장한다 —
-// 호출자(PIKI-Server)의 READY 불변식(name·price·imageUrl·extractedAt, extractedAt 은 호출자가 전이 시점에 채움)과
+// 호출자(core)의 READY 불변식(name·price·imageUrl·extractedAt, extractedAt 은 호출자가 전이 시점에 채움)과
 // 동일 조건이며, 보장 못 하면 성공이 아니라 422(UNTRUSTWORTHY_VALUE)다. currency 는 READY 필수가 아니라 nullable.
 public record ExtractionResponse(
     String name,
diff --git a/src/main/java/com/depromeet/piki/extractor/common/exception/ExtractionErrorCode.java b/src/main/java/com/depromeet/piki/extractor/common/exception/ExtractionErrorCode.java
index 834d850..c53a398 100644
--- a/src/main/java/com/depromeet/piki/extractor/common/exception/ExtractionErrorCode.java
+++ b/src/main/java/com/depromeet/piki/extractor/common/exception/ExtractionErrorCode.java
@@ -1,7 +1,7 @@
 package com.depromeet.piki.extractor.common.exception;
 
 // 422 응답 body 의 code. docs/api-contract.md 의 code 표와 1:1 이어야 한다 — 추가는 자유(additive), 제거·의미 변경 금지.
-// 호출자(PIKI-Server)는 이 값을 전이 판정에 쓰지 않고(status 만 사용) 관측·디버깅에만 쓴다.
+// 호출자(core)는 이 값을 전이 판정에 쓰지 않고(status 만 사용) 관측·디버깅에만 쓴다.
 public enum ExtractionErrorCode {
     NOT_PRODUCT_PAGE,
     UNTRUSTWORTHY_VALUE,
diff --git a/src/main/java/com/depromeet/piki/extractor/common/storage/ImageStorage.java b/src/main/java/com/depromeet/piki/extractor/common/storage/ImageStorage.java
index 6ec1baa..32748e4 100644
--- a/src/main/java/com/depromeet/piki/extractor/common/storage/ImageStorage.java
+++ b/src/main/java/com/depromeet/piki/extractor/common/storage/ImageStorage.java
@@ -3,7 +3,7 @@
 // 이미지(OCR) 경로가 쓰는 두 연산:
 //   upload   — 크롭 결과를 저장하고 공개 URL 을 돌려준다.
 //   download — outbox 재실행 시점에 등록 워커가 적재한 raw 원본을 다시 읽는다.
-// presign·exists·delete·deleteByPrefix 는 등록 수명주기(발급·확인·회수·탈퇴 파기)라 PIKI-Server 소관이다.
+// presign·exists·delete·deleteByPrefix 는 등록 수명주기(발급·확인·회수·탈퇴 파기)라 core 소관이다.
 public interface ImageStorage {
 
     // 이미지 바이트를 저장소(S3)에 올리고 공개 접근 URL 을 돌려준다.
diff --git a/src/main/java/com/depromeet/piki/extractor/common/storage/ImageStorageException.java b/src/main/java/com/depromeet/piki/extractor/common/storage/ImageStorageException.java
index 99dc25a..4354f87 100644
--- a/src/main/java/com/depromeet/piki/extractor/common/storage/ImageStorageException.java
+++ b/src/main/java/com/depromeet/piki/extractor/common/storage/ImageStorageException.java
@@ -4,7 +4,7 @@
 import com.depromeet.piki.extractor.common.exception.ExtractionException;
 
 // 스토리지(S3) 실패의 계약 예외 — permanent=false(일시 실패, 502).
-// 호출자(PIKI-Server 워커)가 PROCESSING 유지 후 recover 재시도한다.
+// 호출자(core 워커)가 PROCESSING 유지 후 recover 재시도한다.
 // message 는 로그·디버깅용 고정 문구이고 응답 body 에는 code 만 나간다(내부 정보 비노출).
 // code 는 스토리지 실패 전용 STORAGE_ERROR (docs/api-contract.md 의 code 표에 함께 있다).
 public final class ImageStorageException extends ExtractionException {
diff --git a/src/main/java/com/depromeet/piki/extractor/common/storage/S3ImageStorage.java b/src/main/java/com/depromeet/piki/extractor/common/storage/S3ImageStorage.java
index 28bcb88..59a55c4 100644
--- a/src/main/java/com/depromeet/piki/extractor/common/storage/S3ImageStorage.java
+++ b/src/main/java/com/depromeet/piki/extractor/common/storage/S3ImageStorage.java
@@ -13,7 +13,7 @@
 import software.amazon.awssdk.services.s3.model.PutObjectRequest;
 
 // AWS SDK 예외(네트워크·권한·객체 없음·timeout)를 계약 예외 ImageStorageException(일시 502)으로 변환한다.
-// presign·exists·delete·deleteByPrefix 는 등록 수명주기라 PIKI-Server 소관이다.
+// presign·exists·delete·deleteByPrefix 는 등록 수명주기라 core 소관이다.
 @Component
 public class S3ImageStorage implements ImageStorage {
 
diff --git a/src/main/java/com/depromeet/piki/extractor/domain/ProductLink.java b/src/main/java/com/depromeet/piki/extractor/domain/ProductLink.java
index b66ec37..191b7c6 100644
--- a/src/main/java/com/depromeet/piki/extractor/domain/ProductLink.java
+++ b/src/main/java/com/depromeet/piki/extractor/domain/ProductLink.java
@@ -5,7 +5,7 @@
 import java.util.Objects;
 import java.util.Set;
 
-// 미지원 플랫폼 판정은 등록 입력 경계의 정책이라 호출자(PIKI-Server) 소관이다 —
+// 미지원 플랫폼 판정은 등록 입력 경계의 정책이라 호출자(core) 소관이다 —
 // 이 서비스의 ProductLink 는 형식 불변식(https·URI 형식)과 안전 로깅만 책임진다.
 public final class ProductLink {
 
diff --git a/src/main/java/com/depromeet/piki/extractor/domain/ProductSnapshot.java b/src/main/java/com/depromeet/piki/extractor/domain/ProductSnapshot.java
index 10c1818..8932fea 100644
--- a/src/main/java/com/depromeet/piki/extractor/domain/ProductSnapshot.java
+++ b/src/main/java/com/depromeet/piki/extractor/domain/ProductSnapshot.java
@@ -10,7 +10,7 @@ public record ProductSnapshot(
     String currency
 ) {
 
-    // 컬럼 길이 제약은 호출자(PIKI-Server items 테이블)의 계약이다. 값이 바뀌면 양쪽을 함께 갱신한다.
+    // 컬럼 길이 제약은 호출자(core items 테이블)의 계약이다. 값이 바뀌면 양쪽을 함께 갱신한다.
     private static final int NAME_MAX_LENGTH = 512;
     private static final int IMAGE_URL_MAX_LENGTH = 2048;
 
diff --git a/src/main/java/com/depromeet/piki/extractor/extraction/FallbackProductLinkExtractor.java b/src/main/java/com/depromeet/piki/extractor/extraction/FallbackProductLinkExtractor.java
index cb2f2a0..d7a1fab 100644
--- a/src/main/java/com/depromeet/piki/extractor/extraction/FallbackProductLinkExtractor.java
+++ b/src/main/java/com/depromeet/piki/extractor/extraction/FallbackProductLinkExtractor.java
@@ -58,7 +58,7 @@ public ProductSnapshot extract(ProductLink link, boolean headlessFirst) {
             return plain.extract(link);
         }
 
-        // 호출자(PIKI-Server)의 브라우저 직행 정책(DB, 백오피스에서 배포 없이 변경) — plain 이 항상 차단되는 host 의
+        // 호출자(core)의 브라우저 직행 정책(DB, 백오피스에서 배포 없이 변경) — plain 이 항상 차단되는 host 의
         // 느린-실패(fetch 타임아웃 후 에스컬레이트) 낭비를 없앤다. 직행 실패는 plain 으로 되돌리지 않고 그대로 전파한다
         // (재시도는 호출자 outbox recover 축이, 정책 오지정은 백오피스 롤백이 진다). 차단 해제 감시용 canary(소량 plain)는
         // 헤드리스 운영 메트릭이 쌓인 뒤 붙인다.
diff --git a/src/main/java/com/depromeet/piki/extractor/extraction/HeadlessExtractionProperties.java b/src/main/java/com/depromeet/piki/extractor/extraction/HeadlessExtractionProperties.java
index b836a76..f9e03a5 100644
--- a/src/main/java/com/depromeet/piki/extractor/extraction/HeadlessExtractionProperties.java
+++ b/src/main/java/com/depromeet/piki/extractor/extraction/HeadlessExtractionProperties.java
@@ -6,11 +6,11 @@
 import org.springframework.boot.context.properties.ConfigurationProperties;
 import org.springframework.boot.context.properties.bind.DefaultValue;
 
-// 헤드리스(차단 우회) 추출 설정 — PIKI-HeadlessBrowser 의 POST /render 호출 파라미터.
+// 헤드리스(차단 우회) 추출 설정 — renderer 의 POST /render 호출 파라미터.
 // 운영 주입은 relaxed binding 환경변수: PRODUCT_EXTRACT_HEADLESS_ENABLED · PRODUCT_EXTRACT_HEADLESS_BASE_URL.
 //
 //   readTimeout — 실측(kream 프록시 5.5s·oliveyoung 1.6s·ably 1.9s) 대비 약 4배 여유. 렌더 서비스 내부
-//                 최악(goto 40s + 가격 대기 8s)을 다 기다리지 않는 이유: 호출자(PIKI-Server) read 55s 예산 안에서
+//                 최악(goto 40s + 가격 대기 8s)을 다 기다리지 않는 이유: 호출자(core) read 55s 예산 안에서
 //                 LLM fallback(30s) 몫을 남겨야 한다(docs/api-contract.md §3). 상한 초과 렌더는 일시 실패로
 //                 떨어져 outbox recover 가 재시도한다.
 //   maxHtmlChars — 렌더된 DOM 보관·파싱 비용의 안전 상한 (정적 fetch 의 FetchProperties.maxFetchChars 와 같은 값).
diff --git a/src/main/java/com/depromeet/piki/extractor/extraction/HeadlessProductLinkExtractor.java b/src/main/java/com/depromeet/piki/extractor/extraction/HeadlessProductLinkExtractor.java
index 33d619c..c053858 100644
--- a/src/main/java/com/depromeet/piki/extractor/extraction/HeadlessProductLinkExtractor.java
+++ b/src/main/java/com/depromeet/piki/extractor/extraction/HeadlessProductLinkExtractor.java
@@ -6,7 +6,7 @@
 import org.springframework.stereotype.Component;
 
 // 차단 우회 헤드리스 추출 "전략". 정적 HTTP fetch 가 봇 차단에 막히는 플랫폼을, 실제 브라우저를 띄우는 별도
-// 서비스(PIKI-HeadlessBrowser 의 POST /render)로 뚫는 경로다. 렌더된 HTML 을 받아 정적 fetch 와 동일한
+// 서비스(renderer 의 POST /render)로 뚫는 경로다. 렌더된 HTML 을 받아 정적 fetch 와 동일한
 // 파이프라인(구조화 → LLM fallback)에 흘려넣으므로, READY 불변식(name·price·imageUrl 보장)도 같은 검증이 진다.
 // 차단·빈 렌더·렌더 서비스 오류의 계약 번역(422/502)은 HeadlessRenderer 구현이 책임진다.
 @Component(LinkExtractionStrategy.HEADLESS)
diff --git a/src/main/java/com/depromeet/piki/extractor/extraction/ProductLinkExtractor.java b/src/main/java/com/depromeet/piki/extractor/extraction/ProductLinkExtractor.java
index 566842d..0d34dc3 100644
--- a/src/main/java/com/depromeet/piki/extractor/extraction/ProductLinkExtractor.java
+++ b/src/main/java/com/depromeet/piki/extractor/extraction/ProductLinkExtractor.java
@@ -7,7 +7,7 @@
 // API 컨트롤러는 이 인터페이스만 알고, 전략 구성(plain/headless)은 뒤에 숨는다.
 public interface ProductLinkExtractor {
 
-    // headlessFirst: 호출자(PIKI-Server)의 플랫폼 라우팅 정책(HEADLESS_FIRST) 힌트. 정책의 단일 진실은 호출자
+    // headlessFirst: 호출자(core)의 플랫폼 라우팅 정책(HEADLESS_FIRST) 힌트. 정책의 단일 진실은 호출자
     // DB(백오피스 동적 설정)에 있고, 무상태인 이 서비스는 요청 단위 힌트로만 받는다. true 면 plain(정적 fetch)을
     // 건너뛰고 처음부터 헤드리스로 추출한다 — 단 product.extract.headless.enabled 가 꺼져 있으면 무시된다.
     ProductSnapshot extract(ProductLink link, boolean headlessFirst);
diff --git a/src/main/java/com/depromeet/piki/extractor/extraction/gemini/GeminiProperties.java b/src/main/java/com/depromeet/piki/extractor/extraction/gemini/GeminiProperties.java
index 90f80b8..dc0eadf 100644
--- a/src/main/java/com/depromeet/piki/extractor/extraction/gemini/GeminiProperties.java
+++ b/src/main/java/com/depromeet/piki/extractor/extraction/gemini/GeminiProperties.java
@@ -61,7 +61,7 @@ public String toString() {
      */
     public record Retry(
         // max-attempts 는 총 시도 횟수(초기 호출 + 재시도). 기본 1 = 재시도 없음.
-        // URL 파싱 재시도를 호출자(PIKI-Server) outbox recover 로 일원화해 Gemini 내부 재시도를 끈 것이 기본값이다.
+        // URL 파싱 재시도를 호출자(core) outbox recover 로 일원화해 Gemini 내부 재시도를 끈 것이 기본값이다.
         @DefaultValue("1") int maxAttempts,
         @DefaultValue("1000") long initialDelayMs
     ) {
diff --git a/src/main/java/com/depromeet/piki/extractor/extraction/headless/HeadlessRenderer.java b/src/main/java/com/depromeet/piki/extractor/extraction/headless/HeadlessRenderer.java
index f871e26..226231a 100644
--- a/src/main/java/com/depromeet/piki/extractor/extraction/headless/HeadlessRenderer.java
+++ b/src/main/java/com/depromeet/piki/extractor/extraction/headless/HeadlessRenderer.java
@@ -3,7 +3,7 @@
 import com.depromeet.piki.extractor.domain.ProductLink;
 import com.depromeet.piki.extractor.extraction.PageContent;
 
-// 헤드리스 브라우저 렌더(PIKI-HeadlessBrowser 의 POST /render) 외부 경계 — 테스트 stub 지점 (PageFetcher 와 같은 역할).
+// 헤드리스 브라우저 렌더(renderer 의 POST /render) 외부 경계 — 테스트 stub 지점 (PageFetcher 와 같은 역할).
 // 렌더된 HTML 이 있는 페이지만 PageContent 로 반환한다. 차단(BLOCK)·빈 렌더·서비스 오류는 HeadlessRenderException
 // (일시 502)으로, SSRF 차단 host 는 PageFetchException.blockedHost(확정 422)로 번역해 던진다 —
 // 소비자(HeadlessProductLinkExtractor)는 verdict 를 모른다.
diff --git a/src/main/java/com/depromeet/piki/extractor/extraction/headless/HttpHeadlessRenderer.java b/src/main/java/com/depromeet/piki/extractor/extraction/headless/HttpHeadlessRenderer.java
index 3066df3..af45b86 100644
--- a/src/main/java/com/depromeet/piki/extractor/extraction/headless/HttpHeadlessRenderer.java
+++ b/src/main/java/com/depromeet/piki/extractor/extraction/headless/HttpHeadlessRenderer.java
@@ -15,7 +15,7 @@
 import org.springframework.web.client.RestClientException;
 import org.springframework.web.client.RestClientResponseException;
 
-// PIKI-HeadlessBrowser 의 POST /render 호출 + verdict 를 계약으로 번역하는 wire 구현.
+// renderer 의 POST /render 호출 + verdict 를 계약으로 번역하는 wire 구현.
 // 렌더 서비스는 실제 브라우저(patchright)로 페이지를 열어 최선의 HTML 을 돌려준다 — 파싱은 여기서 하지 않고
 // 렌더된 HTML 을 PageContent 로 되돌려 기존 파이프라인(구조화 → LLM)에 흘려넣는다.
 //
diff --git a/src/main/java/com/depromeet/piki/extractor/image/ImageExtractionService.java b/src/main/java/com/depromeet/piki/extractor/image/ImageExtractionService.java
index 3cef9c9..d296c0b 100644
--- a/src/main/java/com/depromeet/piki/extractor/image/ImageExtractionService.java
+++ b/src/main/java/com/depromeet/piki/extractor/image/ImageExtractionService.java
@@ -10,7 +10,7 @@
 import org.springframework.stereotype.Component;
 
 // 이미지 OCR 추출의 오케스트레이터 — S3 raw 원본을 읽고(download) OCR 추출·크롭 후 결과 이미지를 S3 에 올려(upload)
-// 그 public URL 을 담은 ProductSnapshot 을 돌려준다. 상태 전이(markReady·raw 회수)는 호출자(PIKI-Server) 소관이고,
+// 그 public URL 을 담은 ProductSnapshot 을 돌려준다. 상태 전이(markReady·raw 회수)는 호출자(core) 소관이고,
 // 이 서비스는 download→extract→crop→upload 만 책임진다. bucket 은 요청이 주므로 세 환경 버킷 모두 다룬다.
 @Component
 public class ImageExtractionService {
diff --git a/src/main/java/com/depromeet/piki/extractor/image/domain/ProductImageException.java b/src/main/java/com/depromeet/piki/extractor/image/domain/ProductImageException.java
index a98c50b..34adc5e 100644
--- a/src/main/java/com/depromeet/piki/extractor/image/domain/ProductImageException.java
+++ b/src/main/java/com/depromeet/piki/extractor/image/domain/ProductImageException.java
@@ -3,7 +3,7 @@
 import com.depromeet.piki.extractor.common.exception.ExtractionErrorCode;
 import com.depromeet.piki.extractor.common.exception.ExtractionException;
 
-// 이 서비스의 클라이언트는 PIKI-Server 워커이고,
+// 이 서비스의 클라이언트는 core 워커이고,
 // 빈 이미지·미지원 MIME 은 같은 바이트를 재시도해도 결과가 같으므로 확정 실패(permanent=true → 422)다.
 // 셋 다 code=IMAGE_UNSUPPORTED (api-contract.md 의 "422 code 추가분: IMAGE_UNSUPPORTED").
 // 세 팩토리의 서로 다른 message 는 로그·cause 용이며 응답 body 에는 code 만 나간다.
diff --git a/src/test/java/com/depromeet/piki/extractor/api/ExtractionImageIntegrationTest.java b/src/test/java/com/depromeet/piki/extractor/api/ExtractionImageIntegrationTest.java
index 4bee426..816a53d 100644
--- a/src/test/java/com/depromeet/piki/extractor/api/ExtractionImageIntegrationTest.java
+++ b/src/test/java/com/depromeet/piki/extractor/api/ExtractionImageIntegrationTest.java
@@ -71,7 +71,7 @@ void imageSuccess() throws Exception {
     void nullContentTypeRecoversFromKeyExtension() throws Exception {
         // S3 GetObject 가 content-type 메타를 안 싣는 상황 — 등록 때 호출자가 key 에 박은 확장자(.png)로 복원해야
         // 메타 결함이 IMAGE_UNSUPPORTED(비복구 확정 실패)로 새지 않는다. (이 계약은 이 레포가 유일하게 보증한다 —
-        // 호출자(PIKI-Server)엔 download 경로가 없다.)
+        // 호출자(core)엔 download 경로가 없다.)
         stubGeminiClient.reset();
         stubImageStorage.onDownload = (bucket, key) -> new StoredImage(new byte[] {1, 2, 3}, null);
         stubGeminiClient.build = request -> new GeminiImageResult("복원 상품", 12000, null, "KRW", null);
diff --git a/src/test/java/com/depromeet/piki/extractor/api/ExtractionLinkIntegrationTest.java b/src/test/java/com/depromeet/piki/extractor/api/ExtractionLinkIntegrationTest.java
index 1623c97..4ceda9c 100644
--- a/src/test/java/com/depromeet/piki/extractor/api/ExtractionLinkIntegrationTest.java
+++ b/src/test/java/com/depromeet/piki/extractor/api/ExtractionLinkIntegrationTest.java
@@ -20,7 +20,7 @@
 
 // POST /internal/extractions/link 의 HTTP 계약(docs/api-contract.md 응답 3갈래)을 실제 파이프라인
 // (Fallback→plain→구조화→LLM fallback, 외부 경계 PageFetcher·GeminiClient 만 stub)으로 검증한다.
-// 호출자(PIKI-Server)의 전이 판정이 status 만 보므로, status 와 body 모양(code·필드)이 이 테스트의 계약이다.
+// 호출자(core)의 전이 판정이 status 만 보므로, status 와 body 모양(code·필드)이 이 테스트의 계약이다.
 class ExtractionLinkIntegrationTest extends IntegrationTestSupport {
 
     private static final String STRUCTURED_HTML = """
diff --git a/src/test/java/com/depromeet/piki/extractor/domain/ProductLinkTest.java b/src/test/java/com/depromeet/piki/extractor/domain/ProductLinkTest.java
index 1c15b1d..8dd4950 100644
--- a/src/test/java/com/depromeet/piki/extractor/domain/ProductLinkTest.java
+++ b/src/test/java/com/depromeet/piki/extractor/domain/ProductLinkTest.java
@@ -8,7 +8,7 @@
 import org.junit.jupiter.api.DisplayName;
 import org.junit.jupiter.api.Test;
 
-// parse·safeLogString 분기를 망라한다. 미지원 플랫폼 판정은 등록 입력 경계 정책이라 호출자(PIKI-Server) 소관이고,
+// parse·safeLogString 분기를 망라한다. 미지원 플랫폼 판정은 등록 입력 경계 정책이라 호출자(core) 소관이고,
 // 이 서비스의 ProductLink 에는 해당 메서드가 없어 관련 케이스도 없다.
 class ProductLinkTest {
 
diff --git a/src/test/java/com/depromeet/piki/extractor/extraction/FallbackProductLinkExtractorTest.java b/src/test/java/com/depromeet/piki/extractor/extraction/FallbackProductLinkExtractorTest.java
index faf342e..85fb593 100644
--- a/src/test/java/com/depromeet/piki/extractor/extraction/FallbackProductLinkExtractorTest.java
+++ b/src/test/java/com/depromeet/piki/extractor/extraction/FallbackProductLinkExtractorTest.java
@@ -143,7 +143,7 @@ void headlessErrorIsCountedAndPropagated() {
     @Test
     @DisplayName("headless 도 실패하면 그 예외를 전파하고 escalation 을 failed 로 집계한다")
     void headlessFailureIsCountedAndPropagated() {
-        // 호출자(PIKI-Server 워커)의 재시도 판정과 맞물리는 지점이라, headless 예외가 그대로 상위로 전파돼야 한다.
+        // 호출자(core 워커)의 재시도 판정과 맞물리는 지점이라, headless 예외가 그대로 상위로 전파돼야 한다.
         // "폴백했는데도 못 가져온" 이 outcome=failed 로 집계돼, 무조건-폴백의 낭비·한계를 관측할 수 있어야 한다.
         FakeStrategy plain = new FakeStrategy(l -> {
             throw PageFetchException.clientError(new RuntimeException("403"));
@@ -200,7 +200,7 @@ void headlessFirstFailurePropagatesWithoutPlainFallback() {
     @Test
     @DisplayName("headless 가 꺼져 있으면 headlessFirst 힌트도 무시하고 plain 에 위임한다")
     void headlessFirstIgnoredWhenDisabled() {
-        // 호출자(PIKI-Server)의 라우팅 정책이 이 서비스의 스위치보다 앞설 수 없다 — 스위치가 꺼진 동안은 zero-diff.
+        // 호출자(core)의 라우팅 정책이 이 서비스의 스위치보다 앞설 수 없다 — 스위치가 꺼진 동안은 zero-diff.
         FakeStrategy plain = new FakeStrategy(l -> snapshot);
         FakeStrategy headless = new FakeStrategy(l -> {
             throw new IllegalStateException("headless 는 호출되면 안 됨");
diff --git a/src/test/java/com/depromeet/piki/extractor/support/TestConventionTest.java b/src/test/java/com/depromeet/piki/extractor/support/TestConventionTest.java
index ed27670..7153390 100644
--- a/src/test/java/com/depromeet/piki/extractor/support/TestConventionTest.java
+++ b/src/test/java/com/depromeet/piki/extractor/support/TestConventionTest.java
@@ -18,7 +18,7 @@
 /**
  * 테스트 컨벤션을 기계로 강제하는 메타 테스트.
  *
- * <p>PIKI-Extractor CLAUDE.md `## 테스트` 의 불변식 중 **오탐 없이 기계로 PASS/FAIL 을 가를 수 있는 것만**
+ * <p>extractor CLAUDE.md `## 테스트` 의 불변식 중 **오탐 없이 기계로 PASS/FAIL 을 가를 수 있는 것만**
  * 여기서 강제한다. 서비스 단독 테스트 여부·한국어 네이밍 적정성처럼 사람·모델 판단이 끼는 규칙은 산문(CLAUDE.md)에 둔다.
  *
  * <p>src/test/java 의 Java 소스를 **import 라인 기준**으로 스캔한다. import 기준이라