From 79250ab27355b67526aa43af1953bcf0988259bb Mon Sep 17 00:00:00 2001 From: cskwork <76669236+cskwork@users.noreply.github.com> Date: Sun, 10 May 2026 17:05:10 +0900 Subject: [PATCH] docs: drop default-language rule entirely MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Coding agents already mirror the user's input language automatically, so prescribing "concise English" (or any language) added no behavioral effect — only line noise. Remove the rule from AGENTS.md, CLAUDE.md, README.md, and README.ko.md. The other Repository Rules stay because they are not auto-derivable from user language. --- AGENTS.md | 1 - CLAUDE.md | 1 - README.ko.md | 1 - README.md | 1 - log/changelog-2026-05-10.md | 6 ++++++ 5 files changed, 6 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 7d6430c..e70636c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -27,5 +27,4 @@ - Never use emojis. - Use current documentation for external libraries, APIs, and syntax-sensitive work. - For domain-specific code, do not guess. Verify the relevant business/domain context from current code, data, and behavior, then make the smallest accurate fix. -- Comments and docs should be concise English unless the repository convention says otherwise. - Write changelogs reasoning for your decisions at `log/changelog-YYYY-MM-dd.md`. diff --git a/CLAUDE.md b/CLAUDE.md index 85e2227..435d27a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -25,5 +25,4 @@ - Never use emojis. - Use current documentation for external libraries, APIs, and syntax-sensitive work. - For domain-specific code, do not guess. Verify the relevant business/domain context from current code, data, and behavior, then make the smallest accurate fix. -- Comments and docs should be concise English unless the repository convention says otherwise. - Write changelogs reasoning for your decisions at `log/changelog-YYYY-MM-dd.md`. diff --git a/README.ko.md b/README.ko.md index fc8cdbb..3a4848f 100644 --- a/README.ko.md +++ b/README.ko.md @@ -76,7 +76,6 @@ ln -sf ~/coding-agent-rules/AGENTS.md ~/.config/opencode/AGENTS.md - 이모지 사용 금지. - 외부 라이브러리, API, 문법에 민감한 작업은 최신 문서 참조. - 도메인 특화 코드는 추측하지 말고, 현재 코드/데이터/동작에서 관련 업무 맥락을 확인한 뒤 가장 작은 정확한 수정만 적용. -- 주석/문서는 저장소 컨벤션이 다른 경우가 아니면 간결한 영어. - 결정 근거 변경 이력은 `log/changelog-YYYY-MM-dd.md`에 기록. 저장소에 안 맞는 규칙은 빼거나 바꿔라. 핵심은 10계명이다. diff --git a/README.md b/README.md index 9273831..0dc6087 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,6 @@ A short tail of project conventions follows the Ten Commandments. Edit these to - Never use emojis. - Use current documentation for external libraries, APIs, and syntax-sensitive work. - For domain-specific code, do not guess. Verify the relevant business/domain context from current code, data, and behavior, then make the smallest accurate fix. -- Comments and docs should be concise English unless the repository convention says otherwise. - Write changelogs reasoning for your decisions at `log/changelog-YYYY-MM-dd.md`. Drop or replace any rule that does not fit your repo. The Ten Commandments are the load-bearing part. diff --git a/log/changelog-2026-05-10.md b/log/changelog-2026-05-10.md index fd19217..f9f644b 100644 --- a/log/changelog-2026-05-10.md +++ b/log/changelog-2026-05-10.md @@ -5,3 +5,9 @@ - 목적: 이 레포는 영어/한국어 사용자 모두를 위한 글로벌 drop-in이다. 기본값을 영어로 통일해 영어권 사용자에게 합리적인 디폴트를 제공한다. - 결정: `AGENTS.md`, `CLAUDE.md`, `README.md`, `README.ko.md`의 Repository Rules 항목을 "concise Korean" → "concise English" 로 뒤집었다. 한국어 프로젝트는 기존 "unless the repository convention says otherwise" 절로 그대로 opt-in 가능하다. - 영향: 10계명 본문은 변경 없음. Repository Rules 한 줄만 수정. 변경 이력 기록 자체가 한국어인 것은 새 규칙의 "repository convention says otherwise" 동작을 시연하는 사례다. + +## 언어 룰 자체를 제거 (위 결정 후속 정정) + +- 목적: 코딩 에이전트(LLM)는 사용자 입력 언어를 자동으로 미러링한다. "concise English/Korean" 같은 기본 언어 룰은 행동에 영향을 주지 않으면서 줄 수만 늘리는 사족(bloat)이다. +- 결정: 4개 파일(`AGENTS.md`, `CLAUDE.md`, `README.md`, `README.ko.md`)의 Repository Rules에서 언어 디폴트 항목을 완전히 제거했다. 위 "영어로 변경" 결정을 되돌리는 것이 아니라, 룰 자체를 폐기한다. +- 영향: 10계명 본문 변경 없음. 다른 Repository Rules(이모지 금지, 최신 문서 참조, 도메인 검증, changelog 기록)는 모두 유지. 이 룰들은 LLM이 자동으로 따라가지 않는 항목들이라 명시적 지시가 필요하다.