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

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0",
   "name": "oh-my-githubcopilot",
-  "version": "1.5.7",
-  "description": "Multi-agent orchestration for GitHub Copilot CLI. 23 agents, 25 skills, parallel execution, HUD, PSM, SWE-bench.",
+  "version": "1.8.0",
+  "description": "Multi-agent orchestration for GitHub Copilot CLI. 23 agents, 39 skills, parallel execution, HUD, PSM, SWE-bench.",
   "author": {
     "name": "r3dlex"
   },
@@ -16,7 +16,9 @@
     "hud",
     "copilot-cli"
   ],
-  "agents": ["./agents"],
+  "agents": [
+    "./agents"
+  ],
   "skills": [
     "./skills/autopilot",
     "./skills/ralph",
@@ -42,8 +44,28 @@
     "./skills/graphify",
     "./skills/graphwiki",
     "./skills/graph-provider",
-    "./skills/spending"
+    "./skills/spending",
+    "./skills/ralplan",
+    "./skills/research",
+    "./skills/omp-doctor",
+    "./skills/omp-reference",
+    "./skills/ai-slop-cleaner",
+    "./skills/tdd",
+    "./skills/improve-codebase-architecture",
+    "./skills/skillify",
+    "./skills/interview",
+    "./skills/graph-context",
+    "./skills/interactive-menu",
+    "./skills/notifications",
+    "./skills/doctor",
+    "./skills/session"
   ],
   "hooks": "./hooks/hooks.json",
-  "mcp": "./.mcp.json"
+  "mcp": "./.mcp.json",
+  "entryPoints": {
+    "cli": "./bin/omp.mjs",
+    "mcp": "./dist/mcp/server.mjs"
+  },
+  "agentFormat": ".agent.md",
+  "agentFilePattern": "*.agent.md"
 }

package/AGENTS.md

@@ -14,7 +14,7 @@ The orchestrator is the top-level coordinator. It:
 
 The orchestrator **never writes code, docs, or configs directly**. It always delegates to a specialized agent.
 
-## Agent Registry (23 Agents)
+## Agent Registry (22 Agents)
 
 | # | ID | Tier | Tools | Role |
 |---|-----|------|-------|------|
@@ -31,7 +31,7 @@ The orchestrator **never writes code, docs, or configs directly**. It always del
 | 11 | `debugger` | high | Bash, Read, LSP, Grep | Error diagnosis, crash analysis |
 | 12 | `architect` | high | Read, Write, Glob | System design, cross-cutting concerns |
 | 13 | `security-reviewer` | high | Grep, Glob, Read | Vulnerability scanning, dependency audit |
-| 14 | `simplifier` | high | Read, Edit, Grep | Code reuse, quality, efficiency improvements |
+| 14 | `code-simplifier` | high | Read, Edit, Grep | Code simplification, clarity, maintainability |
 | 15 | `test-engineer` | standard | Bash, Read, Write | Test authoring, coverage analysis |
 | 16 | `critic` | high | Read, Grep, Write | Plan review, gap analysis, improvement suggestions |
 | 17 | `tracer` | high | Bash, Read, Grep | Causal investigation, root cause analysis |
@@ -40,7 +40,6 @@ The orchestrator **never writes code, docs, or configs directly**. It always del
 | 20 | `document-specialist` | standard | Read, Write, Grep | Technical docs, API docs, guides |
 | 21 | `qa-tester` | standard | Bash, Read, Write | QA testing, regression verification |
 | 22 | `git-master` | standard | Bash, Read, Grep | Atomic commits, history management |
-| 23 | `analyst` | high | Read, Grep | Requirements analysis, gap identification |
 
 ## Delegation Rules
 
@@ -55,11 +54,11 @@ Never skip verification. Never claim completion without evidence.
 
 ## Model Selection Guidelines
 
-| Tier | Model | When to use |
-|------|-------|-------------|
-| High | `opus` | Security, architecture, complex multi-file refactors, PR reviews |
-| Standard | `sonnet` | Feature implementation, testing, documentation |
-| Fast | `haiku` | Quick lookups, simple edits, documentation updates, glob/grep passes |
+| Tier | Models | When to use |
+|------|--------|-------------|
+| High | `gemini-3.5-flash`, `claude-opus-4.7`, `claude-sonnet-4.6`, `gemini-3.1-pro`, `gpt-5.5`, `gpt-5.4` | Security, architecture, complex multi-file refactors, PR reviews, agentic coding |
+| Standard | `claude-sonnet-4.5`, `claude-haiku-4.5`, `gpt-5.4-mini`, `deepseek-v3` | Feature implementation, testing, documentation |
+| Fast | `gpt-5.4-nano`, `gpt-5-mini`, `raptor-mini` | Quick lookups, simple edits, documentation updates, glob/grep passes |
 
 ## Execution Mode Handling
 
@@ -75,6 +74,7 @@ When an execution mode is active, follow its skill instructions exactly:
 | `swarm` | Magic keyword or `/swarm:` | Swarm orchestration. Multiple agents with shared state. |
 | `pipeline` | Magic keyword or `/pipeline:` | Sequential pipeline mode. Strict phase ordering. |
 | `plan` | Magic keyword or `/plan:` | Strategic planning. Use planner agent; delay implementation. |
+| `ralplan` | Magic keyword or `ralplan:` | Consensus planning entrypoint that auto-gates vague ralph/autopilot/team requests. |
 
 ## HUD Awareness
 
@@ -102,6 +102,75 @@ See `spec/HOOKS.md` for hook schema and registration.
 
 Skills extend agent capabilities. See `spec/SKILLS.md` for the full registry and lazy loading mechanism.
 
+### Magic Keyword Triggers
+
+| Keyword | Skill | Purpose |
+|---------|-------|---------|
+| `autopilot:` / `/autopilot` | `autopilot` | Autonomous end-to-end execution |
+| `ralph:` / `/ralph` | `ralph` | Self-referential loop until task complete |
+| `ulw:` / `ultrawork:` / `/ulw` | `ultrawork` | Parallel high-throughput execution |
+| `team:` / `/team` | `team` | Multi-agent session on shared task list |
+| `eco:` / `ecomode:` / `/eco` | `ecomode` | Token budget mode |
+| `swarm:` / `/swarm` | `swarm` | Swarm orchestration with shared state |
+| `pipeline:` / `/pipeline` | `pipeline` | Sequential phase-ordered pipeline |
+| `plan:` / `/plan` | `omp-plan` | Strategic planning with interview workflow |
+| `ralplan:` | `ralplan` | Consensus planning entrypoint; gates vague ralph/autopilot/team requests |
+| `deslop` | `ai-slop-cleaner` | Clean AI-generated code slop; regression-safe, deletion-first |
+| `tdd:` | `tdd` | Test-driven development workflow |
+| `autoresearch:` | `research` | External research via parallel document-specialist agents |
+
 ## Plugin Integration
 
-OMP is a GitHub Copilot CLI plugin. Plugin manifest, discovery paths, and cross-compatibility are defined in `spec/PLUGIN.md`.
+OMP is a GitHub Copilot CLI plugin. Plugin manifest, discovery paths, and cross-compatibility are defined in `spec/PLUGIN.md`.
+<!-- ai-sdlc-init:start -->
+
+## AI SDLC Methodology
+
+This repository uses the AI SDLC methodology scaffolded by `ai-sdlc-init`.
+
+### Architecture Decision Records
+
+Significant architectural decisions are recorded in [`docs/adr/`](docs/adr/).
+Before making a change that affects module boundaries, API contracts, data
+schemas, or dependency direction, check whether a relevant ADR exists.
+If your change contradicts an existing ADR, either update the ADR or open a
+discussion before proceeding.
+
+### Archgate Rules
+
+Code quality rules are defined in [`.rules.ts`](.rules.ts) across five domains:
+`backend`, `frontend`, `data`, `architecture`, `general`. Rules carry a severity
+(`error`, `warn`, `info`). Structural validation of `.rules.ts` runs in CI via
+the `validate-rules` prek hook. Semantic enforcement (did the PR violate a rule?)
+is an agent behavior at PR review time.
+
+### Karpathy Baseline
+
+All agents operating in this repository load
+[`.agents/skills/karpathy-guidelines/SKILL.md`](.agents/skills/karpathy-guidelines/SKILL.md)
+as a baseline. Four rules apply to every task: Think Before Coding, Simplicity
+First, Surgical Changes, Goal-Driven Execution. See the SKILL.md for violation
+and correction examples.
+
+### Drift Verification Protocol
+
+At PR review time, the reviewing agent:
+1. Loads the PR diff alongside the BRD, PRD, acceptance criteria, and any ADRs
+   whose scope overlaps with the changed files.
+2. Produces a drift report identifying whether changes match ACs, conflict with
+   ADRs, or violate architectural constraints from `.rules.ts`.
+3. Leaves the drift report as a PR comment or review summary.
+
+This is a documented agent behavior. It is not enforced as a CI gate in this
+iteration.
+
+### Circuit Breaker Protocol
+
+Before starting work on an issue:
+1. Check whether ≥ 3 prior attempts exist without resolution (look for
+   `attempts:N` labels or a comment history showing repeated failures).
+2. If the circuit is tripped (≥ 3 attempts, no resolution), escalate to a
+   human with a written summary of what was tried and what blocked each attempt.
+3. Do not make a fourth attempt without human acknowledgement.
+
+<!-- ai-sdlc-init:end -->

package/CHANGELOG.md

@@ -4,6 +4,98 @@ All notable changes to **oh-my-githubcopilot** are documented here, ordered newe
 
 ---
 
+## oh-my-githubcopilot v1.8.0 — 2026-05-25
+
+### Features
+
+- **Cross-repo sync**: Aligned README template, Star History chart, sponsor links, and badge shields with OMX/OMC/OMA/OMG
+- **Dual publish**: GitHub Actions release workflow now publishes to both npmjs.com (oh-my-githubcopilot) and GitHub Packages (@r3dlex/oh-my-githubcopilot) with version verification
+- **README updates**: 12 localized README files regenerated from unified template
+- **AI SDLC methodology**: Scaffolded across the repo with Archgate rules, ADR governance, Karpathy guidelines
+
+### Documentation
+
+- Updated READMEs across 13 languages (en, de, es, fr, it, ja, ko, pt, ru, tr, vi, zh)
+- Star History chart added for r3dlex/oh-my-githubcopilot
+- Sponsor link updated to github.com/sponsors/r3dlex
+
+---
+
+## oh-my-githubcopilot v1.7.0 — 2026-04-21
+
+### Features
+
+- **vscode-omp**: Add VS Code extension for real-time workflow/agent visualization
+  - Workflows, Agents, Tasks panels in the activity bar
+  - StateReader interface with OmpStateAdapter (reads `.omc/state/*-state.json` and `subagent-tracking.json`)
+  - 200ms debounced FileSystemWatcher — prevents UI thrashing during heavy execution
+  - Live status bar showing active workflow count and running agents
+  - MCP server provider registration
+
+---
+
+## oh-my-githubcopilot v1.6.0 — 2026-04-21
+
+### Features
+
+- **14 new skills — 25 → 39 total** — ported and adapted from oh-my-claudecode and oh-my-auggie:
+  - `ralplan` — consensus planning mode via `omp-plan --consensus`; triggers `/omp:ralplan`
+  - `research` — autonomous autoresearch workflow; triggers `/omp:research`
+  - `omp-doctor` — OMP installation diagnostics; triggers `/omp:omp-doctor`
+  - `omp-reference` — internal agent catalog (non-invocable)
+  - `ai-slop-cleaner` — AI-slop detection and prose cleanup; triggers `deslop`
+  - `tdd` — Red-Green-Refactor TDD workflow; triggers `/omp:tdd`
+  - `improve-codebase-architecture` — architecture improvement advisor; triggers `/omp:improve-codebase-architecture`
+  - `skillify` — convert ad-hoc prompts into reusable skills; triggers `/omp:skillify`
+  - `interview` — short-form interview mode (distinct from `deep-interview`); triggers `interview:`
+  - `graph-context` — auto-injected knowledge-graph context (non-user-triggered)
+  - `interactive-menu` — numbered-choice conversational TUI pattern (non-user-triggered)
+  - `notifications` — runtime notification delivery (distinct from `configure-notifications`); triggers `notifications:`
+  - `doctor` — general Socratic root-cause analysis (distinct from `omp-doctor`); triggers `doctor:`
+  - `session` — worktree/tmux session lifecycle management (distinct from `psm`); triggers `session:`
+- **`omp-plan` extended with consensus mode** — `--consensus` flag added; Planner→Architect→Critic loop (max 5 iterations)
+
+### Fixes
+
+- **keyword-detector** — registered all 14 new skill aliases (`doctor:`, `/doctor`, `/omp:doctor`, `interview:`, `/interview`, `/omp:interview`, `notifications:`, `/notifications`, `/omp:notifications`, `session:`, `/session`, `/omp:session`, `/omp:omp-doctor`, `/omp:ralplan`, `/omp:research`, `--consensus`) into `KEYWORD_MAP`
+- **graph-context / interactive-menu SKILL.md** — changed `trigger:` to `invocation:` so the keyword-detector test does not attempt to use their descriptive values as literal aliases
+
+### CI / Release
+
+- **npm Trusted Publishing** — replaced long-lived `NPM_TOKEN` secret with OIDC Trusted Publishing on npmjs.com; publish step now relies on `id-token: write` + `--provenance` with no stored secret
+
+### Verification
+
+- All 849 tests pass (1 integration test intentionally skipped)
+- Coverage: statements 87.89% / branches 85.49% / functions 94.64% — all above 80% threshold
+- Build, typecheck, and archgate check all pass
+
+## [1.5.9] — 2026-04-17
+
+### Features
+
+- **OMP CLI auto-update prompt** — added a launch-time npm update check for `omp` with OMX-style guardrails:
+  - interactive TTY only
+  - non-fatal failures
+  - 12-hour TTL cache at `~/.omp/state/update-check.json`
+  - disable via `OMP_AUTO_UPDATE=0` or `OMP_DISABLE_UPDATE_CHECK=true`
+  - prompt suppression for low-value commands (for example `omp version`)
+- **CLI front door wiring** — `src/index.mts` now invokes the update checker before command execution and treats
+  `--version` as the `version` command.
+
+### Verification
+
+- **CLI coverage expanded** — added dedicated update-flow tests under `tests/cli/update.test.mts` and extended
+  `tests/cli/index.test.mts` to assert update-check integration at the command entrypoint.
+
+## [1.5.8] — 2026-04-16
+
+### Improved
+- Raised test coverage across hooks, mcp, and psm modules
+- Branch coverage: 80.65% → 85.65% (+5pp above 80% threshold)
+- Statement coverage: 89.35% → 93.95%; Function coverage: 93.65% → 95.23%
+- New test files: stop-continuation, token-tracker (hooks), memory-store, state-manager (mcp), session, worktree (psm)
+
 ## [v1.5.7] — Release readiness refresh
 
 ### Release readiness

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) ❤️