diff --git a/AGENTS.md b/AGENTS.md
index f7f8d9ea16..5585ecadd8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -54,6 +54,8 @@ Use ESM TypeScript, two-space indentation, and the committed Oxfmt configuration
Treat a boundary as a contract between the producer's actual representation and the consumer's required meaning. When implementing or auditing a boundary, trace the value through parsing, normalization, authorization, serialization, and the CLI/MCP result. Establish affected callers from their code paths; similar tool names or workflows do not prove that they share a schema or failure mode.
+When changing boundary behavior, inspect adjacent input representations, failure paths, and affected callers, and correct the underlying assumption across those cases.
+
Keep portable evidence and scenario validation distinct from host-native execution checks. Absolute filesystem paths, file URLs, and HTTP paths have different semantics; do not substitute one platform's syntax for the domain concept. Interpret provider metadata according to its documented or observed producer behavior. When a transformation loses information, preserve the reported value and an explicit unknown rather than guessing a canonical identity.
Preserve meaningful failure reasons through application and adapter layers. Malformed input is distinct from an unsupported target, unavailable provider, or host operating-system permission denial. Diagnostics should identify the failed constraint and the target or lifecycle request it applies to. Recovery advice must address that reason and point to an available workflow; generic catches must not erase actionable validation details.
diff --git a/README.md b/README.md
index 94800af9c3..3ac6a90da2 100644
--- a/README.md
+++ b/README.md
@@ -16,10 +16,6 @@
[](LICENSE)
[](https://discord.gg/GkcryMnJDM)
-🎉 **20,000 GitHub stars — thank you!**
-
-Thanks to everyone using REA, reporting bugs, testing builds, and contributing fixes.
-
**[Website](https://morluto.github.io/rea/) · [Guides](https://morluto.github.io/rea/guides/) · [Showcases](https://morluto.github.io/rea/showcase/)**
@@ -319,12 +315,12 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and checks,
[Website](https://morluto.github.io/rea/) · [npm](https://www.npmjs.com/package/rea-agents) · [skills.sh](https://skills.sh/morluto/rea/reverse-engineer-anything) · [Issues](https://github.com/morluto/rea/issues) · [Security](SECURITY.md)
-## License
-
-[MIT](LICENSE)
-
## Star history
+🎉 **20,000 GitHub stars — thank you!**
+
+Thanks to everyone using REA, reporting bugs, testing builds, and contributing fixes.
+
@@ -336,3 +332,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and checks,
## Disclaimer
REA provides tools for lawful reverse-engineering research, analysis, and reconstruction. You are responsible for obtaining any required authorization and complying with applicable laws. The project does not endorse illegal or unauthorized use.
+
+## License
+
+[MIT](LICENSE)
diff --git a/README_ar.md b/README_ar.md
index 0e8e70fc87..2cfccff05e 100644
--- a/README_ar.md
+++ b/README_ar.md
@@ -15,10 +15,6 @@
[](LICENSE)
[](https://discord.gg/GkcryMnJDM)
-🎉 **وصلنا إلى 20,000 نجمة على GitHub، شكرًا لكم!**
-
-شكرًا لكل من يستخدم REA ويبلّغ عن الأخطاء ويختبر الإصدارات ويساهم في إصلاحها.
-
**[الموقع (بالإنجليزية)](https://morluto.github.io/rea/) · [أدلة الاستخدام](https://morluto.github.io/rea/guides/) · [دراسة حالة DX-Ball](https://morluto.github.io/rea/showcase/dx-ball/)**
@@ -340,6 +336,20 @@ npx -y rea-agents@latest compare /absolute/path/to/left-evidence.json /absolute/
- [Hopper Disassembler](https://www.hopperapp.com/)
- [سياسة الأمان](SECURITY.md)
+## تاريخ النجوم
+
+🎉 **وصلنا إلى 20,000 نجمة على GitHub، شكرًا لكم!**
+
+شكرًا لكل من يستخدم REA ويبلّغ عن الأخطاء ويختبر الإصدارات ويساهم في إصلاحها.
+
+
+
+
+
+
+
+
+
## الترخيص
[MIT](LICENSE)
diff --git a/README_ja.md b/README_ja.md
index f89f9d4432..213ceeb3a6 100644
--- a/README_ja.md
+++ b/README_ja.md
@@ -15,10 +15,6 @@
[](LICENSE)
[](https://discord.gg/GkcryMnJDM)
-🎉 **GitHub スターが 20,000 を突破しました。ありがとうございます!**
-
-REA を使い、問題を報告し、ビルドをテストし、修正を届けてくださる皆さんに感謝します。
-
**[ウェブサイト(英語)](https://morluto.github.io/rea/) · [ガイド](https://morluto.github.io/rea/guides/) · [DX-Ball の事例](https://morluto.github.io/rea/showcase/dx-ball/)**
@@ -370,6 +366,20 @@ REA にホスト型の解析サービスはありません。現在のプロバ
開発環境、アーキテクチャ、テスト、リリース手順は [CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。
+## スター履歴
+
+🎉 **GitHub スターが 20,000 を突破しました。ありがとうございます!**
+
+REA を使い、問題を報告し、ビルドをテストし、修正を届けてくださる皆さんに感謝します。
+
+
+
+
+
+
+
+
+
## ライセンス
[MIT](LICENSE)
diff --git a/README_ko.md b/README_ko.md
index 7aa2b334ef..f8a13d3e41 100644
--- a/README_ko.md
+++ b/README_ko.md
@@ -15,10 +15,6 @@
[](LICENSE)
[](https://discord.gg/GkcryMnJDM)
-🎉 **GitHub 스타 20,000개, 감사합니다!**
-
-REA를 사용하고, 버그를 제보하고, 빌드를 테스트하고, 수정에 기여해 주신 모든 분께 감사드립니다.
-
**[웹사이트(영문)](https://morluto.github.io/rea/) · [가이드](https://morluto.github.io/rea/guides/) · [DX-Ball 사례](https://morluto.github.io/rea/showcase/dx-ball/)**
@@ -319,6 +315,20 @@ REA에는 호스팅 분석 서비스가 없습니다. 로컬 Unix 소켓을 통
개발 환경, 아키텍처, 테스트, 릴리스 지침은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요.
+## 스타 기록
+
+🎉 **GitHub 스타 20,000개, 감사합니다!**
+
+REA를 사용하고, 버그를 제보하고, 빌드를 테스트하고, 수정에 기여해 주신 모든 분께 감사드립니다.
+
+
+
+
+
+
+
+
+
## 라이선스
[MIT](LICENSE)
diff --git a/README_zh.md b/README_zh.md
index dea70c179f..bc3cd5e545 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -15,10 +15,6 @@
[](LICENSE)
[](https://discord.gg/GkcryMnJDM)
-🎉 **GitHub Star 突破 20,000,感谢大家!**
-
-感谢每一位使用 REA、反馈问题、测试构建和贡献修复的朋友。
-
**[网站(英文)](https://morluto.github.io/rea/) · [使用指南](https://morluto.github.io/rea/guides/) · [DX-Ball 案例](https://morluto.github.io/rea/showcase/dx-ball/)**
@@ -320,6 +316,20 @@ REA 不提供托管分析服务,而是通过本地 Unix 套接字把操作交
开发环境、架构、测试和发布说明请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
+## Star 历史
+
+🎉 **GitHub Star 突破 20,000,感谢大家!**
+
+感谢每一位使用 REA、反馈问题、测试构建和贡献修复的朋友。
+
+
+
+
+
+
+
+
+
## 许可证
[MIT](LICENSE)