oh-my-githubcopilot 1.4.1 → 1.8.0-alpha.021bf87

package/README.de.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-antigravity (OMG)](https://github.com/r3dlex/oh-my-antigravity) | [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)
+**Multi-Agent-Orchestrierung für GitHub Copilot CLI. Keine Lernkurve.**
 
-**Oh-My-Copilot (OMP)** ist ein Plugin und eine Erweiterung fuer GitHub Copilot, das moderne Workflow-Orchestrierung und agentische KI-Faehigkeiten auf Copilot aufsetzt.
+_Lerne nicht GitHub Copilot CLI. Nutze einfach omp._
+
+[Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
 
 ---
 
+## Warum omp?
+
+Jedes Softwareteam jongliert gleichzeitig mit Implementierung, Architektur, Sicherheitsprüfung, Tests und DevOps. omp orchestriert spezialisierte Agenten, damit jede Dimension parallel fachkundige Aufmerksamkeit erhält — ohne dass du die Katzen hüten musst.
+
+GitHub Copilot ist bereits der Ort, an dem viele Entwickler um Hilfe bitten; omp macht daraus ein koordiniertes Engineering-Team. Es bündelt Copilot-Agenten, Skills, Hooks, MCP-Setup und HUD-Zustand in einem vorhersehbaren Workflow, damit du vom Prompt zur verifizierten Lieferung kommst, ohne die Orchestrierung von Hand zu verdrahten.
+
+---
+
+<a id="quick-start"></a>
 ## Schnellstart
 
 ```bash
-# Installation
 npm install -g oh-my-githubcopilot
+omp setup --scope project
+omp
+```
 
-# Konfiguration
-omp setup
+Starte deine CLI nach dem Setup neu, damit die `/`-Befehle erscheinen.
+
+```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>
 ---
 
 ## Funktionen
 
-- **Multi-Agent-Orchestrierung** - 18 spezialisierte Agenten fuer verschiedene Aufgaben
-- **MCP-Server-Integration** - Verbindung zu externen Diensten und Tools
-- **HUD-Anzeige** - Echtzeit-Status und Kontextverfolgung
-- **Plugin-State-Manager** - Zuverlaessiger Zustand ueber Sitzungen hinweg
-- **30+ Skills** - Lazare Komponenten fuer erweitere Funktionalitaet
+| 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-Referenz
+
+| 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
+
+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-Modus
+
+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
+```
+
+Für GitHub Copilot CLI hält Team-Modus die Agenten- und Skill-Assets unter `.copilot/` synchron, während Terminal-Worker sich über langlebigen OMX/OMP-Zustand koordinieren. Nutze ihn, wenn eine Copilot-Aufgabe getrennte Implementierungs-, Prüf-, Dokumentations- oder Release-Lanes braucht und jede Lane Evidenz melden soll, bevor der Branch weiterläuft.
 
 ---
 
 ## Dokumentation
 
-- [AGENTS.md](./AGENTS.md) - Agent-Registrierung und Delegationsregeln
-- [spec/](./spec/) - Komponenten-Spezifikationen
+- [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)
 
 ---
 
 ## Lizenz
 
-MIT
+omp is open source under the [Apache-2.0 License](LICENSE).
+
+---
+
+## Sponsoren
+
+If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️

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-antigravity (OMG)](https://github.com/r3dlex/oh-my-antigravity) | [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-antigravity (OMG)](https://github.com/r3dlex/oh-my-antigravity) | [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-antigravity (OMG)](https://github.com/r3dlex/oh-my-antigravity) | [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) ❤️