oh-my-githubcopilot 1.4.1 → 1.8.0-alpha.f50f59a

package/README.es.md

@@ -1,53 +1,139 @@
-[English](README.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Français](README.fr.md) | [Italiano](README.it.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Русский](README.ru.md) | [Türkçe](README.tr.md) | [Tiếng Việt](README.vi.md) | [中文](README.zh.md)
+# oh-my-githubcopilot (omp)
 
-# oh-my-githubcopilot
-<p align="center">
-  <img src="assets/omp-banner.png" alt="Oh My Copilot" width="100%"/>
-</p>
+> **Sister projects:** [oh-my-claudecode (OMC)](https://github.com/Yeachan-Heo/oh-my-claudecode) | [oh-my-codex (OMX)](https://github.com/Yeachan-Heo/oh-my-codex) | [oh-my-githubcopilot (OMP)](https://github.com/r3dlex/oh-my-githubcopilot) | [oh-my-gemini (OMG)](https://github.com/r3dlex/oh-my-gemini) | [oh-my-auggie (OMA)](https://github.com/r3dlex/oh-my-auggie)
 
-[![npm version](https://img.shields.io/npm/v/oh-my-githubcopilot?color=cb3837)](https://www.npmjs.com/package/oh-my-githubcopilot)
-[![npm downloads](https://img.shields.io/npm/dm/oh-my-githubcopilot?color=blue)](https://www.npmjs.com/package/oh-my-githubcopilot)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+**Orquestación multiagente para GitHub Copilot CLI. Sin curva de aprendizaje.**
 
-**Oh-My-Copilot (OMP)** es un plugin y extension para GitHub Copilot que agrega orquestacion moderna de workflows y capacidades de IA agenticas sobre Copilot.
+_No aprendas GitHub Copilot CLI. Solo usa omp._
+
+[Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
 
 ---
 
-## Inicio Rapido
+## ¿Por qué omp?
+
+Todo equipo de software gestiona implementación, arquitectura, revisión de seguridad, pruebas y DevOps al mismo tiempo. omp orquesta agentes especializados para que cada dimensión reciba atención experta en paralelo, sin que tengas que pastorear gatos.
+
+GitHub Copilot ya es el lugar donde muchos desarrolladores piden ayuda; omp convierte esa superficie en un equipo de ingeniería coordinado. Mantiene agentes, habilidades, hooks, configuración MCP y estado HUD para Copilot en un flujo predecible para pasar del prompt a una entrega verificada sin cablear la orquestación a mano.
+
+---
+
+<a id="quick-start"></a>
+## Inicio rápido
 
 ```bash
-# Instalacion
 npm install -g oh-my-githubcopilot
+omp setup --scope project
+omp
+```
 
-# Configuracion
-omp setup
+Después del setup, reinicia tu CLI para que aparezcan los comandos `/`.
+
+```bash
+omp doctor              # check prerequisites
+omp team run --task "..." --workers 2   # parallel work
+omp hud --watch         # live status
 ```
-<p align="center">
-  <img src="assets/buddy-playful.png" alt="OMP in action" width="600"/>
-</p>
 
 ---
 
-## Caracteristicas
+## Funciones
+
+| Feature | Description |
+|---------|-------------|
+| **Specialized Agents** | 23+ agents (analyst, architect, executor, debugger, critic, verifier, test-engineer, writer, and more) |
+| **Parallel Team Mode** | tmux-based multi-worker orchestration with shared task state |
+| **Workflow Skills** | 39 skills built in — plan, deep-interview, ralph, autopilot, ultrawork, code-review, and more |
+| **Persistent Hooks** | Automatic tool tracking, project memory, session management |
+| **Real-time HUD** | Live status overlay showing agents, costs, and progress |
+| **CI/CD Ready** | Verification gates, test integration, release workflows |
+| **Multilingual** | README in 12 languages |
+
+---
+
+<a id="cli-reference"></a>
+## Referencia CLI
+
+| Command | Description |
+|---------|-------------|
+| `omp` | Launch interactive session |
+| `omp setup` | Configure GitHub Copilot CLI integration |
+| `omp doctor` | Check prerequisites and fix issues |
+| `omp team run` | Start parallel team execution |
+| `omp team status` | Check team progress |
+| `omp hud --watch` | Show live status overlay |
+| `omp trace` | Show execution trace |
+
+See the [full documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme) for all commands.
+
+---
+
+<a id="workflows"></a>
+## Flujos de trabajo
 
-- **Orquestacion Multi-Agente** - 18 agentes especializados para diferentes tareas
-- **Integracion MCP Server** - Conexion a servicios y herramientas externas
-- **Pantalla HUD** - Seguimiento de estado y contexto en tiempo real
-- **Plugin State Manager** - Estado confiable a traves de sesiones
-- **30+ Skills** - Carga diferida para funcionalidad extendida
+omp ships execution-mode and planning-mode workflows as built-in skills.
+
+### Execution Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$autopilot` | Idea → working code end-to-end |
+| `$team` | N coordinated agents on a shared task |
+| `$ralph` | Persistent completion loop until verified |
+| `$ultrawork` | Maximum parallel throughput execution |
+| `$ultraqa` | QA cycling until goals are met |
+
+### Planning Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$plan` | Strategic planning with optional interviews |
+| `$deep-interview` | Socratic clarification before execution |
+| `$ralplan` | Consensus planning with Architect + Critic review |
+
+### Utility Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$code-review` | Comprehensive code review |
+| `$security-review` | Security audit |
+| `$doctor` | Diagnose and fix installation issues |
+| `$trace` | Agent flow trace and summary |
+| `$note` | Save session notes |
+| `$wiki` | Persistent project wiki |
+
+---
+
+## Modo Team
+
+tmux-first multi-worker orchestration with persistent state and lifecycle controls.
+
+```bash
+omp team run --task "review src/ for reliability gaps" --workers 4
+omp team status --team omp --json
+omp team resume --team omp
+omp team shutdown --team omp --force
+```
+
+Para GitHub Copilot CLI, el modo team mantiene sincronizados los agentes y habilidades de `.copilot/` mientras los workers de terminal se coordinan mediante estado durable OMX/OMP. Úsalo cuando una tarea de Copilot necesite carriles separados de implementación, verificación, documentación o release y quieras evidencia de cada carril antes de avanzar el branch.
 
-<p align="center">
-  <img src="assets/buddy-swarm.png" alt="OMP swarm mode" width="600"/>
-</p>
 ---
 
-## Documentacion
+## Documentación
 
-- [AGENTS.md](./AGENTS.md) - Registro de agentes y reglas de delegacion
-- [spec/](./spec/) - Especificaciones de componentes
+- [Full Documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme)
+- [GitHub Repository](https://github.com/r3dlex/oh-my-githubcopilot)
+- [Issues](https://github.com/r3dlex/oh-my-githubcopilot/issues)
+- [Security Policy](https://github.com/r3dlex/oh-my-githubcopilot/security)
 
 ---
 
 ## Licencia
 
-MIT
+omp is open source under the [Apache-2.0 License](LICENSE).
+
+---
+
+## Patrocinadores
+
+If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️

package/README.fr.md

@@ -1,53 +1,139 @@
-[English](README.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Français](README.fr.md) | [Italiano](README.it.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Русский](README.ru.md) | [Türkçe](README.tr.md) | [Tiếng Việt](README.vi.md) | [中文](README.zh.md)
+# oh-my-githubcopilot (omp)
 
-# oh-my-githubcopilot
-<p align="center">
-  <img src="assets/omp-banner.png" alt="Oh My Copilot" width="100%"/>
-</p>
+> **Sister projects:** [oh-my-claudecode (OMC)](https://github.com/Yeachan-Heo/oh-my-claudecode) | [oh-my-codex (OMX)](https://github.com/Yeachan-Heo/oh-my-codex) | [oh-my-githubcopilot (OMP)](https://github.com/r3dlex/oh-my-githubcopilot) | [oh-my-gemini (OMG)](https://github.com/r3dlex/oh-my-gemini) | [oh-my-auggie (OMA)](https://github.com/r3dlex/oh-my-auggie)
 
-[![npm version](https://img.shields.io/npm/v/oh-my-githubcopilot?color=cb3837)](https://www.npmjs.com/package/oh-my-githubcopilot)
-[![npm downloads](https://img.shields.io/npm/dm/oh-my-githubcopilot?color=blue)](https://www.npmjs.com/package/oh-my-githubcopilot)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+**Orchestration multi-agent pour GitHub Copilot CLI. Aucune courbe d’apprentissage.**
 
-**Oh-My-Copilot (OMP)** est un plugin et une extension pour GitHub Copilot qui ajoute une orchestration de workflow moderne et des capacites d'IA agentique au-dessus de Copilot.
+_N’apprends pas GitHub Copilot CLI. Utilise simplement omp._
+
+[Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
 
 ---
 
-## Demarrage Rapide
+## Pourquoi omp ?
+
+Chaque équipe logicielle jongle simultanément avec l’implémentation, l’architecture, la revue sécurité, les tests et le DevOps. omp orchestre des agents spécialisés pour que chaque dimension reçoive une expertise en parallèle, sans devoir tout coordonner à la main.
+
+GitHub Copilot est déjà l’endroit où beaucoup de développeurs demandent de l’aide ; omp transforme cette surface en équipe d’ingénierie coordonnée. Il regroupe agents, skills, hooks, configuration MCP et état HUD orientés Copilot dans un flux prévisible, du prompt à la livraison vérifiée.
+
+---
+
+<a id="quick-start"></a>
+## Démarrage rapide
 
 ```bash
-# Installation
 npm install -g oh-my-githubcopilot
+omp setup --scope project
+omp
+```
 
-# Configuration
-omp setup
+Après la configuration, redémarre ta CLI pour faire apparaître les commandes `/`.
+
+```bash
+omp doctor              # check prerequisites
+omp team run --task "..." --workers 2   # parallel work
+omp hud --watch         # live status
 ```
-<p align="center">
-  <img src="assets/buddy-playful.png" alt="OMP in action" width="600"/>
-</p>
 
 ---
 
-## Fonctionnalites
+## Fonctionnalités
+
+| Feature | Description |
+|---------|-------------|
+| **Specialized Agents** | 23+ agents (analyst, architect, executor, debugger, critic, verifier, test-engineer, writer, and more) |
+| **Parallel Team Mode** | tmux-based multi-worker orchestration with shared task state |
+| **Workflow Skills** | 39 skills built in — plan, deep-interview, ralph, autopilot, ultrawork, code-review, and more |
+| **Persistent Hooks** | Automatic tool tracking, project memory, session management |
+| **Real-time HUD** | Live status overlay showing agents, costs, and progress |
+| **CI/CD Ready** | Verification gates, test integration, release workflows |
+| **Multilingual** | README in 12 languages |
+
+---
+
+<a id="cli-reference"></a>
+## Référence CLI
+
+| Command | Description |
+|---------|-------------|
+| `omp` | Launch interactive session |
+| `omp setup` | Configure GitHub Copilot CLI integration |
+| `omp doctor` | Check prerequisites and fix issues |
+| `omp team run` | Start parallel team execution |
+| `omp team status` | Check team progress |
+| `omp hud --watch` | Show live status overlay |
+| `omp trace` | Show execution trace |
+
+See the [full documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme) for all commands.
+
+---
+
+<a id="workflows"></a>
+## Workflows
 
-- **Orchestration Multi-Agent** - 23 agents specialises pour differentes taches
-- **Integration Serveur MCP** - Connexion aux services et outils externes
-- **Affichage HUD** - Suivi de l'etat et du contexte en temps reel
-- **Plugin State Manager** - Etat fiable a travers les sessions
-- **25 Skills** - Chargement paresseux pour les fonctionnalites etendues
+omp ships execution-mode and planning-mode workflows as built-in skills.
+
+### Execution Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$autopilot` | Idea → working code end-to-end |
+| `$team` | N coordinated agents on a shared task |
+| `$ralph` | Persistent completion loop until verified |
+| `$ultrawork` | Maximum parallel throughput execution |
+| `$ultraqa` | QA cycling until goals are met |
+
+### Planning Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$plan` | Strategic planning with optional interviews |
+| `$deep-interview` | Socratic clarification before execution |
+| `$ralplan` | Consensus planning with Architect + Critic review |
+
+### Utility Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$code-review` | Comprehensive code review |
+| `$security-review` | Security audit |
+| `$doctor` | Diagnose and fix installation issues |
+| `$trace` | Agent flow trace and summary |
+| `$note` | Save session notes |
+| `$wiki` | Persistent project wiki |
+
+---
+
+## Mode Team
+
+tmux-first multi-worker orchestration with persistent state and lifecycle controls.
+
+```bash
+omp team run --task "review src/ for reliability gaps" --workers 4
+omp team status --team omp --json
+omp team resume --team omp
+omp team shutdown --team omp --force
+```
+
+Pour GitHub Copilot CLI, le mode team synchronise les assets agents et skills sous `.copilot/` pendant que les workers de terminal se coordonnent via un état durable OMX/OMP. Utilise-le lorsqu’une tâche Copilot exige des voies distinctes pour implémentation, vérification, documentation ou release, avec des preuves avant d’avancer la branche.
 
-<p align="center">
-  <img src="assets/buddy-swarm.png" alt="OMP swarm mode" width="600"/>
-</p>
 ---
 
 ## Documentation
 
-- [AGENTS.md](./AGENTS.md) - Registre des agents et regles de delegation
-- [spec/](./spec/) - Specifications des composants
+- [Full Documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme)
+- [GitHub Repository](https://github.com/r3dlex/oh-my-githubcopilot)
+- [Issues](https://github.com/r3dlex/oh-my-githubcopilot/issues)
+- [Security Policy](https://github.com/r3dlex/oh-my-githubcopilot/security)
 
 ---
 
 ## Licence
 
-MIT
+omp is open source under the [Apache-2.0 License](LICENSE).
+
+---
+
+## Sponsors
+
+If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️

package/README.it.md

@@ -1,53 +1,139 @@
-[English](README.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Français](README.fr.md) | [Italiano](README.it.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Русский](README.ru.md) | [Türkçe](README.tr.md) | [Tiếng Việt](README.vi.md) | [中文](README.zh.md)
+# oh-my-githubcopilot (omp)
 
-# oh-my-githubcopilot
-<p align="center">
-  <img src="assets/omp-banner.png" alt="Oh My Copilot" width="100%"/>
-</p>
+> **Sister projects:** [oh-my-claudecode (OMC)](https://github.com/Yeachan-Heo/oh-my-claudecode) | [oh-my-codex (OMX)](https://github.com/Yeachan-Heo/oh-my-codex) | [oh-my-githubcopilot (OMP)](https://github.com/r3dlex/oh-my-githubcopilot) | [oh-my-gemini (OMG)](https://github.com/r3dlex/oh-my-gemini) | [oh-my-auggie (OMA)](https://github.com/r3dlex/oh-my-auggie)
 
-[![npm version](https://img.shields.io/npm/v/oh-my-githubcopilot?color=cb3837)](https://www.npmjs.com/package/oh-my-githubcopilot)
-[![npm downloads](https://img.shields.io/npm/dm/oh-my-githubcopilot?color=blue)](https://www.npmjs.com/package/oh-my-githubcopilot)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+**Orchestrazione multi-agente per GitHub Copilot CLI. Nessuna curva di apprendimento.**
 
-**Oh-My-Copilot (OMP)** e un plugin e un'estensione per GitHub Copilot che aggiunge orchestrazione moderna dei workflow e capacita di IA agentica sopra Copilot.
+_Non imparare GitHub Copilot CLI. Usa semplicemente omp._
+
+[Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
 
 ---
 
-## Avvio Rapido
+## Perché omp?
+
+Ogni team software gestisce contemporaneamente implementazione, architettura, revisione di sicurezza, test e DevOps. omp orchestra agenti specializzati così ogni dimensione riceve attenzione esperta in parallelo, senza dover coordinare tutto a mano.
+
+GitHub Copilot è già il luogo in cui molti sviluppatori chiedono aiuto; omp trasforma quella superficie in un team di ingegneria coordinato. Tiene insieme agenti, skill, hook, setup MCP e stato HUD per Copilot in un flusso prevedibile, dal prompt alla consegna verificata.
+
+---
+
+<a id="quick-start"></a>
+## Avvio rapido
 
 ```bash
-# Installazione
 npm install -g oh-my-githubcopilot
+omp setup --scope project
+omp
+```
 
-# Configurazione
-omp setup
+Dopo il setup, riavvia la CLI perché appaiano i comandi `/`.
+
+```bash
+omp doctor              # check prerequisites
+omp team run --task "..." --workers 2   # parallel work
+omp hud --watch         # live status
 ```
-<p align="center">
-  <img src="assets/buddy-playful.png" alt="OMP in action" width="600"/>
-</p>
 
-<p align="center">
-  <img src="assets/buddy-swarm.png" alt="OMP swarm mode" width="600"/>
-</p>
 ---
 
-## Funzionalita
+## Funzionalità
+
+| Feature | Description |
+|---------|-------------|
+| **Specialized Agents** | 23+ agents (analyst, architect, executor, debugger, critic, verifier, test-engineer, writer, and more) |
+| **Parallel Team Mode** | tmux-based multi-worker orchestration with shared task state |
+| **Workflow Skills** | 39 skills built in — plan, deep-interview, ralph, autopilot, ultrawork, code-review, and more |
+| **Persistent Hooks** | Automatic tool tracking, project memory, session management |
+| **Real-time HUD** | Live status overlay showing agents, costs, and progress |
+| **CI/CD Ready** | Verification gates, test integration, release workflows |
+| **Multilingual** | README in 12 languages |
+
+---
+
+<a id="cli-reference"></a>
+## Riferimento CLI
+
+| Command | Description |
+|---------|-------------|
+| `omp` | Launch interactive session |
+| `omp setup` | Configure GitHub Copilot CLI integration |
+| `omp doctor` | Check prerequisites and fix issues |
+| `omp team run` | Start parallel team execution |
+| `omp team status` | Check team progress |
+| `omp hud --watch` | Show live status overlay |
+| `omp trace` | Show execution trace |
+
+See the [full documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme) for all commands.
+
+---
+
+<a id="workflows"></a>
+## Workflow
 
-- **Orchestrazione Multi-Agente** - 18 agenti specializzati per diversi compiti
-- **Integrazione Server MCP** - Connessione a servizi e strumenti esterni
-- **Display HUD** - Tracciamento dello stato e del contesto in tempo reale
-- **Plugin State Manager** - Stato affidabile tra le sessioni
-- **30+ Skills** - Caricamento pigro per funzionalita estese
+omp ships execution-mode and planning-mode workflows as built-in skills.
+
+### Execution Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$autopilot` | Idea → working code end-to-end |
+| `$team` | N coordinated agents on a shared task |
+| `$ralph` | Persistent completion loop until verified |
+| `$ultrawork` | Maximum parallel throughput execution |
+| `$ultraqa` | QA cycling until goals are met |
+
+### Planning Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$plan` | Strategic planning with optional interviews |
+| `$deep-interview` | Socratic clarification before execution |
+| `$ralplan` | Consensus planning with Architect + Critic review |
+
+### Utility Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$code-review` | Comprehensive code review |
+| `$security-review` | Security audit |
+| `$doctor` | Diagnose and fix installation issues |
+| `$trace` | Agent flow trace and summary |
+| `$note` | Save session notes |
+| `$wiki` | Persistent project wiki |
+
+---
+
+## Modalità Team
+
+tmux-first multi-worker orchestration with persistent state and lifecycle controls.
+
+```bash
+omp team run --task "review src/ for reliability gaps" --workers 4
+omp team status --team omp --json
+omp team resume --team omp
+omp team shutdown --team omp --force
+```
+
+Per GitHub Copilot CLI, la modalità team mantiene sincronizzati gli asset agenti e skill in `.copilot/` mentre i worker del terminale si coordinano tramite stato durevole OMX/OMP. Usala quando un’attività Copilot richiede corsie separate per implementazione, verifica, documentazione o release e vuoi evidenza prima di avanzare il branch.
 
 ---
 
 ## Documentazione
 
-- [AGENTS.md](./AGENTS.md) - Registro degli agenti e regole di delegazione
-- [spec/](./spec/) - Specifiche dei componenti
+- [Full Documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme)
+- [GitHub Repository](https://github.com/r3dlex/oh-my-githubcopilot)
+- [Issues](https://github.com/r3dlex/oh-my-githubcopilot/issues)
+- [Security Policy](https://github.com/r3dlex/oh-my-githubcopilot/security)
 
 ---
 
 ## Licenza
 
-MIT
+omp is open source under the [Apache-2.0 License](LICENSE).
+
+---
+
+## Sponsor
+
+If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️

package/README.ja.md

@@ -1,53 +1,139 @@
-[English](README.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Français](README.fr.md) | [Italiano](README.it.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Русский](README.ru.md) | [Türkçe](README.tr.md) | [Tiếng Việt](README.vi.md) | [中文](README.zh.md)
+# oh-my-githubcopilot (omp)
 
-# oh-my-githubcopilot
-<p align="center">
-  <img src="assets/omp-banner.png" alt="Oh My Copilot" width="100%"/>
-</p>
+> **Sister projects:** [oh-my-claudecode (OMC)](https://github.com/Yeachan-Heo/oh-my-claudecode) | [oh-my-codex (OMX)](https://github.com/Yeachan-Heo/oh-my-codex) | [oh-my-githubcopilot (OMP)](https://github.com/r3dlex/oh-my-githubcopilot) | [oh-my-gemini (OMG)](https://github.com/r3dlex/oh-my-gemini) | [oh-my-auggie (OMA)](https://github.com/r3dlex/oh-my-auggie)
 
-[![npm version](https://img.shields.io/npm/v/oh-my-githubcopilot?color=cb3837)](https://www.npmjs.com/package/oh-my-githubcopilot)
-[![npm downloads](https://img.shields.io/npm/dm/oh-my-githubcopilot?color=blue)](https://www.npmjs.com/package/oh-my-githubcopilot)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+**GitHub Copilot CLI のためのマルチエージェント・オーケストレーション。学習コストはゼロ。**
 
-**Oh-My-Copilot (OMP)** は、GitHub Copilot にモダンなワークフローオーケストレーションとエージェント型 AI 機能を追加するプラグインおよび拡張機能です。
+_GitHub Copilot CLI を覚える必要はありません。omp を使うだけです。_
+
+[Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
 
-<p align="center">
-  <img src="assets/buddy-swarm.png" alt="OMP swarm mode" width="600"/>
-</p>
 ---
 
+## なぜ omp?
+
+ソフトウェアチームは実装、アーキテクチャ、セキュリティレビュー、テスト、DevOps を同時に扱います。omp は専門エージェントを並列にオーケストレーションし、各領域に専門的な注意を届けます。
+
+GitHub Copilot は多くの開発者が助けを求める場所です。omp はその場を協調するエンジニアリングチームへ変えます。Copilot 向けのエージェント、スキル、フック、MCP 設定、HUD 状態を予測可能なワークフローにまとめ、プロンプトから検証済みの成果まで進めます。
+
+---
+
+<a id="quick-start"></a>
 ## クイックスタート
 
 ```bash
-# インストール
 npm install -g oh-my-githubcopilot
+omp setup --scope project
+omp
+```
 
-# 設定
-omp setup
+セットアップ後、`/` コマンドを表示するために CLI を再起動してください。
+
+```bash
+omp doctor              # check prerequisites
+omp team run --task "..." --workers 2   # parallel work
+omp hud --watch         # live status
 ```
-<p align="center">
-  <img src="assets/buddy-playful.png" alt="OMP in action" width="600"/>
-</p>
 
 ---
 
 ## 機能
 
-- **マルチエージェントオーケストレーション** - 様々なタスクに対応する18の specialized エージェント
-- **MCP サーバー統合** - 外部サービスやツールへの接続
-- **HUD ディスプレイ** - リアルタイムの状態とコンテキスト追跡
-- **Plugin State Manager** - セッション間で信頼性の高い状態管理
-- **30+ スキル** - 拡張機能のための遅延ロード
+| Feature | Description |
+|---------|-------------|
+| **Specialized Agents** | 23+ agents (analyst, architect, executor, debugger, critic, verifier, test-engineer, writer, and more) |
+| **Parallel Team Mode** | tmux-based multi-worker orchestration with shared task state |
+| **Workflow Skills** | 39 skills built in — plan, deep-interview, ralph, autopilot, ultrawork, code-review, and more |
+| **Persistent Hooks** | Automatic tool tracking, project memory, session management |
+| **Real-time HUD** | Live status overlay showing agents, costs, and progress |
+| **CI/CD Ready** | Verification gates, test integration, release workflows |
+| **Multilingual** | README in 12 languages |
+
+---
+
+<a id="cli-reference"></a>
+## CLI リファレンス
+
+| Command | Description |
+|---------|-------------|
+| `omp` | Launch interactive session |
+| `omp setup` | Configure GitHub Copilot CLI integration |
+| `omp doctor` | Check prerequisites and fix issues |
+| `omp team run` | Start parallel team execution |
+| `omp team status` | Check team progress |
+| `omp hud --watch` | Show live status overlay |
+| `omp trace` | Show execution trace |
+
+See the [full documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme) for all commands.
+
+---
+
+<a id="workflows"></a>
+## ワークフロー
+
+omp ships execution-mode and planning-mode workflows as built-in skills.
+
+### Execution Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$autopilot` | Idea → working code end-to-end |
+| `$team` | N coordinated agents on a shared task |
+| `$ralph` | Persistent completion loop until verified |
+| `$ultrawork` | Maximum parallel throughput execution |
+| `$ultraqa` | QA cycling until goals are met |
+
+### Planning Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$plan` | Strategic planning with optional interviews |
+| `$deep-interview` | Socratic clarification before execution |
+| `$ralplan` | Consensus planning with Architect + Critic review |
+
+### Utility Modes
+
+| Skill | Purpose |
+|-------|---------|
+| `$code-review` | Comprehensive code review |
+| `$security-review` | Security audit |
+| `$doctor` | Diagnose and fix installation issues |
+| `$trace` | Agent flow trace and summary |
+| `$note` | Save session notes |
+| `$wiki` | Persistent project wiki |
+
+---
+
+## Team モード
+
+tmux-first multi-worker orchestration with persistent state and lifecycle controls.
+
+```bash
+omp team run --task "review src/ for reliability gaps" --workers 4
+omp team status --team omp --json
+omp team resume --team omp
+omp team shutdown --team omp --force
+```
+
+GitHub Copilot CLI では、team モードが `.copilot/` 配下のエージェントとスキルを同期し、ターミナル worker は永続的な OMX/OMP 状態で連携します。実装、検証、ドキュメント、リリースを分け、各レーンの証跡を確認してからブランチを進めたいときに使います。
 
 ---
 
 ## ドキュメント
 
-- [AGENTS.md](./AGENTS.md) - エージェント登録と委任ルール
-- [spec/](./spec/) - コンポーネント仕様
+- [Full Documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme)
+- [GitHub Repository](https://github.com/r3dlex/oh-my-githubcopilot)
+- [Issues](https://github.com/r3dlex/oh-my-githubcopilot/issues)
+- [Security Policy](https://github.com/r3dlex/oh-my-githubcopilot/security)
 
 ---
 
 ## ライセンス
 
-MIT
+omp is open source under the [Apache-2.0 License](LICENSE).
+
+---
+
+## スポンサー
+
+If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️