docs: prepare public release

Author: ikseong00

AGENTS.md

@@ -23,6 +23,23 @@
 - 화면 문구는 짧게 쓴다. 기능 설명보다 결과와 조작을 바로 보여준다.
 - 사이트명은 `리버스 맞춤법 검사기`, 화면 타이틀은 `맏춤법 검사기`를 유지한다.
 - 결과 영역에서는 바뀐 표현을 문장 안에서 직접 밑줄/하이라이트로 보여준다.
+- `제보`, `피드백`, `오류 신고`처럼 부담이 큰 말보다 사용자가 가볍게 누를 수 있는 말을 우선한다. 예: `이것도 넣어줘`, `기록해두기`.
+- 팝업 문구는 사용자가 무엇을 적으면 되는지 바로 알 수 있게 쓰고, 데이터 저장 범위는 숨기지 않는다.
+
+## SEO와 검색 노출
+
+- 대표 URL은 `https://reverse-spell-checker.vercel.app/`다. 커스텀 도메인은 별도 요청 전까지 붙이지 않는다.
+- `robots.txt`는 `sitemap.xml` 하나만 가리킨다. `sitemap.txt` 같은 대체 파일을 다시 추가하지 않는다.
+- Google 일반 웹페이지는 Indexing API 대상이 아니다. 검색 노출 관련 작업은 Search Console URL 검사, sitemap 제출, 외부 링크, 정적 HTML 본문 보강으로 처리한다.
+- SEO용 정적 본문은 `client/index.html`의 `#root` fallback 안에 둔다. React 렌더링 전에도 `맏춤법 검사기`, `리버스 맞춤법 검사기`, 주요 케이스가 읽혀야 한다.
+- 메타/구조화 데이터/README/레포 description이 서로 다른 이름을 말하지 않게 유지한다.
+
+## 맞춤법 룰 운영
+
+- 새 룰은 `RULE_UPDATE.md`와 `docs/spelling-rules.md` 기준을 따른다.
+- 룰 추가 시 `client/src/lib/reverseSpellCheck.ts`와 `client/src/lib/reverseSpellCheck.fixtures.ts`를 함께 수정한다.
+- 문맥 없이 정상 문장을 과하게 바꾸는 룰은 기본 룰로 넣지 않는다.
+- 사용자 입력 원문 저장은 별도 동의와 정책 없이는 하지 않는다. GA4에는 분류, 길이, rule id 같은 비식별 신호만 보낸다.
 
 ## UI 구현 원칙
 
@@ -42,6 +59,7 @@
 - 기존 사용자 변경을 되돌리지 않는다.
 - 새 기능보다 현재 사용자 경험을 유지하는 작은 수정이 우선이다.
 - 불필요한 리팩터링, 문서 대량 생성, 디자인 전면 교체는 요청이 있을 때만 한다.
+- 커밋/푸시는 사용자가 명시했을 때만 한다. 단, 사용자가 릴리즈/배포/푸시까지 요청한 경우에는 작업별 커밋 후 push한다.
 
 ## 검증
 

CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## v1.0.0 - 2026-05-16
+
+첫 공개 릴리즈입니다.
+
+### Product
+
+- `맏춤법 검사기` 메인 화면을 제공합니다.
+- 되/돼, 안/않, 왜/외, 며칠/몇일 등 자주 헷갈리는 한국어 표현을 문장 안에서 표시합니다.
+- 맞춤법, 띄어쓰기, 표준어, 외래어 분류를 지원합니다.
+- 결과 복사, 공유, 이미지 저장을 지원합니다.
+- 빠진 표현을 남길 수 있는 팝업을 제공합니다. 현재 GA4에는 원문 대신 분류와 길이만 기록합니다.
+
+### Operations
+
+- Vercel Git 연동 배포를 설정했습니다.
+- Google Search Console, Naver Search Advisor 검증 파일과 SEO 메타를 추가했습니다.
+- `robots.txt`와 `sitemap.xml`을 정리했습니다.
+- GA4 기본 이벤트와 룰 매칭 이벤트를 추가했습니다.
+
+### Documentation
+
+- README, AGENTS, CLAUDE, 맞춤법 룰 문서를 정리했습니다.
+- 룰 업데이트 기준과 현재 적용된 규칙 목록을 문서화했습니다.

CLAUDE.md

@@ -0,0 +1,111 @@
+# CLAUDE.md
+
+이 파일은 Claude Code와 다른 코드 에이전트가 이 저장소에서 작업할 때 참고하는 운영 메모다. 실제 우선순위는 사용자 지시, 더 가까운 `AGENTS.md`, 이 파일 순서다.
+
+## Project Snapshot
+
+- 제품: `맏춤법 검사기`
+- 성격: 올바른 한국어 문장을 자주 헷갈리는 표기로 바꿔 보여주는 리버스 맞춤법 검사기
+- 대표 URL: https://reverse-spell-checker.vercel.app/
+- 저장소: https://github.com/makersfarm/reverse-spell-checker
+- 배포: Vercel Git 연동, `main` push 시 Production 배포
+
+## Stack
+
+- React 19
+- Vite
+- TypeScript
+- Express 정적 서버
+- Vitest
+- GA4
+- pnpm
+
+## Commands
+
+```bash
+pnpm install
+pnpm dev
+pnpm check
+pnpm test
+pnpm build
+pnpm qa
+```
+
+## Important Paths
+
+- `client/src/pages/Home.tsx`: 메인 UI
+- `client/src/index.css`: 화면 스타일
+- `client/index.html`: SEO 메타, 정적 fallback 본문
+- `client/src/lib/reverseSpellCheck.ts`: 변환 룰
+- `client/src/lib/reverseSpellCheck.fixtures.ts`: 테스트 fixture
+- `client/src/lib/analytics.ts`: GA4 이벤트
+- `docs/spelling-rules.md`: 현재 적용된 맞춤법 규칙
+- `RULE_UPDATE.md`: 룰 추가 기준
+- `DEPLOYMENT.md`: 배포 운영
+
+## Product Rules
+
+- 사이트명은 `리버스 맞춤법 검사기`, 화면 타이틀은 `맏춤법 검사기`를 유지한다.
+- 사용자에게 “우리가 일부러 틀리게 만든다”는 식으로 설명하지 않는다. 화면 분위기와 예시로 이해시키는 쪽을 우선한다.
+- 결과는 문장 안에서 직접 밑줄/하이라이트로 보여준다.
+- 문장부호, 과한 띄어쓰기 장난, 사용자를 불쾌하게 만들 수 있는 변환은 넣지 않는다.
+- 새 맞춤법 룰은 테스트 fixture와 함께 추가한다.
+- 사용자 원문은 별도 동의 없이 저장하지 않는다.
+
+## UX Copy
+
+피해야 할 말:
+
+- `오염`
+- `교정 결과`
+- `재미난 검사기`
+- `일부러 틀려보기`
+- `문장을 살짝 어긋나게`
+- `맞춤법을 틀리게 만들어드립니다`
+- `역대급 오류 보장`
+- `오류 공장`
+- `맞춤법 파괴`
+- `틀린 문장 제조`
+- `의도적으로 오류`
+
+좋은 방향:
+
+- 짧게 쓴다.
+- 설명보다 조작과 결과를 먼저 보여준다.
+- 버튼은 사용자가 바로 행동할 수 있는 말로 쓴다.
+- 데이터 저장 범위는 짧고 정확하게 밝힌다.
+
+## SEO Notes
+
+- 커스텀 도메인은 아직 붙이지 않는다.
+- `robots.txt`는 `sitemap.xml` 하나만 가리킨다.
+- 일반 웹페이지는 Google Indexing API 대상이 아니다.
+- 검색 노출 개선은 Search Console URL 검사, sitemap 제출, 외부 링크, 정적 HTML 본문 보강으로 처리한다.
+- `client/index.html`의 정적 fallback 본문은 검색봇이 JS 렌더링 전에 읽는 최소 설명이므로 지우지 않는다.
+
+## Skill Routing
+
+When a request matches an available skill, use it.
+
+- UI/UX review or visual QA: `/design-review`, `/qa`, `ui-ux-pro-max`
+- Release/documentation cleanup: `/document-release`
+- Deployment: Vercel workflow or `/setup-deploy`
+- Bug investigation: `/investigate`
+- Product/positioning questions: `/office-hours`, `/plan-ceo-review`
+- Architecture planning: `/plan-eng-review`
+
+## Release Checklist
+
+Before a release:
+
+```bash
+pnpm qa
+```
+
+Then:
+
+1. Update docs if behavior changed.
+2. Commit by work unit.
+3. Push `main`.
+4. Create a GitHub release tag.
+5. Confirm Vercel production URL responds.

README.md

@@ -1,20 +1,34 @@
 # 맏춤법 검사기
 
-올바른 한국어 문장을 흔히 보이는 맞춤법/띄어쓰기 실수 형태로 바꿔 보여주는 React/Vite 앱입니다.
+올바른 한국어 문장을 사람들이 자주 헷갈리는 표기로 바꿔 보여주는 리버스 맞춤법 검사기입니다.
 
-서비스: https://reverse-spell-checker.vercel.app/
+- 서비스: https://reverse-spell-checker.vercel.app/
+- GitHub: https://github.com/makersfarm/reverse-spell-checker
 
-## 주요 기능
+## 무엇을 하나요
 
-- 되/돼, 안/않, 왜/외, 며칠/몇일처럼 자주 헷갈리는 한국어 표현을 문장 안에서 표시
-- 맞춤법, 띄어쓰기, 표준어, 외래어 분류별 결과 제공
-- 결과 복사, 공유, 이미지 저장
+- 되/돼, 안/않, 왜/외, 며칠/몇일처럼 자주 헷갈리는 표현을 문장 안에서 표시합니다.
+- 맞춤법, 띄어쓰기, 표준어, 외래어 분류별로 바뀐 표현을 보여줍니다.
+- 결과를 복사하거나 공유하고, 이미지로 저장할 수 있습니다.
+- 빠진 표현은 앱 안에서 가볍게 남길 수 있고, GA4에는 원문 대신 분류와 길이만 보냅니다.
 
-## 구성
+## 프로젝트 구조
 
-- `client/`: React 프론트엔드
-- `server/`: 프로덕션 정적 파일 서빙용 Express 서버
-- `shared/`: 클라이언트/서버 공유 상수
+```txt
+client/   React + Vite 프론트엔드
+server/   프로덕션 정적 파일 서빙용 Express 서버
+shared/   클라이언트/서버 공유 코드
+docs/     맞춤법 규칙과 운영 문서
+```
+
+핵심 파일:
+
+- `client/src/pages/Home.tsx`: 메인 화면, 입력/결과/공유/표현 추가 UI
+- `client/src/lib/reverseSpellCheck.ts`: 리버스 맞춤법 변환 로직
+- `client/src/lib/reverseSpellCheck.fixtures.ts`: 룰 테스트 fixture
+- `client/src/lib/analytics.ts`: GA4 이벤트 전송
+- `docs/spelling-rules.md`: 현재 적용된 규칙 정리
+- `RULE_UPDATE.md`: 새 맞춤법 룰을 추가할 때의 기준
 
 ## 로컬 개발
 
@@ -23,48 +37,51 @@
 - Node.js 20 이상
 - pnpm
 
-의존성 설치:
-
 ```bash
 pnpm install
-```
-
-개발 서버 실행:
-
-```bash
 pnpm dev
 ```
 
-타입 체크:
+검증:
 
 ```bash
 pnpm check
-```
-
-테스트 실행:
-
-```bash
 pnpm test
-```
-
-프로덕션 빌드:
-
-```bash
 pnpm build
 ```
 
-빌드 결과 미리보기:
+한 번에 확인:
 
 ```bash
-pnpm preview
+pnpm qa
 ```
 
-## Vercel
+## 배포
 
-이 저장소를 Vercel에 가져올 때 `reverse-spell-checker` 디렉터리를 프로젝트 루트로 지정합니다. Vercel의 Vite 프리셋 기준 설정은 다음과 같습니다.
+Vercel Git 연동을 사용합니다. `main` 브랜치에 push하면 Production 배포가 생성됩니다.
 
+Vercel 설정:
+
+- Repository: `makersfarm/reverse-spell-checker`
+- Framework Preset: `Vite`
 - Install Command: `pnpm install --frozen-lockfile`
 - Build Command: `pnpm build`
 - Output Directory: `dist/public`
+- Production Branch: `main`
+
+자세한 내용은 [DEPLOYMENT.md](./DEPLOYMENT.md)를 봅니다.
+
+## 문서
+
+- [맞춤법 룰 업데이트 기준](./RULE_UPDATE.md)
+- [현재 적용 규칙](./docs/spelling-rules.md)
+- [룰 후보 정리](./RULE_CANDIDATES.md)
+- [기능 명세](./SPEC.md)
+- [배포 운영](./DEPLOYMENT.md)
+
+## 운영 메모
 
-현재 MVP에는 런타임 환경 변수가 필요하지 않습니다.
+- 사이트명은 `리버스 맞춤법 검사기`, 화면 타이틀은 `맏춤법 검사기`입니다.
+- 커스텀 도메인은 나중에 붙입니다. 현재 대표 URL은 Vercel 기본 도메인입니다.
+- sitemap은 `sitemap.xml` 하나만 사용합니다.
+- 일반 웹페이지는 Google Indexing API 대상이 아닙니다. 검색 노출 개선은 Search Console URL 검사, sitemap 제출, 외부 링크, 정적 본문 보강으로 처리합니다.