opensocrates 1.5.0 → 1.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (15) hide show
  1. package/CHANGELOG.md +64 -0
  2. package/README.de.md +136 -0
  3. package/README.es.md +134 -0
  4. package/README.fr.md +135 -0
  5. package/README.it.md +134 -0
  6. package/README.ja.md +136 -0
  7. package/README.ko.md +71 -22
  8. package/README.md +74 -22
  9. package/README.pt.md +136 -0
  10. package/README.th.md +121 -0
  11. package/README.zh.md +120 -0
  12. package/VERSION +1 -1
  13. package/installer/managed-hosts.mjs +24 -6
  14. package/installer/opensocrates.mjs +1 -1
  15. package/package.json +6 -2
package/README.ja.md ADDED
@@ -0,0 +1,136 @@
1
+ <p align="center">
2
+ <img src="https://raw.githubusercontent.com/ParkerHwang/OpenSocrates/main/docs/assets/opensocrates-banner.jpg" alt="OpenSocrates" width="820">
3
+ </p>
4
+
5
+ # OpenSocrates
6
+
7
+ **理解し、評価し、使える結果を得るための思考支援。**
8
+
9
+ OpenSocrates は、資料の統合、関係者の視点の理解、選択肢の比較、メッセージの
10
+ 作成を支える 48 種類の思考法を提供します。v1.5.2 は既存の英語・韓国語・簡体字
11
+ 中国語・日本語に、フランス語・ドイツ語・イタリア語・スペイン語・ポルトガル語・
12
+ タイ語を追加します。10 言語で完全な手順ファイルは 480 個、正典の事例は 3,840 個、
13
+ 各方法・言語に 3 個ずつの問いがあり、合計 1,440 個です。コンテンツリビジョンは
14
+ 5 です。既存 4 言語の本文と値は維持し、各方法のリビジョン識別は 4 から 5 に
15
+ 更新します。プログラミング専用の方法は今回の更新には含みません。
16
+
17
+ [English](README.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | **日本語** | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Español](README.es.md) | [Português](README.pt.md) | [ไทย](README.th.md)
18
+
19
+ **ツールを探すエージェントへ：**[課題への適合性、リリースパッケージの選択、設定確認（英語ガイド）](docs/agent-discovery.md)。
20
+
21
+ ## 対応環境とアプリ
22
+
23
+ | アプリ | 提供方式 | 環境と有効化 |
24
+ | --- | --- | --- |
25
+ | Codex | 既存のフック、コントローラー、ネイティブ判断ランタイム | Apple Silicon Mac、Windows x64。対話セッションで 7 個のフックの信頼状態を確認 |
26
+ | Claude Code CLI / Desktop のローカル Code | 状態を保持しないネイティブ入口と完全なローカル参照 | Apple Silicon Mac。Claude CLI、ログイン、プラグインとフックの権限が必要 |
27
+ | Claude Web / Desktop Chat / Cowork | 実行コードを含まないアカウント用スキル ZIP | Mac または Windows でエクスポート後、別途アップロード、有効化、アカウント指示を設定 |
28
+ | Antigravity の会話アプリ | モジュール形式のルールとスキル | Apple Silicon Mac、Windows x64。ワークスペースまたはグローバルを選択 |
29
+
30
+ 対応環境は v1.5.0 を引き継ぎます。Windows のネイティブ Claude Code は対象外
31
+ です。Windows ARM64 対応は別の v1.6.0 作業に属します。アカウント用スキルの
32
+ 導入でネイティブ Claude 連携がインストールされるわけではありません。
33
+
34
+ ## インストールと更新
35
+
36
+ Node.js 20 以降を用意し、利用するアプリをインストールしてログインします。
37
+ ネイティブランタイムは同梱されており、Python の追加インストールは不要です。
38
+ [v1.5.2 リリース](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.2)から
39
+ アーカイブと SHA-256 ファイルを取得するか、次のバージョン固定コマンドを使います。
40
+
41
+ ```sh
42
+ npx --yes opensocrates@1.5.2 install --host codex
43
+ npx --yes opensocrates@1.5.2 status --host codex
44
+ # 既存の Codex インストールを更新：
45
+ npx --yes opensocrates@1.5.2 update --host codex
46
+ ```
47
+
48
+ 対話型 Codex で `/hooks` を入力し、OpenSocrates の 7 個のフックを確認して、
49
+ アプリの信頼手順に従い必要な承認を行います。その後、新しい会話を始めます。
50
+ `status` はインストールと整合性の状態を示します。フックの承認や実際の課題への
51
+ 適用を証明するものではありません。
52
+
53
+ Apple Silicon Mac で Claude Code 連携を導入する場合：
54
+
55
+ ```sh
56
+ npx --yes opensocrates@1.5.2 install --host claude
57
+ npx --yes opensocrates@1.5.2 status --host claude
58
+ ```
59
+
60
+ Antigravity のワークスペースには、既存ディレクトリの絶対パスを指定します。
61
+ `--workspace` を省略するとグローバル範囲になります。同じ課題に両方の副本を
62
+ 重複して適用しないようにします。
63
+
64
+ ```sh
65
+ npx --yes opensocrates@1.5.2 install --host antigravity --workspace /absolute/path/to/workspace
66
+ ```
67
+
68
+ Windows では `"C:\Work\Reading Workshop"` のようなローカルドライブの絶対パスを
69
+ 引用符で囲みます。Claude アカウント用スキルは、既存フォルダー内の絶対 ZIP
70
+ パスにエクスポートします。
71
+
72
+ ```sh
73
+ npx --yes opensocrates@1.5.2 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.2-account.zip
74
+ ```
75
+
76
+ その後 Claude の **Customize → Skills** でアップロードして有効化します。
77
+ 既存の OpenSocrates スキルを置き換える前にダウンロードしてバックアップし、
78
+ 有効状態を記録します。エクスポート成功とアップロード、有効化、自動選択は
79
+ 別の状態です。次の指示を **Settings → General → Instructions for Claude** に
80
+ 追加し、既存の指示を維持します。旧 Cowork では **Settings → Cowork → Global
81
+ instructions** を使います。Web と Desktop のアカウントが異なる場合は、それぞれ
82
+ 設定します。
83
+
84
+ ```text
85
+ 資料の統合、選択肢の比較、判断、メッセージの作成など、解釈や判断が必要な
86
+ 依頼では、私が名前を挙げなくても有効な OpenSocrates スキルを読み込み、
87
+ その指示に従ってください。思考法を適用する前に手順全体を読み、適用条件を
88
+ 確認してください。書式変換などの機械的な作業に不要な手順を追加しないでください。
89
+ ```
90
+
91
+ 保存後に新しい会話を始めます。アカウント用スキルの選択はアプリのモデルが行う
92
+ ため、選択されない場合があります。ネイティブフックや毎メッセージの強制適用は
93
+ 追加されません。既定値と `--host all` は引き続き Codex だけを選択します。
94
+ 他のアプリは明示的に指定します。新しい連携には purge、信頼状態のリセット、
95
+ 自動更新の機能はありません。
96
+ [設定ガイド（英語）](docs/setup-guide.md)で画面上の手順を確認できます。
97
+ [Mac ガイド](docs/macos-v1.5.md)と [Windows ガイド](docs/windows-v1.5.md)は
98
+ v1.5.0 の導入・復旧の基準を保持しています。現在のコマンドには上記の 1.5.2 を使います。
99
+
100
+ ## 指示の言語
101
+
102
+ 明示的に指定した言語、保存した言語設定、現在の入力の文字判定の順に選びます。
103
+ ひらがな・カタカナが含まれる場合は日本語を選びます。それ以外はタイ文字が優勢ならタイ語、ハングルが
104
+ 優勢なら韓国語、漢字が優勢なら中国語です。漢字だけの入力では中国語と日本語を
105
+ 確実に区別できず、中国語が既定になります。日本語が必要な場合は明示的に指定
106
+ してください。フランス語・ドイツ語・イタリア語・スペイン語・ポルトガル語はラテン文字を
107
+ 共有するため、明示的な指定または保存した設定が必要です。文字からこれらの言語を
108
+ 確実に推定することはしません。空の入力、未知の文字、同数の場合は英語です。
109
+ ポルトガル語は汎用の `pt` コードでブラジル式の綴りを使い、地域別の対応は主張しません。
110
+
111
+ 思考指示の言語は、npm インストーラーのコマンド出力やアプリの表示言語とは
112
+ 別です。今回の更新はすべてのインストーラーメッセージの翻訳を約束するものでは
113
+ ありません。ランタイムの `locale` 設定コマンドと明示的な JSON リクエストは
114
+ [言語と対応範囲のガイド（英語）](docs/v1.5.2.md)と
115
+ [言語設定（英語）](docs/settings.md)を参照してください。
116
+
117
+ ## 出典表示とプライバシー
118
+
119
+ 適用条件を満たす正典の思考法の手順全体を読み、実際に回答へ適用した場合に限り、
120
+ 最終回答の末尾に同じ英語の行 `Powered by OpenSocrates` を付けます。読者向けの
121
+ 案内だけを使った場合や機械的な作業では表示しません。この行は出典表示であり、
122
+ ネイティブ適用の成功や回答品質の向上を証明するものではありません。
123
+
124
+ 既定の判断経路は追加の選択モデルを呼び出さず、生のプロンプト、会話、画像、
125
+ 隠れた推論を保存しません。Claude のネイティブ入口は会話を読まず、データベースを
126
+ 初期化しません。アカウント用スキルには実行コードがありません。通常の会話には
127
+ アプリ自身の認証、権限、保存設定、利用規約が適用されます。
128
+ [セキュリティ方針](SECURITY.md)に境界を記載しています。インストール、読み込み、
129
+ 全体の読了、適用、結果の有用性は別々の証拠です。一般的な品質、費用、速度の
130
+ 改善は主張していません。
131
+
132
+ - [方法の本文](content/methods/) · [判断点の契約](docs/decision-points.md)
133
+ - [変更履歴](CHANGELOG.md) · [貢献ガイド](CONTRIBUTING.md) · [行動規範](CODE_OF_CONDUCT.md)
134
+
135
+ OpenSocrates は [MIT ライセンス](LICENSE)の独立したプロジェクトです。
136
+ OpenAI、Anthropic、Google の公式製品ではなく、各社の推奨や保証を受けていません。
package/README.ko.md CHANGED
@@ -12,37 +12,43 @@ OpenSocrates는 진행 중인 작업에 직접 작성한 48개 사고 방법을
12
12
  v1.5의 독자 안내는 결론을 맥락과 다음 행동에 연결합니다. 코딩 전문가 전용
13
13
  기능은 이번 버전에 포함하지 않습니다.
14
14
 
15
- [English](README.md) | **한국어**
15
+ [English](README.md) | **한국어** | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Español](README.es.md) | [Português](README.pt.md) | [ไทย](README.th.md)
16
+
17
+ **도구를 찾는 에이전트에게:** [작업 적합성 판단·배포 패키지 선택·설정 확인 안내](docs/agent-discovery.ko.md).
16
18
 
17
19
  [![CI](https://github.com/ParkerHwang/OpenSocrates/actions/workflows/ci.yml/badge.svg)](https://github.com/ParkerHwang/OpenSocrates/actions/workflows/ci.yml)
18
20
  [![npm](https://img.shields.io/npm/v/opensocrates)](https://www.npmjs.com/package/opensocrates)
19
21
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
20
22
 
21
- ## Mac과 Windows에서 쓰는 v1.5.0
23
+ ## Mac과 Windows에서 쓰는 v1.5.2
22
24
 
23
- v1.5.0은 Codex를 유지하면서 Apple Silicon Mac의 Claude Code 네이티브 연동,
24
- 휴대 가능한 Claude 계정 스킬, Mac·Windows x64의 Antigravity 작업공간·전역
25
- 규칙과 스킬을 추가합니다. 배포 파일과 SHA-256 파일은
26
- [v1.5.0 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.0)에서
27
- 받거나 [npm 설치기](https://www.npmjs.com/package/opensocrates/v/1.5.0)를 사용하세요.
25
+ v1.5.2는 기존 영어·한국어·간체 중국어·일본어에 프랑스어(`fr`)·독일어(`de`)·
26
+ 이탈리아어(`it`)·스페인어(`es`)·포르투갈어(`pt`)·태국어(`th`) 사고 지시문을
27
+ 추가하며 기존 네 호스트 프로필에 제공합니다. v1.5.0의 Apple Silicon Mac·Windows x64
28
+ 지원 범위를 유지하며 Claude Code 네이티브 연동은 Mac만 지원합니다. 배포 파일과 SHA-256 파일은
29
+ [v1.5.2 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.2)에서
30
+ 받거나 [npm 설치기](https://www.npmjs.com/package/opensocrates/v/1.5.2)를 사용하세요.
28
31
 
29
32
  | 호스트 | 전달 방식 | 플랫폼과 활성화 |
30
33
  | --- | --- | --- |
31
34
  | Codex | 기존 훅·컨트롤러·네이티브 판단 런타임 | Apple Silicon Mac·Windows x64; 대화형 세션에서 훅 7개 검토 |
32
35
  | Claude Code CLI / Desktop의 로컬 Code | 상태를 저장하지 않는 네이티브 진입과 설치된 전체 참조 | Apple Silicon Mac; Claude CLI·호스트 로그인·플러그인과 훅 권한 필요 |
33
- | Claude 웹 / Desktop Chat / Cowork | 실행 코드가 없는 독립 계정 스킬 ZIP | Mac·Windows에서 내보낸 뒤 계정의 Skills 화면에서 업로드·활성화 |
36
+ | Claude 웹 / Desktop Chat / Cowork | 실행 코드가 없는 독립 계정 스킬 ZIP | Mac·Windows에서 내보낸 뒤 업로드·활성화하고 아래 계정 지침을 한 번 추가 |
34
37
  | Antigravity 대화 애플리케이션 | 소유 범위가 명확한 모듈형 규칙과 스킬 | Apple Silicon Mac·Windows x64; 작업공간 또는 전역 선택 |
35
38
 
36
39
  Windows 터미널이나 Desktop Code의 Claude Code 네이티브 연동은 이번 릴리스
37
40
  범위에서 제외합니다. 계정 콘텐츠는 네이티브 Claude 연동을 설치하지 않습니다.
38
41
  [Mac 안내](docs/macos-v1.5.ko.md)와 [Windows 안내](docs/windows-v1.5.ko.md)를 참고하세요.
39
42
 
40
- 매번 OpenSocrates 명령을 입력할 필요는 없습니다. 신뢰된 네이티브 훅과
41
- Antigravity 상시 규칙은 진입 안내를 제공합니다. 계정 스킬은 호스트 모델이
42
- 선택하므로 호출되지 않을 수 있습니다. 설치·불러오기·전체 읽기·실제 적용·
43
+ 신뢰된 네이티브 훅과 Antigravity 상시 규칙은 일반 요청에서 진입 안내를
44
+ 제공합니다. Claude 계정 스킬은 아래 상시 지침을 추가해 이름을 반복하지 않고
45
+ 사용하도록 설정하세요. 선택은 여전히 호스트 모델에 맡겨져 누락될 수 있습니다.
46
+ 설치·불러오기·전체 읽기·실제 적용·
43
47
  결과의 유용성은 서로 다른 증거이며, 일반적인 품질·토큰 비용·속도 향상을
44
48
  주장하지 않습니다.
45
49
 
50
+ **설치 다음 단계:** [화면으로 보는 설정 가이드](docs/setup-guide.ko.md)에서 훅 승인, 계정 스킬 켜기, 앱별 완료 상태를 확인하세요. 에이전트에게 붙여 넣을 설치 요청문도 포함합니다.
51
+
46
52
  ## 설치 또는 업데이트
47
53
 
48
54
  Node.js 20 이상과 사용할 호스트를 설치하고 그 호스트에 로그인하세요.
@@ -50,14 +56,14 @@ Node.js 20 이상과 사용할 호스트를 설치하고 그 호스트에 로그
50
56
  지원하는 두 플랫폼에서 Codex를 설치하는 예입니다.
51
57
 
52
58
  ```sh
53
- npx --yes opensocrates@1.5.0 install --host codex
54
- npx --yes opensocrates@1.5.0 status --host codex
59
+ npx --yes opensocrates@1.5.2 install --host codex
60
+ npx --yes opensocrates@1.5.2 status --host codex
55
61
  ```
56
62
 
57
- 기존 v1.4 Codex 설치는 다음 명령으로 업데이트합니다.
63
+ v1.5.0을 포함한 기존 Codex 설치는 다음 명령으로 업데이트합니다.
58
64
 
59
65
  ```sh
60
- npx --yes opensocrates@1.5.0 update --host codex
66
+ npx --yes opensocrates@1.5.2 update --host codex
61
67
  ```
62
68
 
63
69
  대화형 세션에서 Codex 훅 7개를 검토하고 새 대화를 시작하세요. 비대화형 실행은
@@ -67,14 +73,14 @@ npx --yes opensocrates@1.5.0 update --host codex
67
73
  Apple Silicon Mac에서는 Claude 네이티브 연동을 설치할 수 있습니다.
68
74
 
69
75
  ```sh
70
- npx --yes opensocrates@1.5.0 install --host claude
71
- npx --yes opensocrates@1.5.0 status --host claude
76
+ npx --yes opensocrates@1.5.2 install --host claude
77
+ npx --yes opensocrates@1.5.2 status --host claude
72
78
  ```
73
79
 
74
80
  Antigravity는 이미 존재하는 작업공간의 절대 경로를 선택합니다.
75
81
 
76
82
  ```sh
77
- npx --yes opensocrates@1.5.0 install --host antigravity --workspace /absolute/path/to/workspace
83
+ npx --yes opensocrates@1.5.2 install --host antigravity --workspace /absolute/path/to/workspace
78
84
  ```
79
85
 
80
86
  Windows에서는 `C:\Work\Reading Workshop`처럼 로컬 드라이브의 절대 경로로
@@ -83,12 +89,33 @@ Claude 계정 콘텐츠는 이미 존재하는 폴더의 절대 ZIP 경로로
83
89
  Claude의 Customize > Skills 화면에서 업로드하고 활성화합니다.
84
90
 
85
91
  ```sh
86
- npx --yes opensocrates@1.5.0 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.0-account.zip
92
+ npx --yes opensocrates@1.5.2 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.2-account.zip
93
+ ```
94
+
95
+ ### Claude Chat·Cowork: 계정 지침을 한 번 추가하기
96
+
97
+ 요청마다 `/opensocrates`를 입력하지 않고 사용하려면 계정 스킬을 켜고
98
+ **Settings → General → Instructions for Claude**에 아래 지침을 추가하세요.
99
+ 기존 지침은 보존합니다. 이전 Cowork 화면에서는
100
+ **Settings → Cowork → Global instructions**를 사용합니다. 웹과 Desktop의
101
+ 계정이 다르면 사용하는 각 계정에 설정하세요.
102
+
103
+ ```text
104
+ 자료 종합, 선택지 비교, 판단, 메시지 작성처럼 해석이나 판단이 필요한
105
+ 요청에서는 내가 이름을 언급하지 않아도 활성화된 OpenSocrates 스킬을 먼저
106
+ 불러와 그 지침을 따르세요. 적용할 사고 방법의 전체 절차를 읽고 조건을
107
+ 확인하세요. 단순 서식 변환 같은 기계적인 작업에는 불필요한 절차를
108
+ 추가하지 마세요.
87
109
  ```
88
110
 
111
+ 한 번 저장한 뒤 새 대화에서 평소처럼 작업을 요청하세요. 이 지침은 모델의
112
+ 스킬 선택을 안내하며 네이티브 훅이나 매 턴 강제 적용을 추가하지 않습니다.
113
+ [단계별 설정 안내](docs/setup-guide.ko.md#claude-standing-instructions)와
114
+ [Claude 공식 지침 설정](https://support.claude.com/en/articles/10185728-understanding-claude-s-personalization-features)을 참고하세요.
115
+
89
116
  플랫폼별 안내에는 Windows 경로, 계정 스킬 교체, 업데이트·비활성화·제거와
90
117
  검증한 로컬 파일 사용법을 설명합니다. 로컬 파일 옵션을 생략하면 설치기는
91
- GitHub Releases에서 버전을 고정한 v1.5.0 ZIP과 체크섬을 받습니다.
118
+ GitHub Releases에서 버전을 고정한 v1.5.2 ZIP과 체크섬을 받습니다.
92
119
 
93
120
  새 연동에는 `--host claude`, `--host antigravity`, `--host claude-chat`를
94
121
  명시해야 합니다. 기본값과 `--host all`은 계속 Codex를 선택하며 새 호스트를
@@ -98,10 +125,31 @@ GitHub Releases에서 버전을 고정한 v1.5.0 ZIP과 체크섬을 받습니
98
125
  정확한 출처와 소유 범위를 확인하세요. 기존 OpenSocrates 계정 스킬은 교체 전에
99
126
  백업하고 활성화 상태를 보존합니다.
100
127
 
128
+ ## 사고 지시문 언어
129
+
130
+ 48개 방법마다 영어·한국어·간체 중국어·일본어·프랑스어·독일어·이탈리아어·
131
+ 스페인어·포르투갈어·태국어의 전체 절차와 사례를 제공합니다. 전체 절차 파일은
132
+ 480개, 정본 사례는 3,840개이며 방법·언어마다 교사 질문 3개씩 총 1,440개입니다.
133
+ 콘텐츠 리비전 5에서 기존 네 언어의 본문 바이트·값은 유지하고 각 방법의
134
+ 리비전 식별자는 4에서 5로 변경합니다.
135
+
136
+ 신뢰된 명시적 언어, 저장한 언어 선호, 현재 입력 문자 판별 순으로 선택합니다.
137
+ 가나가 있으면 일본어가 우선이며 그 외에는 태국 문자·한글·한자 중 우세한 문자에
138
+ 따라 태국어·한국어·중국어를 선택합니다. 라틴 문자를 사용하는 프랑스어·독일어·
139
+ 이탈리아어·스페인어·포르투갈어는 명시적 또는 저장한 선택이 필요합니다.
140
+ 한자만 있는 일본어도 명시하세요. 빈 입력·알 수 없는 문자·동률은 영어입니다.
141
+ 포르투갈어는 일반 `pt` 코드 아래 브라질식 철자를 사용하며 지역별 별도 지원을
142
+ 주장하지 않습니다.
143
+
144
+ 정확한 런타임 명령·JSON 요청은 [v1.5.2 안내](docs/v1.5.2.ko.md)와
145
+ [언어 선호 설정](docs/settings.ko.md)을 참고하세요. 사고 지시문은 답변 언어·
146
+ npm 설치기 출력·호스트 화면 언어와 별개입니다. Windows ARM64·Go 전환은
147
+ 별도 v1.6.0 작업입니다.
148
+
101
149
  ## 사용 표기가 나오는 조건
102
150
 
103
151
  적격한 사고 방법의 정본 전체를 읽고 현재 답변에 실제로 적용했을 때만 답변
104
- 마지막에 `Powered by OpenSocrates`를 한 줄로 그대로 표시합니다. 영어·한국어에서
152
+ 마지막에 `Powered by OpenSocrates`를 한 줄로 그대로 표시합니다. 열 언어에서
105
153
  같은 문구를 사용합니다. 독자 안내만 사용하거나 기계적인 작업만 했다면 표시하지
106
154
  않습니다. 이 문구는 출처 표기이며 네이티브 적용이나 더 나은 결과의 증명은 아닙니다.
107
155
 
@@ -116,7 +164,8 @@ GitHub Releases에서 버전을 고정한 v1.5.0 ZIP과 체크섬을 받습니
116
164
  - [Mac 설치와 증거의 범위](docs/macos-v1.5.ko.md)
117
165
  - [Windows 설치와 증거의 범위](docs/windows-v1.5.ko.md)
118
166
  - [사고 방법 원문](content/methods/) · [판단 지점 계약](docs/decision-points.ko.md)
119
- - [구현 범위](docs/v1.5.0/IMPLEMENTATION_PLAN.md)
167
+ - [v1.5.2 언어 선택과 지원 범위](docs/v1.5.2.ko.md)
168
+ - [v1.5.0 구현 기준](docs/v1.5.0/IMPLEMENTATION_PLAN.md)
120
169
  - [변경 이력](CHANGELOG.md) · [기여 안내](CONTRIBUTING.md) · [행동 강령](CODE_OF_CONDUCT.md)
121
170
 
122
171
  OpenSocrates는 [MIT 라이선스](LICENSE)를 따르는 독립 프로젝트이며
package/README.md CHANGED
@@ -12,37 +12,43 @@ and write useful messages. The original English/Korean procedures remain intact.
12
12
  The v1.5 reader guides connect conclusions to context and next actions;
13
13
  dedicated coding-specialist features are outside this version.
14
14
 
15
- **English** | [한국어](README.ko.md)
15
+ **English** | [한국어](README.ko.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Español](README.es.md) | [Português](README.pt.md) | [ไทย](README.th.md)
16
+
17
+ **For agents finding tools:** [Assess task fit, choose a released package and verify setup](docs/agent-discovery.md).
16
18
 
17
19
  [![CI](https://github.com/ParkerHwang/OpenSocrates/actions/workflows/ci.yml/badge.svg)](https://github.com/ParkerHwang/OpenSocrates/actions/workflows/ci.yml)
18
20
  [![npm](https://img.shields.io/npm/v/opensocrates)](https://www.npmjs.com/package/opensocrates)
19
21
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
20
22
 
21
- ## v1.5.0 on Mac and Windows
23
+ ## v1.5.2 on Mac and Windows
22
24
 
23
- Version 1.5.0 preserves Codex and adds native Claude Code on Apple-silicon Mac,
24
- a portable Claude account skill, and Antigravity workspace/global rules and
25
- skills on Mac and Windows x64. Download archives and SHA-256 files from the
26
- [v1.5.0 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.0),
27
- or use the [npm installer](https://www.npmjs.com/package/opensocrates/v/1.5.0).
25
+ Version 1.5.2 adds French (`fr`), German (`de`), Italian (`it`), Spanish (`es`),
26
+ Portuguese (`pt`) and Thai (`th`) reasoning instructions to the existing English,
27
+ Korean, Simplified Chinese and Japanese, across all four host profiles. It preserves the v1.5.0 platform scope: Apple-silicon Mac and Windows
28
+ x64, with native Claude Code on Mac only. Download archives and SHA-256 files from the
29
+ [v1.5.2 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.2),
30
+ or use the [npm installer](https://www.npmjs.com/package/opensocrates/v/1.5.2).
28
31
 
29
32
  | Host | Delivery | Platform and activation |
30
33
  | --- | --- | --- |
31
34
  | Codex | Existing hooks, controller and native decision runtime | Apple-silicon Mac and Windows x64; review the seven hooks in an interactive session |
32
35
  | Claude Code CLI / Desktop local Code | Stateless native entry and complete installed references | Apple-silicon Mac; requires the Claude CLI, host login and plugin/hook permissions |
33
- | Claude web / Desktop Chat / Cowork | Standalone content-only account skill ZIP | Export on Mac or Windows; upload and enable through the account's Skills interface |
36
+ | Claude web / Desktop Chat / Cowork | Standalone content-only account skill ZIP | Export on Mac or Windows; upload, enable and add the one-time account instructions below |
34
37
  | Antigravity conversation application | Owned modular rule and skill | Apple-silicon Mac and Windows x64; choose workspace or global scope |
35
38
 
36
39
  Windows native Claude Code in a terminal or Desktop Code is outside this
37
40
  release's scope. Account content does not install a native Claude integration.
38
41
  See the [Mac guide](docs/macos-v1.5.md) and [Windows guide](docs/windows-v1.5.md).
39
42
 
40
- Normal requests need no repeated OpenSocrates command. Trusted native hooks and
41
- Antigravity's standing rule provide entry; account skills are selected by the
42
- host model and may be missed. Installation, loading, complete reads, application,
43
+ Trusted native hooks and Antigravity's standing rule provide entry during normal
44
+ requests. For Claude account skills, add the standing instruction below to use
45
+ OpenSocrates without repeating its name. Selection still depends on the host
46
+ model and can be missed. Installation, loading, complete reads, application,
43
47
  and useful outcomes are separate evidence levels. No general quality, token-cost,
44
48
  or latency improvement is claimed.
45
49
 
50
+ **After installation:** follow the [visual setup guide](docs/setup-guide.md) for hook review, account skill switches, and host readiness. It also includes a request you can paste into an agent.
51
+
46
52
  ## Install or update
47
53
 
48
54
  Install Node.js 20+, make the chosen host available, and sign in to that host.
@@ -50,14 +56,14 @@ Native runtimes are bundled; installation does not require Python. Start with
50
56
  Codex on either supported platform:
51
57
 
52
58
  ```sh
53
- npx --yes opensocrates@1.5.0 install --host codex
54
- npx --yes opensocrates@1.5.0 status --host codex
59
+ npx --yes opensocrates@1.5.2 install --host codex
60
+ npx --yes opensocrates@1.5.2 status --host codex
55
61
  ```
56
62
 
57
- For an existing v1.4 Codex installation, use:
63
+ For an existing Codex installation, including v1.5.0, use:
58
64
 
59
65
  ```sh
60
- npx --yes opensocrates@1.5.0 update --host codex
66
+ npx --yes opensocrates@1.5.2 update --host codex
61
67
  ```
62
68
 
63
69
  Review the seven Codex hooks in an interactive session and start a fresh
@@ -67,14 +73,14 @@ reports installation and integrity; it does not prove automatic delivery.
67
73
  On Apple-silicon Mac, install the native Claude companion with:
68
74
 
69
75
  ```sh
70
- npx --yes opensocrates@1.5.0 install --host claude
71
- npx --yes opensocrates@1.5.0 status --host claude
76
+ npx --yes opensocrates@1.5.2 install --host claude
77
+ npx --yes opensocrates@1.5.2 status --host claude
72
78
  ```
73
79
 
74
80
  For Antigravity, choose an existing absolute workspace directory:
75
81
 
76
82
  ```sh
77
- npx --yes opensocrates@1.5.0 install --host antigravity --workspace /absolute/path/to/workspace
83
+ npx --yes opensocrates@1.5.2 install --host antigravity --workspace /absolute/path/to/workspace
78
84
  ```
79
85
 
80
86
  On Windows, replace the directory with an absolute local-drive path such as
@@ -83,12 +89,34 @@ For Claude account content, export to an absolute ZIP filename in an existing
83
89
  folder, then upload and enable the ZIP in Claude's Customize > Skills interface:
84
90
 
85
91
  ```sh
86
- npx --yes opensocrates@1.5.0 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.0-account.zip
92
+ npx --yes opensocrates@1.5.2 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.2-account.zip
93
+ ```
94
+
95
+ ### Claude Chat and Cowork: one-time account instructions
96
+
97
+ For use without typing `/opensocrates` on each request, enable the account skill
98
+ and append this instruction in **Settings → General → Instructions for Claude**.
99
+ Preserve your existing instructions. In older Cowork interfaces, use
100
+ **Settings → Cowork → Global instructions**; if Web and Desktop use different
101
+ accounts, configure each account you use.
102
+
103
+ ```text
104
+ For requests that require interpretation or judgment, such as synthesizing
105
+ sources, comparing options, making decisions or drafting messages, load the
106
+ enabled OpenSocrates skill and follow its instructions even when I do not
107
+ mention it. Read the complete procedure and check applicability before applying
108
+ a reasoning method. Do not add unnecessary procedures to mechanical work such
109
+ as formatting.
87
110
  ```
88
111
 
112
+ Save once, then start a fresh conversation and describe your task normally.
113
+ The instruction guides model-selected skill use; it adds no native hook or
114
+ guaranteed every-turn enforcement. See the [step-by-step setup guide](docs/setup-guide.md#claude-standing-instructions)
115
+ and [Claude's official instruction settings](https://support.claude.com/en/articles/10185728-understanding-claude-s-personalization-features).
116
+
89
117
  The platform guides cover Windows paths, account replacement, updates, disabling,
90
118
  removal, and verified local-archive alternatives. With no local asset flags,
91
- the installer downloads the pinned v1.5.0 archive and checksum from GitHub Releases.
119
+ the installer downloads the pinned v1.5.2 archive and checksum from GitHub Releases.
92
120
 
93
121
  New profiles require explicit `--host claude`, `--host antigravity`, or
94
122
  `--host claude-chat`. The default and `--host all` continue to select Codex;
@@ -99,11 +127,34 @@ Old multi-host installations are not silently adopted or erased. Reconcile their
99
127
  exact origin and ownership before installing a new profile. Back up an existing
100
128
  OpenSocrates account skill and its enabled state before replacing it.
101
129
 
130
+ ## Reasoning instruction languages
131
+
132
+ All 48 methods include complete procedures and examples in ten languages:
133
+ English, Korean, Simplified Chinese, Japanese, French, German, Italian, Spanish,
134
+ Portuguese and Thai. The release contains 480 procedure files, 3,840 canonical
135
+ cases and 1,440 teacher questions, three per method per language. Content
136
+ revision 5 preserves the existing four languages' body text and values while
137
+ updating each method's revision identity from 4 to 5.
138
+
139
+ An explicit trusted locale takes precedence over a stored preference, then
140
+ current-input script detection applies. Kana selects Japanese first; otherwise
141
+ dominant Thai, Hangul or Han selects Thai, Korean or Chinese. Latin-script
142
+ French, German, Italian, Spanish and Portuguese need an explicit or stored
143
+ choice; they are not reliably identified by script. Han-only Japanese also
144
+ needs an explicit choice. Empty, unknown-script and tied input falls back to
145
+ English. Portuguese uses Brazilian orthography under the generic `pt` code;
146
+ separate regional variants are not claimed.
147
+
148
+ See the [v1.5.2 language guide](docs/v1.5.2.md) and
149
+ [locale settings](docs/settings.md) for exact runtime commands and JSON requests.
150
+ Instruction language is separate from answer language, npm installer output and
151
+ host UI. Windows ARM64 and the Go migration remain separate v1.6.0 work.
152
+
102
153
  ## When attribution appears
103
154
 
104
155
  A final answer ends with the exact line `Powered by OpenSocrates` only when an
105
156
  eligible authored method was read in full and actually applied to that answer.
106
- The wording is the same in English and Korean. Reader guidance alone and
157
+ The wording is the same in all ten languages. Reader guidance alone and
107
158
  mechanical work do not qualify. The line is attribution, not proof of native
108
159
  application or a better result.
109
160
 
@@ -119,7 +170,8 @@ See [SECURITY.md](SECURITY.md).
119
170
  - [Mac installation and evidence boundaries](docs/macos-v1.5.md)
120
171
  - [Windows installation and evidence boundaries](docs/windows-v1.5.md)
121
172
  - [Authored methods](content/methods/) · [Decision-point contract](docs/decision-points.md)
122
- - [Implementation scope](docs/v1.5.0/IMPLEMENTATION_PLAN.md)
173
+ - [v1.5.2 languages, selection and scope](docs/v1.5.2.md)
174
+ - [v1.5.0 implementation baseline](docs/v1.5.0/IMPLEMENTATION_PLAN.md)
123
175
  - [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Code of Conduct](CODE_OF_CONDUCT.md)
124
176
 
125
177
  OpenSocrates is [MIT licensed](LICENSE), independent of OpenAI, Anthropic, and
package/README.pt.md ADDED
@@ -0,0 +1,136 @@
1
+ <p align="center">
2
+ <img src="https://raw.githubusercontent.com/ParkerHwang/OpenSocrates/main/docs/assets/opensocrates-banner.jpg" alt="OpenSocrates" width="820">
3
+ </p>
4
+
5
+ # OpenSocrates
6
+
7
+ **Apoio ao raciocínio para resultados que você pode entender, avaliar e usar.**
8
+
9
+ OpenSocrates oferece 48 métodos de raciocínio para sintetizar fontes, entender
10
+ perspectivas, comparar opções e escrever mensagens úteis. A versão 1.5.2 acrescenta
11
+ português (`pt`), francês, alemão, italiano, espanhol e tailandês ao conteúdo em
12
+ inglês, coreano, chinês simplificado e japonês. Os dez idiomas incluem 480
13
+ procedimentos completos, 3.840 casos canônicos e 1.440 perguntas dirigidas ao
14
+ agente, três por método e idioma. A revisão de conteúdo passa a 5: os textos e
15
+ valores dos quatro idiomas existentes são preservados, enquanto a identidade
16
+ de revisão de cada método muda de 4 para 5. Não são acrescentados métodos
17
+ específicos de programação. O código genérico `pt` usa ortografia brasileira;
18
+ não há uma promessa de suporte separado a todas as variantes regionais.
19
+
20
+ [English](README.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Español](README.es.md) | **Português** | [ไทย](README.th.md)
21
+
22
+ ## Aplicativos e plataformas
23
+
24
+ | Aplicativo | Distribuição | Plataforma e ativação |
25
+ | --- | --- | --- |
26
+ | Codex | Hooks existentes e ambiente nativo de decisão | Mac Apple Silicon e Windows x64; conferir a confiança dos 7 hooks em sessão interativa |
27
+ | Claude Code CLI / Code local do Desktop | Entrada nativa sem estado e referências completas | Mac Apple Silicon; CLI Claude, login e permissões de plugin/hooks |
28
+ | Claude Web / Desktop Chat / Cowork | Skill de conta em ZIP sem código executável | Exportação no Mac ou Windows; envio e ativação separados na conta |
29
+ | Antigravity | Regra e skill modulares | Mac Apple Silicon e Windows x64; escopo de projeto ou global |
30
+
31
+ O escopo de plataformas permanece o de v1.5.0. Claude Code nativo no Windows
32
+ não está incluído. Windows ARM64 e a migração para Go fazem parte do trabalho
33
+ separado de v1.6.0. A skill de conta não instala uma integração nativa Claude.
34
+
35
+ ## Instalar ou atualizar
36
+
37
+ Prepare Node.js 20 ou mais recente e entre no aplicativo escolhido. Os ambientes
38
+ nativos estão incluídos; a instalação não exige Python. Arquivos e somas SHA-256
39
+ estão na [versão v1.5.2](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.2).
40
+
41
+ ```sh
42
+ npx --yes opensocrates@1.5.2 install --host codex
43
+ npx --yes opensocrates@1.5.2 status --host codex
44
+ npx --yes opensocrates@1.5.2 update --host codex
45
+ ```
46
+
47
+ Para uma instalação existente, use `update` em vez de `install`.
48
+ Abra `/hooks` no Codex interativo, revise os 7 hooks OpenSocrates e conceda as
49
+ aprovações necessárias pelo mecanismo de confiança do aplicativo. Depois, inicie
50
+ uma conversa nova. `status` informa instalação e integridade; não comprova
51
+ aprovação de hooks ou aplicação efetiva.
52
+
53
+ Instalações antigas com vários hosts não são adotadas nem apagadas silenciosamente.
54
+ Antes de instalar um novo perfil, confirme a origem exata e a titularidade da
55
+ instalação existente.
56
+
57
+ No Mac Apple Silicon, use `install --host claude` para Claude Code.
58
+ No Antigravity, escolha uma pasta de trabalho existente com caminho absoluto;
59
+ sem `--workspace`, o escopo é global. Evite cópias ativas duplicadas para o mesmo
60
+ trabalho. No Windows, use um caminho de unidade local entre aspas, como
61
+ `"C:\Work\Reading Workshop"`.
62
+
63
+ ```sh
64
+ npx --yes opensocrates@1.5.2 install --host claude
65
+ npx --yes opensocrates@1.5.2 install --host antigravity --workspace /absolute/path/to/workspace
66
+ npx --yes opensocrates@1.5.2 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.2-account.zip
67
+ ```
68
+
69
+ Exporte a skill de conta para um caminho absoluto de arquivo ZIP em uma pasta
70
+ existente, depois envie e ative o arquivo no Claude, em **Customize → Skills**.
71
+ Antes de substituir uma skill OpenSocrates, faça backup do arquivo e registre
72
+ seu estado de ativação. Exportar não significa enviar, ativar ou selecionar
73
+ automaticamente. Acrescente a instrução abaixo em **Settings → General →
74
+ Instructions for Claude**, preservando as instruções existentes:
75
+
76
+ ```text
77
+ Em pedidos que exijam interpretação ou julgamento, como sintetizar fontes,
78
+ comparar opções, tomar decisões ou escrever mensagens, carregue a skill
79
+ OpenSocrates ativada e siga suas instruções mesmo quando eu não mencionar o nome.
80
+ Antes de aplicar um método, leia o procedimento completo e verifique as condições
81
+ de uso. Não acrescente procedimentos desnecessários a tarefas mecânicas como
82
+ formatação.
83
+ ```
84
+
85
+ Em interfaces antigas do Cowork, use **Settings → Cowork → Global instructions**.
86
+ Se Web e Desktop usarem contas diferentes, configure cada uma e inicie uma
87
+ conversa nova. A seleção depende do modelo e pode não ocorrer; não acrescenta
88
+ hooks nativos nem uso garantido a cada mensagem. O padrão e `--host all`
89
+ continuam selecionando apenas Codex.
90
+
91
+ ## Escolher o idioma das instruções
92
+
93
+ A escrita latina não identifica português de forma confiável entre os idiomas
94
+ suportados. Use uma preferência explícita ou salva. Na raiz do pacote Codex
95
+ instalado no Mac:
96
+
97
+ ```sh
98
+ bin/launch.sh locale codex set pt
99
+ bin/launch.sh locale codex get
100
+ bin/launch.sh locale codex reset
101
+ ```
102
+
103
+ No Windows, use `node bin/launch.mjs locale codex set pt`.
104
+ `set follow` ou `reset` apaga apenas a preferência de idioma. Ela se aplica ao
105
+ seletor mantido; pedidos de decisão sem estado exigem o campo JSON explícito
106
+ `locale` e não leem configurações. Pacotes de conta ou conteúdo usam o guia e
107
+ as referências do idioma correspondente.
108
+
109
+ A ordem é: idioma explícito confiável, preferência salva e caracteres da entrada
110
+ atual. Kana seleciona japonês primeiro; caso contrário, o predomínio de caracteres
111
+ tailandeses, hangul ou han seleciona tailandês, coreano ou chinês. Empates,
112
+ entradas vazias e escritas desconhecidas usam inglês. Japonês sem kana é ambíguo
113
+ e precisa de `ja`. Idioma das instruções, da resposta, da interface e das
114
+ mensagens npm são coisas separadas. O instalador npm não tem opção `--locale`.
115
+
116
+ ## Atribuição, privacidade e limites
117
+
118
+ A linha final exata `Powered by OpenSocrates` só aparece depois da leitura
119
+ integral e aplicação efetiva de um método canônico elegível à resposta. Orientação
120
+ de leitura isolada e tarefas mecânicas não atendem à condição. A atribuição não
121
+ comprova aplicação nativa nem melhoria do resultado.
122
+
123
+ O caminho padrão de decisão não chama um modelo seletor adicional nem armazena
124
+ prompts brutos, conversas, capturas de tela ou raciocínio oculto. A entrada nativa
125
+ Claude não lê conversas nem inicializa um banco de dados. Pedidos normais seguem
126
+ a autenticação, permissões, retenção e termos do aplicativo. Instalação,
127
+ carregamento, leitura completa, aplicação e utilidade são evidências diferentes.
128
+ Não se afirmam ganhos universais de qualidade, custo ou velocidade.
129
+
130
+ Consulte o [guia de idiomas](docs/v1.5.2.md), as [configurações](docs/settings.md),
131
+ a [configuração visual](docs/setup-guide.md) e a [política de segurança](SECURITY.md).
132
+ Os guias de [Mac](docs/macos-v1.5.md) e [Windows](docs/windows-v1.5.md) mantêm as
133
+ observações históricas; use aqui os comandos atuais de 1.5.2.
134
+
135
+ OpenSocrates é um projeto independente sob a [licença MIT](LICENSE), sem vínculo
136
+ ou endosso de OpenAI, Anthropic ou Google. [Histórico de mudanças](CHANGELOG.md).