From 1bd089936ee9e034a721f9c8180aac9d3802d3d4 Mon Sep 17 00:00:00 2001
From: Sergey <93754860+slaid098@users.noreply.github.com>
Date: Wed, 29 Jul 2026 18:09:10 +0300
Subject: [PATCH] fix(readme): replace GB flag with US flag for English section
 (#126)

* fix(readme): replace GB flag with US flag for English section

* fix(create-readme): validate US English flag header in validateReadme

* docs(handoff): set PR number

---------

Co-authored-by: opencode-agent <agent@opencode.local>
---
 .opencode/skills/repo-readme/SKILL.md           |  2 +-
 .opencode/tools/create-readme.ts                |  4 +++-
 README.md                                       |  2 +-
 .../056-pr-126-replace-gb-flag-with-us.md       | 13 +++++++++++++
 docs/handoff/pr-126-replace-gb-flag-with-us.md  | 17 +++++++++++++++++
 5 files changed, 35 insertions(+), 3 deletions(-)
 create mode 100644 docs/decisions/056-pr-126-replace-gb-flag-with-us.md
 create mode 100644 docs/handoff/pr-126-replace-gb-flag-with-us.md

diff --git a/.opencode/skills/repo-readme/SKILL.md b/.opencode/skills/repo-readme/SKILL.md
index fceda5b..211ce17 100644
--- a/.opencode/skills/repo-readme/SKILL.md
+++ b/.opencode/skills/repo-readme/SKILL.md
@@ -79,7 +79,7 @@ repos/{owner}/{repo}/contents/README.md` с base64-контентом и SHA.
 
 ---
 
-## 🇬🇧 English
+## 🇺🇸 English
 
 <!-- summary-en:start -->
 ### ❓ Why
diff --git a/.opencode/tools/create-readme.ts b/.opencode/tools/create-readme.ts
index 461be0c..27c34f8 100644
--- a/.opencode/tools/create-readme.ts
+++ b/.opencode/tools/create-readme.ts
@@ -59,7 +59,7 @@ function generateReadme(args: CreateArgs): string {
 
 ---
 
-## 🇬🇧 English
+## 🇺🇸 English
 
 <!-- summary-en:start -->
 ### ❓ Why
@@ -149,6 +149,8 @@ function validateReadme(content: string): { ok: boolean; issues: string[] } {
     issues.push("Missing [Русский] language switcher link")
   if (!content.includes("## 🇷🇺 Русский"))
     issues.push("Missing '## 🇷🇺 Русский' header (should be 'Русский', not 'Русская версия')")
+  if (!content.includes("## 🇺🇸 English"))
+    issues.push("Missing '## 🇺🇸 English' header")
   if (!content.includes("[Русский](#-русский)"))
     issues.push("Missing or wrong [Русский](#-русский) switcher link (should be #-русский, not #-русская-версия)")
 
diff --git a/README.md b/README.md
index ec4a90b..70edc34 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 
 ---
 
-## 🇬🇧 English
+## 🇺🇸 English
 
 <!-- summary-en:start -->
 ### ❓ Why
diff --git a/docs/decisions/056-pr-126-replace-gb-flag-with-us.md b/docs/decisions/056-pr-126-replace-gb-flag-with-us.md
new file mode 100644
index 0000000..38fb540
--- /dev/null
+++ b/docs/decisions/056-pr-126-replace-gb-flag-with-us.md
@@ -0,0 +1,13 @@
+# ADR-056: Replace GB flag with US flag for English section
+
+## Статус
+Accepted (2026-07-29)
+
+## Контекст
+README English section used British flag 🇬🇧, but project uses American English. Inconsistency between flag and language variant.
+
+## Решение
+Replace 🇬🇧 with 🇺🇸 in all README templates (README.md, create-readme.ts, SKILL.md). Add validation check in `validateReadme()` to enforce `## 🇺🇸 English` header in future READMEs.
+
+## Альтернативы
+—
diff --git a/docs/handoff/pr-126-replace-gb-flag-with-us.md b/docs/handoff/pr-126-replace-gb-flag-with-us.md
new file mode 100644
index 0000000..99a2e3a
--- /dev/null
+++ b/docs/handoff/pr-126-replace-gb-flag-with-us.md
@@ -0,0 +1,17 @@
+---
+pr: 126
+title: Replace GB flag with US flag for English section
+---
+
+## Что сделано
+- Заменён флаг 🇬🇧 → 🇺🇸 в заголовке `## ... English` в README.md, шаблоне create-readme.ts и reference-блоке SKILL.md
+- Добавлена validation check в `validateReadme()` для заголовка `## 🇺🇸 English`
+
+## Почему
+Британский флаг не соответствует американскому английскому, используемому в проекте. Validation check гарантирует, что future README files используют правильный флаг.
+
+## Pending
+—
+
+## Watch out
+—