opensocrates 1.5.1 → 1.5.2

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [1.5.2] - 2026-10-13
+
+- Add French (`fr`), German (`de`), Italian (`it`), Spanish (`es`), Portuguese
+  (`pt`) and Thai (`th`) to the existing English, Korean, Simplified Chinese and
+  Japanese content across all four host profiles. Provide 480 complete procedure
+  files, 3,840 canonical cases and 1,440 teacher questions for 48 methods in ten
+  languages. Portuguese uses Brazilian orthography under the generic `pt` code;
+  separate regional variants are not claimed.
+- Advance bundle, overlay and individual method identity to content revision 5.
+  Preserve the existing four languages' authored procedure/case body bytes and
+  metadata/question values; prior revision 4 read evidence does not become
+  revision 5 evidence merely because body text is unchanged.
+- Extend closed runtime preferences, decision JSON locales and package inventories
+  to all ten languages. Preserve explicit preference over stored preference,
+  then script detection; add dominant Thai-script detection and retain Kana
+  priority. Latin-script European languages require an explicit or stored choice;
+  ties, empty input and unknown scripts use English. Keep complete historical
+  two-/four-language runtime content compatibility without silently upgrading it.
+- Add six native-language READMEs, current settings/language guides and a separate
+  language-review record. Preserve the four existing profiles, Mac ARM64 and
+  Windows x64 qualification, privacy, attribution, ownership, rollback and
+  fail-open boundaries. Go migration and Windows ARM64 remain v1.6.0 work.
+- 기존 영어·한국어·간체 중국어·일본어에 프랑스어·독일어·이탈리아어·스페인어·
+  포르투갈어·태국어를 추가합니다. 열 언어·사고 방법 48개의 전체 절차 480개,
+  정본 사례 3,840개, 교사 질문 1,440개를 네 호스트 프로필에 제공합니다.
+  포르투갈어는 일반 `pt` 코드와 브라질식 철자를 사용하며 지역별 지원을
+  별도로 주장하지 않습니다.
+- 번들·오버레이·개별 방법의 콘텐츠 리비전은 5로 바뀝니다. 기존 네 언어의
+  절차·사례 본문 바이트와 메타데이터·질문 값은 유지합니다. 본문이 같다는
+  이유로 리비전 4의 읽기 증거를 리비전 5의 증거로 간주하지 않습니다.
+- 폐쇄된 언어 선호·판단 JSON·패키지 목록을 열 언어로 확장합니다. 명시적
+  선호 → 저장 선호 → 문자 판별 순서를 유지하고 태국 문자 우세 판별을
+  추가합니다. 가나 우선순위를 유지하며 라틴 문자 언어에는 명시적·저장
+  선택이 필요합니다. 동률·빈 입력·알 수 없는 문자는 영어입니다. 완전한
+  과거 두 언어·네 언어 콘텐츠의 런타임 호환성을 유지하되 새 언어로 자동
+  변경하지 않습니다.
+- 여섯 언어 README와 현재 설정·언어 안내, 별도 언어 검토 기록을 추가합니다.
+  기존 네 프로필·Mac ARM64·Windows x64 검증 범위와 개인정보·사용 표기·
+  소유권·롤백·fail-open 경계를 유지합니다. Go·Windows ARM64는 v1.6.0입니다.
+
 ## [1.5.1] - 2026-10-13
 
 - Add Simplified Chinese (`zh`) and Japanese (`ja`) alongside English and Korean

package/README.de.md

@@ -0,0 +1,136 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ParkerHwang/OpenSocrates/main/docs/assets/opensocrates-banner.jpg" alt="OpenSocrates" width="820">
+</p>
+
+# OpenSocrates
+
+**Denkunterstützung für Ergebnisse, die Sie verstehen, beurteilen und nutzen können.**
+
+OpenSocrates bietet 48 Denkmethoden zum Zusammenführen von Quellen, Verstehen
+von Perspektiven, Vergleichen von Optionen und Schreiben hilfreicher Nachrichten.
+v1.5.2 ergänzt Deutsch (`de`), Französisch, Italienisch, Spanisch, Portugiesisch
+und Thai zu Englisch, Koreanisch, vereinfachtem Chinesisch und Japanisch.
+Die zehn Sprachen enthalten 480 vollständige Verfahren, 3.840 kanonische Fälle
+und 1.440 Fragen an den Agenten, jeweils drei pro Methode und Sprache.
+Inhaltsrevision 5 erhält Texte und Werte der bisherigen vier Sprachen; die
+Revisionskennung jeder Methode wechselt jedoch von 4 zu 5. Spezielle Methoden
+für Programmieraufgaben kommen nicht hinzu.
+
+[English](README.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Français](README.fr.md) | **Deutsch** | [Italiano](README.it.md) | [Español](README.es.md) | [Português](README.pt.md) | [ไทย](README.th.md)
+
+## Anwendungen und Plattformen
+
+| Anwendung | Bereitstellung | Plattform und Aktivierung |
+| --- | --- | --- |
+| Codex | Bestehende Hooks und native Entscheidungsruntime | Apple-Silicon-Mac und Windows x64; Vertrauen für 7 Hooks in einer interaktiven Sitzung prüfen |
+| Claude Code CLI / lokaler Desktop-Code | Zustandsloser nativer Einstieg und vollständige Referenzen | Apple-Silicon-Mac; Claude CLI, Anmeldung und Plugin-/Hook-Berechtigungen |
+| Claude Web / Desktop Chat / Cowork | Konto-Skill als ZIP ohne ausführbaren Code | Export auf Mac oder Windows; Upload und Aktivierung im Konto sind getrennte Schritte |
+| Antigravity | Modulare Regel und Skill | Apple-Silicon-Mac und Windows x64; Arbeitsbereich oder globaler Geltungsbereich |
+
+Der Plattformumfang bleibt wie in v1.5.0. Natives Claude Code unter Windows
+gehört nicht dazu. Windows ARM64 und die Go-Migration sind separate Arbeiten
+für v1.6.0. Ein Konto-Skill installiert keine native Claude-Integration.
+
+## Installieren oder aktualisieren
+
+Installieren Sie Node.js 20 oder neuer und melden Sie sich bei der gewünschten
+Anwendung an. Native Laufzeitprogramme sind enthalten; Python ist zur Installation
+nicht nötig. Archive und SHA-256-Dateien finden Sie auf der
+[Release-Seite v1.5.2](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.2).
+
+```sh
+npx --yes opensocrates@1.5.2 install --host codex
+npx --yes opensocrates@1.5.2 status --host codex
+npx --yes opensocrates@1.5.2 update --host codex
+```
+
+Verwenden Sie bei einer vorhandenen Installation `update` statt `install`.
+Öffnen Sie `/hooks` im interaktiven Codex, prüfen Sie die 7 OpenSocrates-Hooks
+und erteilen Sie erforderliche Freigaben über die Vertrauensfunktion des Hosts.
+Starten Sie danach eine neue Unterhaltung. `status` prüft Installation und
+Integrität, beweist jedoch keine Hook-Freigabe oder tatsächliche Anwendung.
+
+Für Claude Code auf einem Apple-Silicon-Mac verwenden Sie `install --host claude`.
+Für Antigravity wählen Sie einen bestehenden Arbeitsbereich mit absolutem Pfad;
+ohne `--workspace` gilt die Installation global. Vermeiden Sie doppelte aktive
+Installationen für dieselbe Aufgabe. Unter Windows verwenden Sie einen lokalen
+Laufwerkspfad in Anführungszeichen, etwa `"C:\Work\Reading Workshop"`.
+
+```sh
+npx --yes opensocrates@1.5.2 install --host claude
+npx --yes opensocrates@1.5.2 install --host antigravity --workspace /absolute/path/to/workspace
+npx --yes opensocrates@1.5.2 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.2-account.zip
+```
+
+Exportieren Sie den Konto-Skill an einen absoluten ZIP-Dateipfad in einem
+bestehenden Ordner. Laden Sie ihn anschließend in Claude unter **Customize →
+Skills** hoch und aktivieren Sie ihn. Sichern Sie vor einem Austausch den bisherigen
+OpenSocrates-Skill und seinen Aktivierungszustand. Der Export beweist weder Upload
+noch Aktivierung oder automatische Auswahl. Ergänzen Sie unter **Settings →
+General → Instructions for Claude** diese Anweisung; bestehende Anweisungen bleiben erhalten:
+
+```text
+Laden Sie bei Aufgaben, die Interpretation oder Urteil erfordern, etwa beim
+Zusammenführen von Quellen, Vergleichen von Optionen, Entscheiden oder Schreiben
+von Nachrichten, den aktivierten OpenSocrates-Skill und befolgen Sie seine
+Anweisungen, auch wenn ich ihn nicht nenne. Lesen Sie vor der Anwendung einer
+Denkmethode das vollständige Verfahren und prüfen Sie die Anwendungsbedingungen.
+Ergänzen Sie mechanische Aufgaben wie Formatierung nicht um unnötige Verfahren.
+```
+
+Ältere Cowork-Oberflächen verwenden **Settings → Cowork → Global instructions**.
+Richten Sie verschiedene Web-/Desktop-Konten getrennt ein und starten Sie eine
+neue Unterhaltung. Die Auswahl erfolgt durch das Modell und kann ausbleiben;
+es gibt keinen neuen nativen Hook oder garantierten Einsatz bei jeder Nachricht.
+Standardwert und `--host all` wählen weiterhin nur Codex.
+
+## Sprache der Anweisungen wählen
+
+Deutsch lässt sich anhand der lateinischen Schrift nicht zuverlässig von den
+anderen unterstützten Sprachen unterscheiden. Wählen Sie daher eine ausdrückliche
+oder gespeicherte Präferenz. Im Stammverzeichnis des installierten Codex-Pakets auf Mac:
+
+```sh
+bin/launch.sh locale codex set de
+bin/launch.sh locale codex get
+bin/launch.sh locale codex reset
+```
+
+Unter Windows verwenden Sie `node bin/launch.mjs locale codex set de`.
+`set follow` oder `reset` löscht nur die Sprachpräferenz. Sie gilt für den
+beibehaltenen Selektor. Zustandslose Entscheidungsanfragen benötigen ein explizites
+JSON-Feld `locale` und lesen keine Einstellungen. Konto-/Inhaltspakete verwenden
+den passenden Sprachleitfaden und die vollständigen Referenzen.
+
+Die Reihenfolge lautet: vertrauenswürdige explizite Sprache, gespeicherte Präferenz,
+dann Schriftzeichen der aktuellen Eingabe. Kana haben Vorrang für Japanisch;
+sonst wählen überwiegende Thai-, Hangul- oder Han-Zeichen Thai, Koreanisch oder
+Chinesisch. Bei Gleichstand, leerer Eingabe oder unbekannter Schrift gilt Englisch.
+Japanisch ohne Kana ist mehrdeutig und benötigt `ja`. Portugiesisch verwendet
+brasilianische Schreibweise unter `pt`; separate Regionalvarianten werden nicht
+beansprucht. Anweisungssprache, Antwortsprache, Host-Oberfläche und npm-Ausgaben
+sind getrennt. Der npm-Installer besitzt keine Option `--locale`.
+
+## Quellenangabe, Datenschutz und Grenzen
+
+Die genaue Schlusszeile `Powered by OpenSocrates` erscheint nur, wenn eine
+geeignete kanonische Methode vollständig gelesen und tatsächlich auf die Antwort
+angewendet wurde. Lesehinweise allein und mechanische Arbeit reichen nicht aus.
+Die Zeile beweist weder native Anwendung noch bessere Ergebnisse.
+
+Der standardmäßige Entscheidungsweg ruft kein zusätzliches Auswahlmodell auf
+und speichert keine Rohprompts, Unterhaltungen, Screenshots oder verborgenen
+Gedankengänge. Der native Claude-Einstieg liest keine Unterhaltungen und legt
+keine Datenbank an. Normale Host-Anfragen unterliegen dessen Anmeldung,
+Berechtigungen, Aufbewahrung und Bedingungen. Installation, Laden, vollständiges
+Lesen, Anwendung und Nutzen bleiben getrennte Nachweisstufen. Allgemeine Vorteile
+bei Qualität, Kosten oder Geschwindigkeit werden nicht behauptet.
+
+Weitere Angaben: [Sprachleitfaden](docs/v1.5.2.md), [Einstellungen](docs/settings.md),
+[Einrichtung](docs/setup-guide.md) und [Sicherheitsrichtlinie](SECURITY.md).
+Die historischen [Mac](docs/macos-v1.5.md)- und [Windows](docs/windows-v1.5.md)-Leitfäden
+behalten ihre damaligen Nachweise; aktuelle Befehle stehen hier für Version 1.5.2.
+
+OpenSocrates ist ein unabhängiges Projekt unter der [MIT-Lizenz](LICENSE), ohne
+Zugehörigkeit zu oder Empfehlung durch OpenAI, Anthropic oder Google.
+[Änderungsprotokoll](CHANGELOG.md).

package/README.es.md

@@ -0,0 +1,134 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ParkerHwang/OpenSocrates/main/docs/assets/opensocrates-banner.jpg" alt="OpenSocrates" width="820">
+</p>
+
+# OpenSocrates
+
+**Ayuda para razonar y obtener resultados que puedas comprender, evaluar y utilizar.**
+
+OpenSocrates ofrece 48 métodos de razonamiento para sintetizar fuentes, comprender
+perspectivas, comparar opciones y redactar mensajes útiles. v1.5.2 añade español
+(`es`), francés, alemán, italiano, portugués y tailandés al contenido en inglés,
+coreano, chino simplificado y japonés. Las diez lenguas incluyen 480 procedimientos
+completos, 3.840 casos canónicos y 1.440 preguntas dirigidas al agente, tres por
+método e idioma. La revisión de contenido es 5: se conservan los textos y valores
+de los cuatro idiomas anteriores, pero la identidad de revisión de cada método
+pasa de 4 a 5. No se añaden métodos específicos de programación.
+
+[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** | [Português](README.pt.md) | [ไทย](README.th.md)
+
+## Aplicaciones y plataformas
+
+| Aplicación | Distribución | Plataforma y activación |
+| --- | --- | --- |
+| Codex | Hooks existentes y entorno nativo de decisión | Mac Apple Silicon y Windows x64; revisar la confianza de los 7 hooks en una sesión interactiva |
+| Claude Code CLI / Code local de Desktop | Entrada nativa sin estado y referencias completas | Mac Apple Silicon; CLI Claude, inicio de sesión y permisos de plugin/hooks |
+| Claude Web / Desktop Chat / Cowork | Skill de cuenta en ZIP sin código ejecutable | Exportación en Mac o Windows; carga y activación separadas en la cuenta |
+| Antigravity | Regla y skill modulares | Mac Apple Silicon y Windows x64; ámbito de proyecto o global |
+
+Se mantiene el alcance de plataformas de v1.5.0. Claude Code nativo en Windows
+queda fuera. Windows ARM64 y la migración a Go pertenecen al trabajo separado
+de v1.6.0. La skill de cuenta no instala una integración nativa de Claude.
+
+## Instalar o actualizar
+
+Prepara Node.js 20 o posterior e inicia sesión en la aplicación elegida.
+Los entornos nativos están incluidos; la instalación no requiere Python.
+Obtén archivos y sumas SHA-256 en la
+[versión v1.5.2](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.2).
+
+```sh
+npx --yes opensocrates@1.5.2 install --host codex
+npx --yes opensocrates@1.5.2 status --host codex
+npx --yes opensocrates@1.5.2 update --host codex
+```
+
+Para una instalación existente utiliza `update` en lugar de `install`.
+Abre `/hooks` en Codex interactivo, revisa los 7 hooks OpenSocrates y concede
+las aprobaciones necesarias mediante el mecanismo de confianza de la aplicación.
+Después inicia una conversación nueva. `status` informa de instalación e
+integridad; no demuestra aprobación de hooks ni aplicación real.
+
+En Mac Apple Silicon usa `install --host claude` para Claude Code.
+Para Antigravity elige una carpeta de trabajo existente con ruta absoluta;
+sin `--workspace` el ámbito es global. Evita copias activas duplicadas para una
+misma tarea. En Windows usa una ruta de unidad local entre comillas, por ejemplo
+`"C:\Work\Reading Workshop"`.
+
+```sh
+npx --yes opensocrates@1.5.2 install --host claude
+npx --yes opensocrates@1.5.2 install --host antigravity --workspace /absolute/path/to/workspace
+npx --yes opensocrates@1.5.2 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.2-account.zip
+```
+
+Exporta la skill de cuenta a una ruta absoluta de archivo ZIP en una carpeta
+existente y después súbela y actívala en Claude, **Customize → Skills**.
+Antes de reemplazar una skill OpenSocrates, guarda una copia y su estado de
+activación. Exportar no equivale a cargar, activar ni seleccionar automáticamente.
+Añade esta instrucción en **Settings → General → Instructions for Claude**,
+conservando las instrucciones actuales:
+
+```text
+Para solicitudes que requieran interpretación o juicio, como sintetizar
+fuentes, comparar opciones, tomar decisiones o redactar mensajes, carga la
+skill OpenSocrates activada y sigue sus instrucciones aunque no la mencione.
+Antes de aplicar un método, lee su procedimiento completo y comprueba las
+condiciones de uso. No añadas procedimientos innecesarios a tareas mecánicas
+como dar formato.
+```
+
+En interfaces antiguas de Cowork utiliza **Settings → Cowork → Global instructions**.
+Si Web y Desktop usan cuentas distintas, configura cada una y comienza una
+conversación nueva. La selección depende del modelo y puede omitirse: no añade
+hooks nativos ni uso garantizado en cada mensaje. El valor predeterminado y
+`--host all` siguen seleccionando solo Codex.
+
+## Elegir el idioma de las instrucciones
+
+La escritura latina no distingue de forma fiable el español de otros idiomas
+compatibles. Usa una preferencia explícita o guardada. Desde la raíz del paquete
+Codex instalado en Mac:
+
+```sh
+bin/launch.sh locale codex set es
+bin/launch.sh locale codex get
+bin/launch.sh locale codex reset
+```
+
+En Windows utiliza `node bin/launch.mjs locale codex set es`.
+`set follow` o `reset` borra solo la preferencia de idioma. Esta opción se aplica
+al selector conservado; las solicitudes de decisión sin estado exigen el campo
+JSON explícito `locale` y no leen ajustes. Los paquetes de cuenta o contenido
+utilizan la guía y las referencias del idioma correspondiente.
+
+El orden es: idioma explícito de confianza, preferencia guardada y caracteres
+de la entrada actual. Los kana seleccionan japonés primero; en otro caso, el
+predominio de caracteres tailandeses, hangul o han selecciona tailandés, coreano
+o chino. Los empates, entradas vacías y escrituras desconocidas usan inglés.
+El japonés sin kana es ambiguo y necesita `ja`. El portugués usa ortografía
+brasileña bajo el código genérico `pt`, sin afirmar soporte individual de todas
+las variantes. El idioma de instrucciones, respuesta, interfaz y mensajes npm
+son distintos. El instalador npm no tiene una opción `--locale`.
+
+## Atribución, privacidad y límites
+
+La línea final exacta `Powered by OpenSocrates` solo aparece tras leer por
+completo un método canónico admisible y aplicarlo realmente a la respuesta.
+La orientación de lectura por sí sola y las tareas mecánicas no cumplen esa
+condición. La atribución no prueba aplicación nativa ni resultados mejores.
+
+La ruta de decisión predeterminada no llama a un modelo selector adicional
+ni guarda prompts sin procesar, conversaciones, capturas o razonamientos ocultos.
+La entrada nativa de Claude no lee conversaciones ni crea una base de datos.
+Las solicitudes normales siguen la autenticación, permisos, conservación y
+condiciones de la aplicación. Instalación, carga, lectura completa, aplicación
+y utilidad son pruebas diferentes. No se afirman mejoras universales de
+calidad, coste o velocidad.
+
+Consulta la [guía de idiomas](docs/v1.5.2.md), los [ajustes](docs/settings.md),
+la [configuración visual](docs/setup-guide.md) y la [política de seguridad](SECURITY.md).
+Las guías de [Mac](docs/macos-v1.5.md) y [Windows](docs/windows-v1.5.md) conservan
+sus observaciones históricas; usa aquí los comandos actuales de 1.5.2.
+
+OpenSocrates es independiente y usa la [licencia MIT](LICENSE). No está afiliado
+a OpenAI, Anthropic o Google ni cuenta con su respaldo. [Cambios](CHANGELOG.md).

package/README.fr.md

@@ -0,0 +1,135 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ParkerHwang/OpenSocrates/main/docs/assets/opensocrates-banner.jpg" alt="OpenSocrates" width="820">
+</p>
+
+# OpenSocrates
+
+**Une aide au raisonnement pour des résultats que vous pouvez comprendre, évaluer et utiliser.**
+
+OpenSocrates propose 48 méthodes de raisonnement pour synthétiser des sources,
+comprendre les points de vue, comparer des choix et rédiger des messages utiles.
+La version 1.5.2 ajoute le français (`fr`), l’allemand, l’italien, l’espagnol,
+le portugais et le thaï aux contenus anglais, coréen, chinois simplifié et japonais.
+Les dix langues comprennent 480 procédures complètes, 3 840 cas canoniques et
+1 440 questions adressées à l’agent, soit trois par méthode et par langue.
+La révision de contenu passe à 5 : les textes et valeurs des quatre langues
+existantes sont conservés, mais l’identité de révision de chaque méthode passe
+de 4 à 5. Aucune méthode spécialisée de programmation n’est ajoutée.
+
+[English](README.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | **Français** | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Español](README.es.md) | [Português](README.pt.md) | [ไทย](README.th.md)
+
+## Applications et plateformes
+
+| Application | Mode de livraison | Plateforme et activation |
+| --- | --- | --- |
+| Codex | Hooks existants et moteur natif de décision | Mac Apple Silicon et Windows x64 ; vérifier la confiance des 7 hooks en session interactive |
+| Claude Code CLI / Code local de Desktop | Entrée native sans état et références complètes | Mac Apple Silicon ; CLI Claude, connexion et autorisations du plugin/hooks |
+| Claude Web / Desktop Chat / Cowork | ZIP de compétence de compte sans code exécutable | Export sur Mac ou Windows, puis téléversement et activation séparés dans le compte |
+| Antigravity | Règle et compétence modulaires | Mac Apple Silicon et Windows x64 ; portée projet ou globale |
+
+Le périmètre de plateformes reste celui de v1.5.0. Claude Code natif sous
+Windows n’est pas inclus. Windows ARM64 et la migration Go relèvent du travail
+séparé de v1.6.0. Une compétence de compte n’installe pas une intégration native.
+
+## Installer ou mettre à jour
+
+Installez Node.js 20 ou ultérieur et connectez-vous à l’application choisie.
+Les moteurs natifs sont fournis : Python n’est pas requis pour l’installation.
+Les archives et sommes SHA-256 sont disponibles sur la
+[page v1.5.2](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.2).
+
+```sh
+npx --yes opensocrates@1.5.2 install --host codex
+npx --yes opensocrates@1.5.2 status --host codex
+npx --yes opensocrates@1.5.2 update --host codex
+```
+
+Pour une installation existante, utilisez `update` plutôt que `install`.
+Dans Codex interactif, ouvrez `/hooks`, examinez les 7 hooks OpenSocrates et
+accordez les approbations nécessaires par le mécanisme de confiance de l’hôte.
+Commencez ensuite une nouvelle conversation. `status` vérifie l’installation
+et l’intégrité, sans prouver l’approbation des hooks ni l’application réelle.
+
+Sur Mac Apple Silicon, utilisez `install --host claude` pour Claude Code.
+Pour Antigravity, choisissez un répertoire existant avec un chemin absolu ;
+sans `--workspace`, la portée est globale. Évitez deux installations actives
+pour le même travail. Sous Windows, utilisez un chemin de lecteur local entre
+guillemets, par exemple `"C:\Work\Reading Workshop"`.
+
+```sh
+npx --yes opensocrates@1.5.2 install --host claude
+npx --yes opensocrates@1.5.2 install --host antigravity --workspace /absolute/path/to/workspace
+npx --yes opensocrates@1.5.2 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.2-account.zip
+```
+
+Exportez la compétence de compte vers un fichier ZIP absolu dans un dossier
+existant, puis téléversez-la et activez-la dans Claude, **Customize → Skills**.
+Avant de remplacer une compétence OpenSocrates, sauvegardez son ZIP et son état
+d’activation. L’export ne constitue ni téléversement, ni activation, ni preuve
+de sélection automatique. Ajoutez cette consigne à **Settings → General →
+Instructions for Claude**, sans effacer vos consignes existantes :
+
+```text
+Pour les demandes qui nécessitent une interprétation ou un jugement, comme
+la synthèse de sources, la comparaison d’options, une décision ou la rédaction
+d’un message, chargez la compétence OpenSocrates activée et suivez ses consignes,
+même si je ne la nomme pas. Lisez la procédure complète et vérifiez ses conditions
+d’application avant d’utiliser une méthode. N’ajoutez pas de procédure inutile
+aux tâches mécaniques comme la mise en forme.
+```
+
+Dans les anciennes interfaces Cowork, utilisez **Settings → Cowork → Global
+instructions**. Configurez chaque compte utilisé si Web et Desktop diffèrent,
+puis ouvrez une nouvelle conversation. La sélection dépend du modèle et peut
+être omise ; aucun hook natif ni usage garanti à chaque message n’est ajouté.
+La valeur par défaut et `--host all` sélectionnent uniquement Codex.
+
+## Choisir la langue des instructions
+
+Le français partage l’alphabet latin avec plusieurs langues : il faut une
+préférence explicite ou enregistrée, et non une détection supposée du français.
+À la racine du paquet Codex installé sur Mac, définissez la préférence :
+
+```sh
+bin/launch.sh locale codex set fr
+bin/launch.sh locale codex get
+bin/launch.sh locale codex reset
+```
+
+Sous Windows, utilisez `node bin/launch.mjs locale codex set fr`.
+`set follow` ou `reset` efface la préférence de langue sans effacer les autres
+réglages. Cette préférence concerne le sélecteur conservé. Les requêtes de décision
+sans état exigent leur champ JSON `locale`; elles ne lisent pas les réglages.
+Les paquets de compte/contenu utilisent le guide et les références de la langue.
+
+Ordre de choix : langue explicite fiable, préférence enregistrée, puis caractères
+de l’entrée actuelle. Les kana donnent priorité au japonais ; sinon les caractères
+thaïs, hangul ou han dominants sélectionnent le thaï, le coréen ou le chinois.
+Les égalités, entrées vides et écritures inconnues reviennent à l’anglais. Le japonais
+sans kana est ambigu et nécessite `ja`. Le portugais utilise le code générique `pt`
+et l’orthographe brésilienne, sans prise en charge distincte de toutes les variantes.
+La langue des instructions est distincte de celle de la réponse, de l’interface
+et des messages de l’installateur npm. Il n’existe pas d’option npm `--locale`.
+
+## Attribution, confidentialité et limites
+
+La ligne finale exacte `Powered by OpenSocrates` n’apparaît que si une méthode
+canonique admissible a été lue entièrement et réellement appliquée à la réponse.
+Une simple aide à la lecture ou une tâche mécanique ne suffit pas. L’attribution
+ne prouve ni l’application native ni une amélioration de la qualité.
+
+Le chemin de décision par défaut ne fait aucun appel supplémentaire à un modèle
+de sélection et ne stocke ni prompts bruts, conversations, captures d’écran, ni
+raisonnement caché. L’entrée native Claude ne lit pas de conversations et ne crée
+pas de base de données. Les comptes et conversations restent régis par les règles
+de l’hôte. Installation, chargement, lecture complète, application et utilité sont
+des niveaux de preuve distincts ; aucun gain universel de qualité, coût ou vitesse
+n’est revendiqué.
+
+Consultez le [guide linguistique](docs/v1.5.2.md), les [réglages](docs/settings.md),
+le [guide visuel](docs/setup-guide.md) et la [politique de sécurité](SECURITY.md).
+Les guides [Mac](docs/macos-v1.5.md) et [Windows](docs/windows-v1.5.md) conservent
+leurs observations historiques ; utilisez ici les commandes 1.5.2.
+
+OpenSocrates est un projet indépendant sous [licence MIT](LICENSE), sans affiliation
+ni approbation d’OpenAI, Anthropic ou Google. [Historique des versions](CHANGELOG.md).

package/README.it.md

@@ -0,0 +1,134 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ParkerHwang/OpenSocrates/main/docs/assets/opensocrates-banner.jpg" alt="OpenSocrates" width="820">
+</p>
+
+# OpenSocrates
+
+**Un aiuto al ragionamento per risultati che puoi comprendere, valutare e usare.**
+
+OpenSocrates offre 48 metodi di ragionamento per sintetizzare fonti, comprendere
+punti di vista, confrontare opzioni e scrivere messaggi utili. La versione 1.5.2
+aggiunge italiano (`it`), francese, tedesco, spagnolo, portoghese e thailandese
+ai contenuti inglesi, coreani, cinesi semplificati e giapponesi. Le dieci lingue
+comprendono 480 procedure complete, 3.840 casi canonici e 1.440 domande rivolte
+all’agente, tre per metodo e lingua. La revisione dei contenuti passa a 5:
+testi e valori delle quattro lingue precedenti restano invariati, mentre
+l’identificatore di revisione di ciascun metodo passa da 4 a 5. Questa versione
+non aggiunge metodi dedicati alla programmazione.
+
+[English](README.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | **Italiano** | [Español](README.es.md) | [Português](README.pt.md) | [ไทย](README.th.md)
+
+## Applicazioni e piattaforme
+
+| Applicazione | Distribuzione | Piattaforma e attivazione |
+| --- | --- | --- |
+| Codex | Hook esistenti e runtime nativo di decisione | Mac Apple Silicon e Windows x64; verificare l’attendibilità dei 7 hook in una sessione interattiva |
+| Claude Code CLI / Code locale di Desktop | Ingresso nativo senza stato e riferimenti completi | Mac Apple Silicon; CLI Claude, accesso e autorizzazioni per plugin e hook |
+| Claude Web / Desktop Chat / Cowork | Skill di account in ZIP senza codice eseguibile | Esportazione su Mac o Windows; caricamento e attivazione separati nell’account |
+| Antigravity | Regola e skill modulari | Mac Apple Silicon e Windows x64; ambito di progetto o globale |
+
+Le piattaforme rimangono quelle di v1.5.0. Claude Code nativo su Windows è escluso.
+Windows ARM64 e la migrazione a Go appartengono al lavoro separato per v1.6.0.
+La skill di account non installa un’integrazione nativa Claude.
+
+## Installazione o aggiornamento
+
+Prepara Node.js 20 o successivo e accedi all’applicazione scelta. I runtime
+nativi sono inclusi e l’installazione non richiede Python. Archivi e file SHA-256
+sono disponibili nella [release v1.5.2](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.2).
+
+```sh
+npx --yes opensocrates@1.5.2 install --host codex
+npx --yes opensocrates@1.5.2 status --host codex
+npx --yes opensocrates@1.5.2 update --host codex
+```
+
+Per un’installazione già presente usa `update` invece di `install`.
+Apri `/hooks` in Codex interattivo, esamina i 7 hook OpenSocrates e concedi le
+approvazioni necessarie attraverso il meccanismo di attendibilità dell’host.
+Avvia poi una nuova conversazione. `status` descrive installazione e integrità,
+non dimostra l’approvazione degli hook o l’applicazione effettiva.
+
+Su Mac Apple Silicon usa `install --host claude` per Claude Code.
+Per Antigravity scegli una cartella di lavoro esistente con percorso assoluto;
+senza `--workspace` l’ambito è globale. Evita copie attive duplicate per lo
+stesso lavoro. Su Windows usa un percorso di unità locale tra virgolette,
+per esempio `"C:\Work\Reading Workshop"`.
+
+```sh
+npx --yes opensocrates@1.5.2 install --host claude
+npx --yes opensocrates@1.5.2 install --host antigravity --workspace /absolute/path/to/workspace
+npx --yes opensocrates@1.5.2 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.2-account.zip
+```
+
+Esporta la skill di account in un file ZIP con percorso assoluto in una cartella
+esistente, poi caricala e attivala in Claude, **Customize → Skills**. Prima di
+sostituire una skill OpenSocrates, salva una copia del file e del suo stato di
+attivazione. L’esportazione non dimostra caricamento, attivazione o selezione
+automatica. Aggiungi questa istruzione in **Settings → General → Instructions for
+Claude**, conservando quelle già presenti:
+
+```text
+Per richieste che richiedono interpretazione o giudizio, come sintetizzare
+fonti, confrontare opzioni, prendere decisioni o scrivere messaggi, carica la
+skill OpenSocrates attivata e segui le sue istruzioni anche se non la nomino.
+Prima di applicare un metodo, leggi la procedura completa e verifica le condizioni
+di applicabilità. Non aggiungere procedure inutili a lavori meccanici come
+la formattazione.
+```
+
+Nelle vecchie interfacce Cowork usa **Settings → Cowork → Global instructions**.
+Se Web e Desktop usano account diversi, configura ciascuno e avvia una nuova
+conversazione. La scelta dipende dal modello e può essere omessa: non introduce
+hook nativi o uso garantito a ogni messaggio. Il valore predefinito e `--host all`
+continuano a selezionare solo Codex.
+
+## Scegliere la lingua delle istruzioni
+
+L’alfabeto latino non identifica in modo affidabile l’italiano rispetto alle
+altre lingue supportate. Usa quindi una preferenza esplicita o salvata. Dalla
+cartella principale del pacchetto Codex installato su Mac:
+
+```sh
+bin/launch.sh locale codex set it
+bin/launch.sh locale codex get
+bin/launch.sh locale codex reset
+```
+
+Su Windows usa `node bin/launch.mjs locale codex set it`.
+`set follow` o `reset` elimina solo la preferenza di lingua. La preferenza riguarda
+il selettore mantenuto; le richieste di decisione senza stato richiedono il campo
+JSON esplicito `locale` e non leggono le impostazioni. I pacchetti di account o
+contenuto usano la guida e i riferimenti della lingua corrispondente.
+
+L’ordine è: lingua esplicita attendibile, preferenza salvata, poi caratteri
+dell’input corrente. I kana selezionano prima il giapponese; altrimenti i caratteri
+thailandesi, hangul o han dominanti selezionano thailandese, coreano o cinese.
+Parità, input vuoto e scritture sconosciute tornano all’inglese. Il giapponese
+senza kana è ambiguo e richiede `ja`. Il portoghese usa l’ortografia brasiliana
+con il codice generico `pt`, senza dichiarare supporto distinto per ogni variante.
+Lingua delle istruzioni, risposta, interfaccia e messaggi npm sono separate.
+L’installatore npm non ha un’opzione `--locale`.
+
+## Attribuzione, riservatezza e limiti
+
+La riga finale esatta `Powered by OpenSocrates` compare solo dopo la lettura
+integrale e l’applicazione effettiva di un metodo canonico idoneo alla risposta.
+La sola guida alla lettura e le attività meccaniche non bastano. L’attribuzione
+non prova applicazione nativa o risultati migliori.
+
+Il percorso di decisione predefinito non chiama un modello di selezione aggiuntivo
+e non conserva prompt grezzi, conversazioni, schermate o ragionamenti nascosti.
+L’ingresso nativo Claude non legge conversazioni e non inizializza database.
+Le normali richieste seguono autenticazione, autorizzazioni, conservazione e
+condizioni dell’host. Installazione, caricamento, lettura completa, applicazione
+e utilità restano prove distinte. Non si affermano miglioramenti universali
+di qualità, costo o velocità.
+
+Consulta [lingue e ambito](docs/v1.5.2.md), [impostazioni](docs/settings.md),
+[guida alla configurazione](docs/setup-guide.md) e [sicurezza](SECURITY.md).
+Le guide [Mac](docs/macos-v1.5.md) e [Windows](docs/windows-v1.5.md) conservano le
+osservazioni storiche; usa qui i comandi attuali per 1.5.2.
+
+OpenSocrates è indipendente, con [licenza MIT](LICENSE), e non è affiliato né
+approvato da OpenAI, Anthropic o Google. [Registro delle modifiche](CHANGELOG.md).