oh-my-githubcopilot 1.5.7 → 1.8.0-alpha.afa30a7

package/README.md

@@ -1,219 +1,140 @@
-# oh-my-githubcopilot (OMP)
+# oh-my-githubcopilot (omp)
 
-<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)
 
-<p align="center">
-  Multi-agent orchestration for GitHub Copilot CLI — powered by 23 specialized agents, 25 skills, and a real-time HUD.
-</p>
+**Multi-agent orchestration for GitHub Copilot CLI. Zero learning curve.**
 
-[![npm version](https://img.shields.io/npm/v/oh-my-githubcopilot?color=red)](https://npmjs.com/package/oh-my-githubcopilot)
-[![npm downloads](https://img.shields.io/npm/dm/oh-my-githubcopilot?color=blue)](https://npmjs.com/package/oh-my-githubcopilot)
-[![License: Apache-2.0](https://img.shields.io/npm/l/oh-my-githubcopilot?color=green)](LICENSE)
-[![Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=r3dlex&color=EA4949&logo=github-sponsors)](https://github.com/sponsors/r3dlex)
+_Don't learn GitHub Copilot CLI. Just use omp._
+
+[Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
 
 ---
 
-## Why OMP?
+## Why omp?
 
-Every software team juggles implementation, architecture, security review, testing, and DevOps — all simultaneously. OMP orchestrates specialized agents so every dimension gets expert attention, in parallel, without you herding cats.
+Every software team juggles implementation, architecture, security review, testing, and DevOps — all simultaneously. omp orchestrates specialized agents so every dimension gets expert attention, in parallel, without you herding cats.
 
-| What you get            | Why it matters                                                                                                                                         |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| **23 agents**           | executor, architect, planner, reviewer, debugger, designer, security-reviewer, scientist, analyst, and more — each tuned to a different craft          |
-| **25 skills**           | `autopilot`, `ralph`, `ultrawork`, `team`, `ecomode`, `swarm`, `pipeline`, `omp-plan`, `graphify`, `spending`, and more — trigger with a slash command |
-| **6 hooks**             | Keyword detection, delegation routing, model selection, token tracking, HUD emission, stop-continuation                                                |
-| **MCP server**          | Built-in tools for extended capabilities                                                                                                               |
-| **HUD display**         | Real-time session context and progress tracking                                                                                                        |
-| **PSM**                 | Plugin State Manager with SQLite persistence across sessions                                                                                           |
-| **SWE-bench**           | Benchmark harness for reproducible evaluation                                                                                                          |
-| **Copilot repo layout** | Copilot-facing docs live under `.copilot/`; `.github/` is reserved for workflows, plugin metadata, and hook entrypoints                                |
+GitHub Copilot is already where many developers ask for help; omp turns that surface into a coordinated engineering team. It keeps Copilot-facing agents, skills, hooks, MCP setup, and HUD state in one predictable workflow so you can move from prompt to verified delivery without hand-wiring the orchestration layer.
 
-<p align="center">
-  <img src="assets/buddy-swarm.png" alt="OMP swarm mode" width="600"/>
-</p>
+---
 
 ## Quick Start
 
-### 1) Install the plugin
-
-From a local checkout:
-
 ```bash
-git clone https://github.com/r3dlex/oh-my-githubcopilot.git
-cd oh-my-githubcopilot
-copilot plugin install ./
+npm install -g oh-my-githubcopilot
+omp setup --scope project
+omp
 ```
 
-Or install from GitHub directly:
+After setup, restart your CLI for the `/` commands to appear.
 
 ```bash
-copilot plugin install r3dlex/oh-my-githubcopilot
+omp doctor              # check prerequisites
+omp team run --task "..." --workers 2   # parallel work
+omp hud --watch         # live status
 ```
 
-### 2) Run first-time setup in Copilot
+---
 
-```text
-/skills list
-/setup
-/mcp show
-```
+## Features
 
-`/setup` is the short setup alias, and `/omp:setup` remains available. Both safely merge the required Copilot CLI experimental features into
-`~/.copilot/config.json` and fill in `statusLine` if you have not already configured one.
-After setup completes, restart the Copilot CLI session so the new experimental/status-line settings are picked up.
+| 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 |
 
-Required feature flags ensured by setup:
+---
 
-- `STATUS_LINE`
-- `SHOW_FILE`
-- `EXTENSIONS`
-- `BACKGROUND_SESSIONS`
-- `CONFIGURE_COPILOT_AGENT`
-- `MULTI_TURN_AGENTS`
-- `SESSION_STORE`
+## CLI Reference
 
-### 3) Start delegating work
+| 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 |
 
-```text
-@executor implement the requested change
-@planner break this task into steps
-@verifier check build, tests, and diagnostics
-```
+See the [full documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme) for all commands.
 
-### Optional: install the CLI companion
+---
 
-```bash
-npm install -g oh-my-githubcopilot
-omp setup
-omp version
-omp hud
-omp hud --watch
-```
+## Workflows
 
-The `omp` CLI is a companion tool for local runtime features; the Copilot plugin works without it.
-Running `omp setup` performs the same non-destructive Copilot config merge as `/setup` (or `/omp:setup`).
-Use `omp hud --watch` when you want the local HUD daemon to keep refreshing session artifacts in the background.
+omp ships execution-mode and planning-mode workflows as built-in skills.
 
-### Optional: adopt OMP into another repository
+### Execution Modes
 
-```bash
-git clone https://github.com/r3dlex/oh-my-githubcopilot.git /tmp/omp
-/tmp/omp/scripts/omp-adopt.sh --target . --mode template
-```
+| 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 |
 
-<p align="center">
-  <img src="assets/buddy-playful.png" alt="OMP in action" width="600"/>
-</p>
+### Planning Modes
 
-## Architecture
+| Skill | Purpose |
+|-------|---------|
+| `$plan` | Strategic planning with optional interviews |
+| `$deep-interview` | Socratic clarification before execution |
+| `$ralplan` | Consensus planning with Architect + Critic review |
 
-```
-┌──────────────────────────────────────────────────────────────┐
-│                    oh-my-githubcopilot                      │
-├──────────────────┬──────────────────┬────────────────────────┤
-│  Agents (23)     │  Hooks (6)       │  PSM (SQLite)          │
-│  ─────────────   │  ─────────────   │  ────────────────      │
-│  executor        │  keyword-        │  Cross-session         │
-│  architect       │  detector        │  state persistence     │
-│  planner         │  delegation-     │                        │
-│  reviewer        │  enforcer        │  MCP Server            │
-│  debugger        │  model-router    │  ─────────────         │
-│  designer        │  token-tracker   │  tools exposed         │
-│  security-       │  hud-emitter     │                        │
-│  reviewer        │  stop-contin.    │  HUD Display           │
-│  ... (23 total)  │                  │  ─────────────         │
-│                  │                  │  tmux status bar       │
-├──────────────────┴──────────────────┴────────────────────────┤
-│  .copilot/* refs + local Copilot-facing agent/skill docs    │
-│  ~/.omp/ (user config)  +  .omp/ (workspace config)         │
-└──────────────────────────────────────────────────────────────┘
-```
+### Utility Modes
 
-### Agents
-
-OMP provides 23 specialized agents, each with Copilot-compatible frontmatter for native discovery:
-
-| Agent             | Model tier | Use case                                                              |
-| ----------------- | ---------- | --------------------------------------------------------------------- |
-| executor          | standard   | Implementation, file edits, testing                                   |
-| architect         | high       | Architecture decisions and verification                               |
-| planner           | high       | Strategic planning and sequencing                                     |
-| verifier          | standard   | Build/test/diagnostic validation                                      |
-| writer            | standard   | Documentation and changelog work                                      |
-| explorer          | fast       | Read-only codebase surveys                                            |
-| debugger          | standard   | Root-cause analysis                                                   |
-| reviewer          | high       | General quality review                                                |
-| security-reviewer | standard   | Security review                                                       |
-| ...               | ...        | 23 total roles across implementation, planning, QA, and documentation |
-
-### Skills
-
-25 skills, each triggerable via slash command or keyword:
-
-| Skill          | Trigger                | Purpose                                             |
-| -------------- | ---------------------- | --------------------------------------------------- |
-| autopilot      | `/omp:autopilot`       | Autonomous end-to-end execution                     |
-| ralph          | `/omp:ralph`           | Persistent completion loop                          |
-| ultrawork      | `/omp:ultrawork`       | Parallel multi-agent high-throughput implementation |
-| team           | `/omp:team`            | Coordinated multi-agent execution                   |
-| deep-interview | `/omp:deep-interview`  | Requirements clarification                          |
-| omp-plan       | `/omp:plan`            | Strategic planning                                  |
-| omp-setup      | `/setup`, `/omp:setup` | Guided OMP setup                                    |
-| graphify       | `/omp:graphify`        | Knowledge graph generation                          |
-| graphwiki      | `/omp:graphwiki`       | Query and maintain graphwiki knowledge              |
-| graph-provider | `/omp:graph-provider`  | Manage the active graph backend                     |
-| spending       | `/omp:spending`        | Track premium request usage                         |
-| ...            | ...                    | 25 total skills                                     |
-
-## Repository Layout
+| 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 |
 
-```
-.
-├── AGENTS.md        # orchestration brain
-├── agents/          # 23 Copilot-facing agent files
-├── skills/          # 25 skills
-├── hooks/           # hook config + shell entrypoints
-├── src/             # TypeScript implementation
-├── dist/            # built runtime artifacts committed for plugin consumers
-├── .github/
-│   ├── hooks/       # GitHub/Copilot hook entrypoints
-│   ├── plugin/      # plugin metadata
-│   └── workflows/   # CI / release automation
-├── .copilot/
-│   ├── README.md                 # Copilot doc boundary
-│   ├── copilot-instructions.md   # Copilot-facing shared instructions
-│   ├── copilot-reference.md      # richer Copilot-specific reference
-│   ├── agents/                   # Copilot-facing agent docs
-│   ├── skills/                   # Copilot-facing skill docs
-│   └── plugin/skills/            # Copilot plugin-bundled skill docs
-└── spec/            # architecture and subsystem docs
-```
+---
 
-## Verification
+## Team Mode
 
-Before release or plugin publication, verify at least:
+tmux-first multi-worker orchestration with persistent state and lifecycle controls.
 
 ```bash
-npm run build
-npm run typecheck
-npm run test:coverage
-npm test
+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
 ```
 
-For plugin smoke checks, reinstall and verify the runtime surfaces:
+For GitHub Copilot CLI, team mode keeps `.copilot/` agent and skill assets synchronized while terminal workers coordinate through durable OMX/OMP state. Use it when a Copilot task needs separate implementation, verification, documentation, or release lanes and you want each lane to report evidence before the branch moves forward.
 
-```bash
-copilot plugin uninstall oh-my-githubcopilot
-copilot plugin install ./
-```
+---
 
-Then check:
+## Documentation
 
-```text
-/skills list
-/setup
-@executor
-/mcp show
-```
+- [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)
+
+---
+
+## License
+
+omp is open source under the [Apache-2.0 License](LICENSE).
+
+---
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/chart?repos=r3dlex/oh-my-githubcopilot&type=date&legend=top-left)](https://www.star-history.com/?repos=r3dlex%2Foh-my-githubcopilot&type=date&legend=top-left)
+
+## Sponsors
+
+If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️

package/README.pt.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)
+**Orquestração multiagente para GitHub Copilot CLI. Curva de aprendizado zero.**
 
-**Oh-My-Copilot (OMP)** e um plugin e extensao para GitHub Copilot que adiciona orquestracao moderna de workflows e capacidades de IA agentica sobre o Copilot.
+_Não aprenda GitHub Copilot CLI. Apenas use omp._
+
+[Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
 
 ---
 
-## Inicio Rapido
+## Por que omp?
+
+Toda equipe de software lida com implementação, arquitetura, revisão de segurança, testes e DevOps ao mesmo tempo. omp orquestra agentes especializados para que cada dimensão receba atenção especializada em paralelo.
+
+GitHub Copilot já é onde muitos desenvolvedores pedem ajuda; omp transforma essa superfície em uma equipe de engenharia coordenada. Ele mantém agentes, skills, hooks, configuração MCP e estado HUD voltados ao Copilot em um fluxo previsível, do prompt à entrega verificada.
+
+---
+
+<a id="quick-start"></a>
+## Início rápido
 
 ```bash
-# Instalacao
 npm install -g oh-my-githubcopilot
+omp setup --scope project
+omp
+```
+
+Depois do setup, reinicie sua CLI para que os comandos `/` apareçam.
+
+```bash
+omp doctor              # check prerequisites
+omp team run --task "..." --workers 2   # parallel work
+omp hud --watch         # live status
+```
+
+---
+
+## Recursos
+
+| 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>
+## Referência CLI
 
-# Configuracao
-omp setup
+| 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>
+## Fluxos de trabalho
+
+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
 ```
-<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>
+Para GitHub Copilot CLI, o modo team mantém os ativos de agentes e skills em `.copilot/` sincronizados enquanto workers de terminal se coordenam via estado durável OMX/OMP. Use quando uma tarefa do Copilot precisar de trilhas separadas de implementação, verificação, documentação ou release com evidências antes de avançar o branch.
+
 ---
 
-## Funcionalidades
+## Documentação
 
-- **Orquestracao Multi-Agente** - 18 agentes especializados para diferentes tarefas
-- **Integracao Servidor MCP** - Conexao com servicos e ferramentas externos
-- **Display HUD** - Rastreamento de estado e contexto em tempo real
-- **Plugin State Manager** - Estado confiavel entre sessoes
-- **30+ Skills** - Carregamento lento para funcionalidade estendida
+- [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)
 
 ---
 
-## Documentacao
+## Licença
 
-- [AGENTS.md](./AGENTS.md) - Registro de agentes e regras de delegacao
-- [spec/](./spec/) - Especificacoes de componentes
+omp is open source under the [Apache-2.0 License](LICENSE).
 
 ---
 
-## Licenca
+## Patrocinadores
 
-MIT
+If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️

package/README.ru.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)
+**Мультиагентная оркестрация для GitHub Copilot CLI. Без кривой обучения.**
 
-**Oh-My-Copilot (OMP)** - eto plugin i rasshirenie dlya GitHub Copilot, kotoroye dobavlyayet sovremennuyu orkestraciyu workflow i vozmozhnosti agentnogo II poverkh Copilot.
+_Не изучайте GitHub Copilot CLI. Просто используйте omp._
+
+[Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
 
 ---
 
-## Bystryy start
+## Зачем нужен omp?
+
+Любая команда одновременно занимается реализацией, архитектурой, проверкой безопасности, тестами и DevOps. omp оркестрирует специализированных агентов, чтобы каждое направление получало экспертное внимание параллельно.
+
+GitHub Copilot уже является местом, где многие разработчики просят помощи; omp превращает эту поверхность в согласованную инженерную команду. Он объединяет Copilot-агентов, навыки, хуки, MCP-настройку и HUD-состояние в предсказуемый процесс от промпта до проверенной поставки.
+
+---
+
+<a id="quick-start"></a>
+## Быстрый старт
 
 ```bash
-# Ustanovka
 npm install -g oh-my-githubcopilot
+omp setup --scope project
+omp
+```
+
+После настройки перезапустите CLI, чтобы появились команды `/`.
+
+```bash
+omp doctor              # check prerequisites
+omp team run --task "..." --workers 2   # parallel work
+omp hud --watch         # live status
+```
+
+---
+
+## Возможности
+
+| 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
 
-# Nastroyka
-omp setup
+| 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
 ```
-<p align="center">
-  <img src="assets/buddy-playful.png" alt="OMP in action" width="600"/>
-</p>
+
+Для GitHub Copilot CLI режим team синхронизирует агентские и skill-ресурсы в `.copilot/`, пока терминальные worker-процессы координируются через долговечное состояние OMX/OMP. Используйте его, когда задаче Copilot нужны отдельные линии реализации, проверки, документации или релиза с доказательствами перед продвижением ветки.
 
 ---
 
-## Funkcii
+## Документация
 
-- **Multi-Agent Orkestraciya** - 18 specializirovannykh agentov dlya razlichnykh zadach
-- **Integraciya MCP Server** - Podklyuchenie k vneshnim servisam i instrumentam
-- **HUD Display** - Otslezhivaniye sostoyaniya i konteksta v realnom vremeni
-- **Plugin State Manager** - Nadezhnoe upravleniye sostoyaniyem mezhdu sessionami
-- **30+ Skills** - Lenivaya zagruzka dlya rashirennykh vozmozhnostey
+- [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)
 
-<p align="center">
-  <img src="assets/buddy-swarm.png" alt="OMP swarm mode" width="600"/>
-</p>
 ---
 
-## Dokumentaciya
+## Лицензия
 
-- [AGENTS.md](./AGENTS.md) - Registraciya agentov i pravila delegirovaniya
-- [spec/](./spec/) - Specifikacii komponentov
+omp is open source under the [Apache-2.0 License](LICENSE).
 
 ---
 
-## Licenziya
+## Спонсоры
 
-MIT
+If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️