oh-my-codex 0.11.11 → 0.11.12

package/Cargo.lock

@@ -32,11 +32,11 @@ checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
 
 [[package]]
 name = "omx-explore-harness"
-version = "0.11.11"
+version = "0.11.12"
 
 [[package]]
 name = "omx-mux"
-version = "0.11.11"
+version = "0.11.12"
 dependencies = [
  "serde",
  "serde_json",
@@ -44,7 +44,7 @@ dependencies = [
 
 [[package]]
 name = "omx-runtime"
-version = "0.11.11"
+version = "0.11.12"
 dependencies = [
  "omx-mux",
  "omx-runtime-core",
@@ -53,7 +53,7 @@ dependencies = [
 
 [[package]]
 name = "omx-runtime-core"
-version = "0.11.11"
+version = "0.11.12"
 dependencies = [
  "fs2",
  "serde",
@@ -62,7 +62,7 @@ dependencies = [
 
 [[package]]
 name = "omx-sparkshell"
-version = "0.11.11"
+version = "0.11.12"
 dependencies = [
  "omx-mux",
 ]

package/Cargo.toml

@@ -10,7 +10,7 @@ resolver = "2"
 
 [workspace.package]
 
-version = "0.11.11"
+version = "0.11.12"
 
 edition = "2021"
 license = "MIT"

package/README.de.md

@@ -30,10 +30,10 @@ Siehe auch die [Release Notes zu v0.9.0](./docs/release-notes-0.9.0.md) und den
 Innerhalb von Codex:
 
 ```text
-$architect "analyze current auth boundaries"
-$executor "implement input validation in login"
-$plan "ship OAuth callback safely"
-$team 3:executor "fix all TypeScript errors"
+$deep-interview "clarify the auth change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 Vom Terminal:
@@ -44,6 +44,12 @@ omx team status <team-name>
 omx team shutdown <team-name>
 ```
 
+## Empfohlener Workflow
+
+1. `$deep-interview` — wenn Scope oder Grenzen noch unklar sind.
+2. `$ralplan` — um daraus einen abgestimmten Architektur- und Umsetzungsplan zu machen.
+3. `$team` oder `$ralph` — nutzen Sie `$team` für koordinierte parallele Ausführung oder `$ralph` für einen hartnäckigen Abschluss-/Verifikations-Loop mit einer verantwortlichen Instanz.
+
 ## Kernmodell
 
 OMX installiert und verbindet diese Schichten:
@@ -155,7 +161,7 @@ Wichtige Regel: Fahren Sie nicht herunter, während Aufgaben noch `in_progress`
 ### Team shutdown policy
 
 Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; there is no separate `omx team ralph ...` shutdown policy anymore.
+Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
 
 Worker-CLI-Auswahl für Team-Worker:
 
@@ -199,7 +205,7 @@ Hinweise:
 
 Beispiele:
 - Agenten: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
-- Skills: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+- Skills: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `cancel`
 
 ## Projektstruktur
 

package/README.el.md

@@ -0,0 +1,223 @@
+# oh-my-codex (OMX)
+
+<p align="center">
+  <img src="https://yeachan-heo.github.io/oh-my-codex-website/omx-character-nobg.png" alt="oh-my-codex character" width="280">
+  <br>
+  <em>Ξεκινήστε το Codex πιο δυναμικά και αφήστε το OMX να προσθέσει καλύτερα prompts, workflows και runtime υποστήριξη όταν η δουλειά μεγαλώνει.</em>
+</p>
+
+[![npm version](https://img.shields.io/npm/v/oh-my-codex)](https://www.npmjs.com/package/oh-my-codex)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
+[![Discord](https://img.shields.io/discord/1452487457085063218?color=5865F2&logo=discord&logoColor=white&label=Discord)](https://discord.gg/PUwSMR9XNk)
+
+**Ιστοσελίδα:** https://yeachan-heo.github.io/oh-my-codex-website/  
+**Τεκμηρίωση:** [Ξεκινώντας](./docs/getting-started.html) · [Agents](./docs/agents.html) · [Skills](./docs/skills.html) · [Ενσωματώσεις](./docs/integrations.html) · [Demo](./DEMO.md) · [Οδηγός OpenClaw](./docs/openclaw-integration.md)
+
+Το OMX είναι ένα workflow layer για το [OpenAI Codex CLI](https://github.com/openai/codex).
+
+Διατηρεί το Codex ως μηχανή εκτέλεσης και διευκολύνει τα εξής:
+- να ξεκινάτε μια πιο δυναμική συνεδρία Codex από προεπιλογή
+- να ακολουθείτε μία συνεπή ροή από διευκρίνιση μέχρι ολοκλήρωση
+- να ενεργοποιείτε το βασικό μονοπάτι με `$deep-interview`, `$ralplan`, `$team` και `$ralph`
+- να κρατάτε οδηγίες έργου, σχέδια, αρχεία καταγραφής και κατάσταση στον φάκελο `.omx/`
+
+## Προτεινόμενη προεπιλεγμένη ροή
+
+Αν θέλετε την προεπιλεγμένη εμπειρία OMX, ξεκινήστε εδώ:
+
+```bash
+npm install -g @openai/codex oh-my-codex
+omx setup
+omx --madmax --high
+```
+
+Στη συνέχεια εργαστείτε κανονικά μέσα στο Codex:
+
+```text
+$deep-interview "clarify the authentication change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
+```
+
+Αυτή είναι η βασική ροή.
+Ξεκινήστε δυνατά, ξεκαθαρίστε πρώτα όταν χρειάζεται, εγκρίνετε το σχέδιο και μετά επιλέξτε `$team` για συντονισμένη παράλληλη εκτέλεση ή `$ralph` για επίμονο βρόχο ολοκλήρωσης.
+
+## Σε τι χρησιμεύει το OMX
+
+Χρησιμοποιήστε το OMX αν σας αρέσει ήδη το Codex και θέλετε ένα καλύτερο καθημερινό περιβάλλον εργασίας γύρω του:
+- μια τυπική ροή βασισμένη στα `$deep-interview`, `$ralplan`, `$team` και `$ralph`
+- εξειδικευμένους ρόλους και βοηθητικά skills όταν πραγματικά χρειάζονται
+- καθοδήγηση έργου μέσω scoped `AGENTS.md`
+- επίμονη κατάσταση στον `.omx/` για σχέδια, αρχεία καταγραφής, μνήμη και παρακολούθηση λειτουργίας
+
+Αν θέλετε απλό Codex χωρίς επιπλέον επίπεδο ροής εργασίας, πιθανότατα δεν χρειάζεστε το OMX.
+
+## Γρήγορη εκκίνηση
+
+### Απαιτήσεις
+
+- Node.js 20+
+- Εγκατεστημένο Codex CLI: `npm install -g @openai/codex`
+- Ρυθμισμένη αυθεντικοποίηση Codex
+- `tmux` σε macOS/Linux αν θέλετε αργότερα τον ανθεκτικό team runtime
+- `psmux` σε native Windows αν θέλετε αργότερα τη λειτουργία team για Windows
+
+### Μια καλή πρώτη συνεδρία
+
+Εκκινήστε το OMX με τον προτεινόμενο τρόπο:
+
+```bash
+omx --madmax --high
+```
+
+Στη συνέχεια δοκιμάστε την τυπική ροή:
+
+```text
+$deep-interview "clarify the authentication change"
+$ralplan "approve the safest implementation path"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
+```
+
+Χρησιμοποιήστε `$team` όταν το εγκεκριμένο σχέδιο χρειάζεται συντονισμένη παράλληλη εργασία ή `$ralph` όταν ένας επίμονος υπεύθυνος πρέπει να το φέρει μέχρι τέλους.
+
+## Ένα απλό νοητικό μοντέλο
+
+Το OMX **δεν** αντικαθιστά το Codex.
+
+Προσθέτει ένα καλύτερο workflow layer γύρω του:
+- **Codex** κάνει την πραγματική δουλειά του agent
+- **Keywords ρόλων OMX** κάνουν τους χρήσιμους ρόλους επαναχρησιμοποιήσιμους
+- **Skills OMX** κάνουν τα συνηθισμένα workflows επαναχρησιμοποιήσιμα
+- **`.omx/`** αποθηκεύει σχέδια, αρχεία καταγραφής, μνήμη και κατάσταση εκτέλεσης
+
+Οι περισσότεροι χρήστες καλό είναι να βλέπουν το OMX ως **καλύτερη δρομολόγηση εργασιών + καλύτερο workflow + καλύτερο runtime**, όχι ως ένα σύνολο εντολών για χειροκίνητη χρήση όλη μέρα.
+
+## Ξεκινήστε εδώ αν είστε νέοι
+
+1. Εκτελέστε `omx setup`
+2. Εκκινήστε με `omx --madmax --high`
+3. Χρησιμοποιήστε `$deep-interview "..."` όταν το αίτημα ή τα όρια είναι ακόμη ασαφή
+4. Χρησιμοποιήστε `$ralplan "..."` για να εγκρίνετε το σχέδιο και τους συμβιβασμούς
+5. Επιλέξτε `$team` για συντονισμένη παράλληλη εκτέλεση ή `$ralph` για επίμονο βρόχο ολοκλήρωσης
+
+## Συνήθη surfaces μέσα στη συνεδρία
+
+| Λειτουργία | Χρήση |
+| --- | --- |
+| `$deep-interview "..."` | αποσαφήνιση πρόθεσης, ορίων και μη-στόχων |
+| `$ralplan "..."` | έγκριση σχεδίου υλοποίησης και συμβιβασμών |
+| `$ralph "..."` | επίμονος βρόχος ολοκλήρωσης και επαλήθευσης |
+| `$team "..."` | συντονισμένη παράλληλη εκτέλεση όταν η εργασία είναι αρκετά μεγάλη |
+| `/skills` | περιήγηση στα διαθέσιμα skills και βοηθητικά εργαλεία |
+
+Χρησιμοποιήστε `$deep-interview` όταν το αίτημα είναι ακόμη ασαφές, τα όρια δεν είναι ξεκάθαρα ή θέλετε το OMX να πιέσει μέχρι να ξεκαθαρίσει πρόθεση, μη-στόχους και όρια αποφάσεων πριν περάσει στο `$ralplan` και έπειτα στο `$team` ή στο `$ralph`.
+
+Τυπικές περιπτώσεις:
+- ασαφείς greenfield ιδέες που χρειάζονται πιο καθαρή πρόθεση και εύρος
+- brownfield αλλαγές όπου το OMX πρέπει πρώτα να εξετάσει το repo και μετά να κάνει στοχευμένες ερωτήσεις επιβεβαίωσης
+- αιτήματα όπου θέλετε έναν βρόχο διευκρίνισης μία-ερώτηση-τη-φορά αντί για άμεσο σχεδιασμό ή υλοποίηση
+
+## Προχωρημένες λειτουργίες / για διαχειριστές
+
+Αυτά είναι χρήσιμα, αλλά δεν είναι ο βασικός τρόπος για να ξεκινήσετε.
+
+### Team runtime
+
+Χρησιμοποιήστε τον team runtime όταν χρειάζεστε ειδικά ανθεκτικό συντονισμό tmux/worktree, όχι ως τον προεπιλεγμένο τρόπο για να ξεκινήσετε με το OMX.
+
+```bash
+omx team 3:executor "fix the failing tests with verification"
+omx team status <team-name>
+omx team resume <team-name>
+omx team shutdown <team-name>
+```
+
+### Setup, doctor και HUD
+
+Αυτές είναι λειτουργίες διαχείρισης/υποστήριξης:
+- `omx setup` εγκαθιστά prompts, skills, ρυθμίσεις και scaffolding AGENTS
+- `omx doctor` επαληθεύει την εγκατάσταση όταν κάτι φαίνεται λάθος
+- `omx hud --watch` είναι λειτουργία παρακολούθησης/κατάστασης, όχι η κύρια ροή εργασίας του χρήστη
+
+### Explore και sparkshell
+
+- `omx explore --prompt "..."` είναι για αναζήτηση μόνο ανάγνωσης στο repository
+- `omx sparkshell <command>` είναι για επιθεώρηση απευθείας από το shell και στοχευμένη επαλήθευση
+
+Παραδείγματα:
+
+```bash
+omx explore --prompt "find where team state is written"
+omx sparkshell git status
+omx sparkshell --tmux-pane %12 --tail-lines 400
+```
+
+### Σημειώσεις πλατφόρμας για τη λειτουργία team
+
+Η `omx team` χρειάζεται ένα tmux-συμβατό backend:
+
+| Πλατφόρμα | Εγκατάσταση |
+| --- | --- |
+| macOS | `brew install tmux` |
+| Ubuntu/Debian | `sudo apt install tmux` |
+| Fedora | `sudo dnf install tmux` |
+| Arch | `sudo pacman -S tmux` |
+| Windows | `winget install psmux` |
+| Windows (WSL2) | `sudo apt install tmux` |
+
+## Γνωστά ζητήματα
+
+### Mac με Intel: υψηλή χρήση CPU `syspolicyd` / `trustd` κατά την εκκίνηση
+
+Σε ορισμένα Mac με Intel, η εκκίνηση του OMX, ειδικά με `--madmax --high`, μπορεί να αυξήσει απότομα τη χρήση CPU των `syspolicyd` / `trustd` ενώ το macOS Gatekeeper επαληθεύει πολλές ταυτόχρονες εκκινήσεις διεργασιών.
+
+Αν συμβεί αυτό, δοκιμάστε:
+- `xattr -dr com.apple.quarantine $(which omx)`
+- προσθέστε την εφαρμογή τερματικού σας στη λίστα επιτρεπόμενων Developer Tools στις ρυθμίσεις Ασφάλειας του macOS
+- χρησιμοποιήστε χαμηλότερο επίπεδο ταυτόχρονων εκτελέσεων (για παράδειγμα, αποφύγετε `--madmax --high`)
+
+## Τεκμηρίωση
+
+- [Ξεκινώντας](./docs/getting-started.html)
+- [Οδηγός Demo](./DEMO.md)
+- [Κατάλογος Agents](./docs/agents.html)
+- [Αναφορά Skills](./docs/skills.html)
+- [Ενσωματώσεις](./docs/integrations.html)
+- [Οδηγός OpenClaw / notification gateway](./docs/openclaw-integration.md)
+- [Συνεισφορά](./CONTRIBUTING.md)
+- [Αρχείο αλλαγών](./CHANGELOG.md)
+
+## Γλώσσες
+
+- [English](./README.md)
+- [한국어](./README.ko.md)
+- [日本語](./README.ja.md)
+- [简体中文](./README.zh.md)
+- [繁體中文](./README.zh-TW.md)
+- [Tiếng Việt](./README.vi.md)
+- [Español](./README.es.md)
+- [Português](./README.pt.md)
+- [Русский](./README.ru.md)
+- [Türkçe](./README.tr.md)
+- [Deutsch](./README.de.md)
+- [Français](./README.fr.md)
+- [Italiano](./README.it.md)
+- [Ελληνικά](./README.el.md)
+
+## Συνεισφέροντες
+
+| Ρόλος | Όνομα | GitHub |
+| --- | --- | --- |
+| Δημιουργός & Επικεφαλής | Yeachan Heo | [@Yeachan-Heo](https://github.com/Yeachan-Heo) |
+| Συντηρητής | HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) |
+
+## Ιστορικό Αστεριών
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Yeachan-Heo/oh-my-codex&type=date&legend=top-left)](https://www.star-history.com/#Yeachan-Heo/oh-my-codex&type=date&legend=top-left)
+
+## Άδεια
+
+MIT

package/README.es.md

@@ -30,10 +30,10 @@ Consulta también las [notas de lanzamiento v0.9.0](./docs/release-notes-0.9.0.m
 Dentro de Codex:
 
 ```text
-/prompts:architect "analyze current auth boundaries"
-/prompts:executor "implement input validation in login"
-$plan "ship OAuth callback safely"
-$team 3:executor "fix all TypeScript errors"
+$deep-interview "clarify the auth change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 Desde la terminal:
@@ -44,6 +44,12 @@ omx team status <team-name>
 omx team shutdown <team-name>
 ```
 
+## Flujo recomendado
+
+1. `$deep-interview` — cuando el alcance o los límites aún no están claros.
+2. `$ralplan` — para convertir ese alcance aclarado en un plan acordado de arquitectura e implementación.
+3. `$team` o `$ralph` — usa `$team` para ejecución paralela coordinada, o `$ralph` para un bucle persistente de finalización/verificación con un solo responsable.
+
 ## Modelo central
 
 OMX instala y conecta estas capas:
@@ -155,7 +161,7 @@ Regla importante: no apagues mientras las tareas estén en estado `in_progress`
 ### Team shutdown policy
 
 Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; there is no separate `omx team ralph ...` shutdown policy anymore.
+Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
 
 Selección de Worker CLI para los workers del equipo:
 
@@ -199,7 +205,7 @@ Notas:
 
 Ejemplos:
 - Agentes: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
-- Skills: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+- Skills: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `cancel`
 
 ## Estructura del proyecto
 

package/README.fr.md

@@ -30,10 +30,10 @@ Voir aussi les [notes de version v0.9.0](./docs/release-notes-0.9.0.md) et le [c
 Dans Codex :
 
 ```text
-/prompts:architect "analyze current auth boundaries"
-/prompts:executor "implement input validation in login"
-$plan "ship OAuth callback safely"
-$team 3:executor "fix all TypeScript errors"
+$deep-interview "clarify the auth change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 Depuis le terminal :
@@ -44,6 +44,12 @@ omx team status <team-name>
 omx team shutdown <team-name>
 ```
 
+## Flux recommandé
+
+1. `$deep-interview` — quand le périmètre ou les limites restent flous.
+2. `$ralplan` — pour transformer ce périmètre clarifié en plan validé d’architecture et d’implémentation.
+3. `$team` ou `$ralph` — utilisez `$team` pour une exécution parallèle coordonnée, ou `$ralph` pour une boucle persistante de finalisation/vérification avec un seul responsable.
+
 ## Modèle de base
 
 OMX installe et connecte ces couches :
@@ -155,7 +161,7 @@ Règle importante : n'arrêtez pas tant que des tâches sont encore `in_progress
 ### Team shutdown policy
 
 Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; there is no separate `omx team ralph ...` shutdown policy anymore.
+Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
 
 Sélection du CLI worker pour les workers d'équipe :
 

package/README.it.md

@@ -30,10 +30,10 @@ Vedi anche le [note di rilascio v0.9.0](./docs/release-notes-0.9.0.md) e il [tes
 All'interno di Codex:
 
 ```text
-/prompts:architect "analyze current auth boundaries"
-/prompts:executor "implement input validation in login"
-$plan "ship OAuth callback safely"
-$team 3:executor "fix all TypeScript errors"
+$deep-interview "clarify the auth change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 Dal terminale:
@@ -44,6 +44,12 @@ omx team status <team-name>
 omx team shutdown <team-name>
 ```
 
+## Flusso consigliato
+
+1. `$deep-interview` — quando ambito o confini non sono ancora chiari.
+2. `$ralplan` — per trasformare l’ambito chiarito in un piano approvato di architettura e implementazione.
+3. `$team` o `$ralph` — usa `$team` per l’esecuzione parallela coordinata, oppure `$ralph` per un loop persistente di completamento/verifica con un solo responsabile.
+
 ## Modello di base
 
 OMX installa e collega questi livelli:
@@ -155,7 +161,7 @@ Regola importante: non arrestare mentre i task sono ancora `in_progress`, a meno
 ### Team shutdown policy
 
 Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; there is no separate `omx team ralph ...` shutdown policy anymore.
+Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
 
 Selezione CLI worker per i worker del team:
 
@@ -199,7 +205,7 @@ Note:
 
 Esempi:
 - Agenti: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
-- Skill: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+- Skill: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `cancel`
 
 ## Struttura del progetto
 

package/README.ja.md

@@ -31,10 +31,10 @@ Spark Initiative は、OMX のネイティブ探索・検査経路を強化す
 Codex内部で：
 
 ```text
-$architect "analyze current auth boundaries"
-$executor "implement input validation in login"
-$plan "ship OAuth callback safely"
-$team 3:executor "fix all TypeScript errors"
+$deep-interview "clarify the auth change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 ターミナルから：
@@ -45,6 +45,12 @@ omx team status <team-name>
 omx team shutdown <team-name>
 ```
 
+## 推奨ワークフロー
+
+1. `$deep-interview` — スコープや境界がまだ曖昧なときに明確化するために使います。
+2. `$ralplan` — 明確になった内容を、承認可能なアーキテクチャ/実装計画に落とし込みます。
+3. `$team` または `$ralph` — 承認済みプランを並列で進めるなら `$team`、1 人の担当者が完了と検証まで粘り強く進めるなら `$ralph` を使います。
+
 ## コアモデル
 
 OMXは以下のレイヤーをインストールして接続します：
@@ -156,7 +162,7 @@ omx team shutdown <team-name>
 ### Team shutdown policy
 
 Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; there is no separate `omx team ralph ...` shutdown policy anymore.
+Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
 
 チームワーカー用のWorker CLI選択：
 
@@ -200,7 +206,7 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # オプション：適応型queue->resendフ
 
 例：
 - エージェント：`architect`、`planner`、`executor`、`debugger`、`verifier`、`security-reviewer`
-- スキル：`autopilot`、`plan`、`team`、`ralph`、`ultrawork`、`cancel`
+- スキル：`deep-interview`、`ralplan`、`team`、`ralph`、`plan`、`cancel`
 
 ## プロジェクト構成
 

package/README.ko.md

@@ -31,10 +31,10 @@ Spark Initiative는 OMX의 네이티브 탐색/검사 경로를 강화한 릴리
 Codex 내부에서:
 
 ```text
-$architect "analyze current auth boundaries"
-$executor "implement input validation in login"
-$plan "ship OAuth callback safely"
-$team 3:executor "fix all TypeScript errors"
+$deep-interview "clarify the auth change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 터미널에서:
@@ -45,6 +45,12 @@ omx team status <team-name>
 omx team shutdown <team-name>
 ```
 
+## 권장 워크플로
+
+1. `$deep-interview` — 범위나 경계가 아직 모호할 때 먼저 명확히 합니다.
+2. `$ralplan` — 정리된 범위를 승인 가능한 아키텍처 및 구현 계획으로 바꿉니다.
+3. `$team` 또는 `$ralph` — 승인된 계획을 병렬로 조율해 실행하려면 `$team`, 한 명의 책임자가 끝까지 밀고 검증하려면 `$ralph`를 사용합니다.
+
 ## 핵심 모델
 
 OMX는 다음 레이어를 설치하고 연결합니다:
@@ -156,7 +162,7 @@ omx team shutdown <team-name>
 ### Team shutdown policy
 
 Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; there is no separate `omx team ralph ...` shutdown policy anymore.
+Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
 
 팀 워커를 위한 Worker CLI 선택:
 
@@ -200,7 +206,7 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # 선택: 적응형 queue->resend 폴백 비활
 
 예시:
 - 에이전트: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
-- 스킬: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+- 스킬: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `cancel`
 
 ## 프로젝트 구조
 

package/README.md

@@ -18,8 +18,8 @@ OMX is a workflow layer for [OpenAI Codex CLI](https://github.com/openai/codex).
 
 It keeps Codex as the execution engine and makes it easier to:
 - start a stronger Codex session by default
-- reuse good role/task invocations with `$name` keywords
-- invoke workflows with skills like `$plan`, `$ralph`, and `$team`
+- run one consistent workflow from clarification to completion
+- invoke the canonical skills with `$deep-interview`, `$ralplan`, `$team`, and `$ralph`
 - keep project guidance, plans, logs, and state in `.omx/`
 
 ## Recommended default flow
@@ -35,18 +35,20 @@ omx --madmax --high
 Then work normally inside Codex:
 
 ```text
-$architect "analyze the authentication flow"
-$plan "ship this feature cleanly"
+$deep-interview "clarify the authentication change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 That is the main path.
-Start OMX strongly, do the work in Codex, and let the agent pull in `$team` or other workflows only when the task actually needs them.
+Start OMX strongly, clarify first when needed, approve the plan, then choose `$team` for coordinated parallel execution or `$ralph` for the persistent completion loop.
 
 ## What OMX is for
 
 Use OMX if you already like Codex and want a better day-to-day runtime around it:
-- reusable role/task invocations such as `$architect` and `$executor`
-- reusable workflows such as `$plan`, `$ralph`, `$team`, and `$deep-interview`
+- a standard workflow built around `$deep-interview`, `$ralplan`, `$team`, and `$ralph`
+- specialist roles and supporting skills when the task needs them
 - project guidance through scoped `AGENTS.md`
 - durable state under `.omx/` for plans, logs, memory, and mode tracking
 
@@ -70,14 +72,16 @@ Launch OMX the recommended way:
 omx --madmax --high
 ```
 
-Then try one role keyword and one workflow skill:
+Then try the canonical workflow:
 
 ```text
-$architect "analyze the authentication flow"
-$plan "map the safest implementation path"
+$deep-interview "clarify the authentication change"
+$ralplan "approve the safest implementation path"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
-If the task grows, the agent can escalate to heavier workflows such as `$ralph` for persistent execution or `$team` for coordinated parallel work.
+Use `$team` when the approved plan needs coordinated parallel work, or `$ralph` when one persistent owner should keep pushing to completion.
 
 ## A simple mental model
 
@@ -95,27 +99,26 @@ Most users should think of OMX as **better task routing + better workflow + bett
 
 1. Run `omx setup`
 2. Launch with `omx --madmax --high`
-3. Ask for analysis with `$architect "..."`
-4. Ask for planning with `$plan "..."`
-5. Let the agent decide when `$ralph`, `$team`, or another workflow is worth using
+3. Use `$deep-interview "..."` when the request or boundaries are still unclear
+4. Use `$ralplan "..."` to approve the plan and review tradeoffs
+5. Choose `$team` for coordinated parallel execution or `$ralph` for persistent completion loops
+
+## Recommended workflow
+
+1. `$deep-interview` — clarify scope when the request or boundaries are still vague.
+2. `$ralplan` — turn that clarified scope into an approved architecture and implementation plan.
+3. `$team` or `$ralph` — use `$team` for coordinated parallel execution, or `$ralph` when you want a persistent completion loop with one owner.
 
 ## Common in-session surfaces
 
 | Surface | Use it for |
 | --- | --- |
-| `$architect "..."` | analysis, boundaries, tradeoffs |
-| `$executor "..."` | focused implementation work |
-| `/skills` | browsing installed skills |
-| `$plan "..."` | planning before implementation |
-| `$ralph "..."` | persistent sequential execution |
-| `$team "..."` | coordinated parallel execution when the task is big enough |
-
-Use `$deep-interview` when the request is still vague, the boundaries are unclear, or you want OMX to keep pressing on intent, non-goals, and decision boundaries before it hands work off to `$plan`, `$ralph`, `$team`, or `$autopilot`.
-
-Typical cases:
-- vague greenfield ideas that still need sharper intent and scope
-- brownfield changes where OMX should inspect the repo first, then ask cited confirmation questions
-- requests where you want a one-question-at-a-time clarification loop instead of immediate planning or implementation
+| `$deep-interview "..."` | clarifying intent, boundaries, and non-goals |
+| `$ralplan "..."` | approving the implementation plan and tradeoffs |
+| `$ralph "..."` | persistent completion and verification loops |
+| `$team "..."` | coordinated parallel execution when the work is big enough |
+| `/skills` | browsing installed skills and supporting helpers |
+
 ## Advanced / operator surfaces
 
 These are useful, but they are not the main onboarding path.
@@ -201,6 +204,8 @@ If this happens, try:
 - [Deutsch](./README.de.md)
 - [Français](./README.fr.md)
 - [Italiano](./README.it.md)
+- [Ελληνικά](./README.el.md)
+- [Polski](./README.pl.md)
 
 ## Contributors
 
@@ -215,4 +220,4 @@ If this happens, try:
 
 ## License
 
-MIT
+MIT