docs: README 다섯에 ⌥⏎ 단순 복사를 적는다

[say8425]

#69가 ⌥⏎ 단순 복사(프롬프트 · 코드펜스 · File:/Lines: 머리말 없이 잡은 코드 텍스트만 복사)를 추가했는데, 사용자 문서 어디에도 적히지 않았다. 루트 README와 번역 4종은 grab 흐름을 "Enter를 누르면 한 덩어리"까지 설명하므로 새 단축키만 빠진 상태였다.

무엇을 했나

두 출력 형식이 나란히 읽히도록, 기존 "Enter = 한 덩어리" 문장 바로 뒤에 한 문장씩 붙였다. macOS ⌥와 Windows/Linux Alt를 함께 적는다.

파일	상태
README.md (루트)	✅
docs/README.{ko,ja,zh,es}.md	✅
skills/diffdeck/SKILL.md	✅ (아래 참고 — 처음엔 뺐다가 리뷰에서 뒤집었다)
apps/viewer/README.md (npm 페이지)	대상 아님 — grab을 아예 다루지 않는다(실측: grab·select·clipboard·prompt·gutter 매치 0)

왜 게이트가 못 잡았나

apps/viewer/__tests__/docs-flags-parity.test.ts는 HELP의 CLI 플래그만 일곱 문서와 대조한다. ⌥⏎는 CLI 플래그가 아니라 앱 내 키 바인딩이라 그 게이트의 감시 범위 밖이고 앞으로도 그렇다 — 손으로 챙겨야 하는 표면이다.

SKILL.md를 결국 넣은 이유

처음엔 "⌥⏎ 산출물은 맨 코드라 에이전트에 새로 설명할 형식이 없다"고 보고 뺐다. 리뷰에서 뒤집혔고, 근거가 타당했다:

1. SKILL.md:59가 "Grab copies a single fenced block plus the human's prompt" 라고 무조건 단언한다 — feat: 그랩 팝오버 ⌥⏎ 단순 복사와 라인넘버 드래그 선택 제거 #69 이후로는 과장이다. → "Pressing Enter copies…" 로 한정했다.
2. 더 중요한 건 형식 위험이다. 같은 문서가 크로스사이드 블록에서 "every line is prefixed with -, +, or a space — strip that first character" 라고 지시하는데, ⌥⏎ 산출물은 그 마커가 이미 빠져 있다(encode.ts의 plainSnippet). 규칙을 그대로 적용하면 에이전트가 같은 줄의 옛/새 버전을 연속된 파일 내용으로 오독한다. 그 규칙 바로 뒤에 예외와 "어느 파일·어느 side인지 먼저 물어라"를 적었다.

리뷰 반영 (2번째 커밋)

번역 교정은 전부 실측 근거가 있는 것만 반영했다.

• ja·zh: 문장을 잇느라 。 뒤에 ASCII 공백이 들어갔다 — 각 파일에서 유일한 사례였다(ja 49개 중 1, zh 46개 중 1). 전각 마침표는 자체 여백이 있어 다른 문장 경계보다 눈에 띄게 벌어진다.
• es: las líneas(여성 복수)를 받는데 pegarlo(남성 단수)라 성수 불일치 → pegarlas. em-dash도 파일 관례(공백 있는 —, 22곳)에 맞췄다.
• zh: 같은 문단이 이미 쓰는 提示를 두고 提示词를, 29행이 쓰는 文件头를 두고 文件标题를 새로 만들었다 → 파일 어휘로 되돌렸다.
• ja: 명사구로 끝나 주변 문장(…を押すと、…されます)과 호흡이 달랐다 → 같은 구조로. 選んだ行도 選択した行으로 통일.
• 정확성(다섯 문서 전부): mixed 선택 단서를 붙였다. plainSnippet은 양쪽에 걸친 선택에서 +/- 마커를 의도적으로 뺀다. 그래서 "편집기에 그대로"라는 약속이 그 경우엔 어긋난다 — 같은 줄의 옛/새 버전이 잇달아 놓인다.

리뷰가 확인해 준 것 중 가장 값진 것: #69의 라인넘버 드래그 제거가 이 READMEs를 낡게 만들지 않았다. 다섯 파일 모두 진입 경로를 "거터의 라인 선택 + + 버튼"으로만 적고 있어, 애초에 "라인넘버를 가로질러 드래그"를 약속한 적이 없다.

Test plan

• bun test apps/viewer/__tests__/docs-flags-parity.test.ts → 65 pass / 0 fail (일곱 문서 대조 게이트)
• bun test → 703 pass / 0 fail
• 마크다운만 바뀌므로 typecheck/lint/format 대상 코드는 변동 없음(oxlint/oxfmt 스코프는 apps/의 소스다).

🤖 Generated with Claude Code

https://claude.ai/code/session_01PaHtxdofJX6EvH7BWXgYKX