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

package/.claude-plugin/plugin.json

@@ -1,14 +1,24 @@
 {
+  "schemaVersion": "1.0",
   "name": "oh-my-githubcopilot",
-  "description": "Multi-agent orchestration for GitHub Copilot CLI. 23 agents, 25 skills, parallel execution, HUD, PSM, SWE-bench.",
-  "version": "1.4.1",
+  "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"
   },
   "repository": "https://github.com/r3dlex/oh-my-githubcopilot",
   "license": "Apache-2.0",
-  "keywords": ["orchestration", "multi-agent", "autopilot", "swe-bench", "hud"],
-  "agents": ["./src/agents"],
+  "keywords": [
+    "orchestration",
+    "multi-agent",
+    "autopilot",
+    "swe-bench",
+    "hud",
+    "copilot-cli"
+  ],
+  "agents": [
+    "./agents"
+  ],
   "skills": [
     "./skills/autopilot",
     "./skills/ralph",
@@ -34,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/.mcp.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": "1.0",
+  "mcpServers": {
+    "oh-my-githubcopilot": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["./dist/mcp/server.mjs"],
+      "env": {
+        "OMP_STATE_DB": "~/.omp/state/omp.db",
+        "OMP_FLEET_DB": "~/.omp/fleet/fleet.db",
+        "OMP_LOG_LEVEL": "info",
+        "OMP_COPILOT_REQUIRED_EXPERIMENTAL_FEATURES": "STATUS_LINE,SHOW_FILE,EXTENSIONS,BACKGROUND_SESSIONS,CONFIGURE_COPILOT_AGENT,MULTI_TURN_AGENTS,SESSION_STORE",
+        "OMP_COPILOT_STATUS_LINE_COMMAND": "./bin/omp-statusline.sh"
+      }
+    }
+  }
+}

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

@@ -1,13 +1,200 @@
 # Changelog
 
 All notable changes to **oh-my-githubcopilot** are documented here, ordered newest first.
-Each section corresponds to commits between conceptual version boundaries (no git tags exist yet — the CI pipeline introduced in v1.2.x will tag future releases automatically).
+
+---
+
+## 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
+
+- **Version manifests advanced** — `package.json`, `package-lock.json`, `plugin.json`, `.github/plugin/plugin.json`, `.github/plugin/marketplace.json`, and `.claude-plugin/plugin.json` now all target `1.5.7` for the next publishable release.
+- **Release docs aligned** — README, RELEASING, and build/release notes stay aligned with the current release workflow: bracketed changelog headings, root `plugin.json` → `.claude-plugin/plugin.json` sync, and coverage as a required release verification step.
+
+### Verification
+
+- **UltraQA release gate** — fresh verification on the release candidate remains green: `npm run build`, `npm run typecheck`, `npm test`, and `npm run test:coverage` all pass, with coverage still above the required floor (statements `89.35%`, branches `80.65%`, functions `93.65%`, lines `89.35%`).
+
+## [v1.5.6] — HUD watch daemon and model/budget fixes
+
+### Features
+
+- **HUD background watch daemon** — `omp hud --watch` (or `npm run hud:watch`) launches a daemon that polls session state every 2 seconds (configurable via `OMP_HUD_INTERVAL`), shows a real-time elapsed timer, and refreshes all three HUD artifacts on every cycle. SIGINT and SIGTERM are handled gracefully.
+
+### Fixes
+
+- **HUD model fallback** — corrected default model fallback from `claude-sonnet-4.5` to `claude-sonnet-4.6`.
+- **HUD token budget** — token budget is now resolved per-model from the `MODEL_CONTEXTS` map instead of using a fixed constant.
+- **HUD premium requests total** — total premium request count is now configurable via the `OMP_PREMIUM_REQUESTS_TOTAL` environment variable.
+- **HUD skills total** — `skillsTotal` corrected from 21 to 25, matching the actual number of shipped skills.
+- **Model router advisory** — updated the model-router advisory string to reference `claude-sonnet-4.6`.
+- **CLI coverage harness** — the `src/index.mts` test suite now executes the real `hud`, `hud --watch`, `version`, `psm`, `bench`, and unknown-subcommand flows so release coverage thresholds are protected by behavior-level assertions instead of placeholder checks.
+
+### Documentation
+
+- **Release docs aligned with current repo state** — README, release instructions, and build notes now agree on the bracketed changelog heading format, the root `plugin.json` → `.claude-plugin/plugin.json` sync step, and the need to run coverage as part of release verification.
+
+### Verification
+
+- **Fresh coverage evidence** — `npm run test:coverage` now reports `89.35%` statements, `80.65%` branches, `93.65%` functions, and `89.35%` lines.
+
+---
+
+## [v1.5.5] — Copilot docs move and release refresh
+
+### Documentation
+
+- **Copilot docs moved to `.copilot/`** — relocated Copilot-facing instructions, agent docs, skill docs, and plugin skill docs out of `.github/` so `.copilot/` is now the single home for Copilot-specific documentation.
+- **Adoption flow updated** — `scripts/omp-adopt.sh` now installs Copilot docs under `.copilot/` while leaving `.github/` focused on workflows, plugin metadata, and hook entrypoints.
+
+### Release readiness
+
+- **Next release metadata advanced** — package, plugin, marketplace, and Claude plugin manifests move to `1.5.5` so the post-STATUS_LINE and post-doc-relocation state is ready for the next release cut.
+- **Release notes refreshed** — changelog and release docs now reflect the `.copilot/` doc boundary and the new release target.
+- **GitHub CI stability** — switched Vitest from `vmThreads` to `forks` single-process execution to avoid the segmentation faults seen in GitHub Actions on the `1.5.5` prep branch while preserving the same local coverage thresholds.
+
+## [v1.5.4] — Experimental Copilot setup and STATUS_LINE integration
+
+### Features
+
+- **Experimental Copilot defaults in setup** — `omp setup` now merges the required Copilot experimental feature flags into `~/.copilot/config.json`, preserves existing flags and custom status-line commands, and writes the packaged OMP status-line command when needed.
+- **Packaged STATUS_LINE support** — added a dedicated `src/hud/statusline.mts` entrypoint plus `bin/omp-statusline.sh` wrapper so Copilot CLI can render OMP session state directly from the installed plugin.
+- **HUD artifact export for status line rendering** — `hud-emitter` now writes the minimal status-line artifacts needed by the STATUS_LINE command in addition to the legacy HUD line output.
+
+### Fixes
+
+- **Setup verification harness** — added direct temp-HOME setup tests so Copilot config merging is exercised without depending on the limited top-level `omp` CLI subcommand surface.
+- **STATUS_LINE verification harness** — updated HUD/statusline tests so temp-HOME artifact paths are asserted correctly and lint-cleanly under the new status-line flow.
+
+### Verification
+
+- **Coverage remains above release floor** — fresh coverage evidence remains above the required 80% thresholds: statements `88.26%`, branches `83.98%`, functions `92.4%`.
+- **Focused addendum verification** — setup and status-line focused suites, typecheck, lint, build, and wrapper smoke all pass on the merged leader tree, with the remaining skipped integration setup test called out as pre-existing infrastructure debt rather than an addendum regression.
+
+## [v1.5.3] — Release readiness and CI enforcement
+
+### Fixes
+
+- **Version bump for the next publishable release** — advanced package, plugin, marketplace, and Claude plugin manifests to `1.5.3`, which clears the existing `v1.5.1` / `v1.5.2` tag history and avoids the next release colliding with already-used versions.
+- **Real CI test failures** — removed the `|| true` bypasses from the main CI test and coverage jobs so GitHub Actions now fails when tests or coverage regress.
+- **Claude plugin manifest sync** — normalized `.claude-plugin/plugin.json` to a single version field by re-syncing it from the root `plugin.json`.
+
+### Verification
+
+- **Fresh coverage evidence** — `npm run test:coverage` now reports `88.26%` statements, `83.96%` branches, and `92.4%` functions, satisfying the repo's `80%` thresholds.
+- **Fresh local CI parity run** — `npm run typecheck`, `npm run lint`, `npm test`, `npm run build`, `npx archgate check`, and `npm pack --dry-run` all pass on the release candidate branch.
+
+### Documentation
+
+- **Release process clarified** — `RELEASING.md` now calls out syncing all plugin manifests plus marketplace metadata and choosing the next unreleased semver before tagging.
+
+## [v1.5.0] — Copilot CLI release alignment
+
+### Features
+
+- **Copilot-ready agent metadata** — normalized `src/agents/*.md` frontmatter for Copilot-compatible agent loading fields while preserving the existing prompt bodies.
+- **Copilot instructions refresh** — rewrote the Copilot instructions with an OMP overview, delegation guidance, agent catalog, skill catalog, HUD reference, and keyword quick reference, now carried under the Copilot-facing docs set instead of `.github/` docs.
+- **README quick start refresh** — replaced the install flow with `copilot plugin install ...`, `/omp:setup`, and first-run Copilot commands.
+
+### Fixes
+
+- **Version sync to `1.5.0`** — aligned `package.json`, `package-lock.json`, root/plugin manifests, and marketplace metadata on the release target.
+- **Plugin manifest agent path** — `.github/plugin/plugin.json` now points at `./agents` so the manifest matches the Copilot-facing agent bundle.
+- **Release notes alignment** — consolidated the current Copilot CLI packaging/runtime fixes under the `v1.5.0` release line for a single consumer-facing release target.
+
+### Documentation
+
+- **Release expectations clarified** — release docs now call out the committed `dist/` expectation for plugin consumers.
+
+---
+
+## [v1.4.2] — Dynamic version in HUD emitter
+
+### Fixes
+
+- **HUD version** — `hud-emitter` hook no longer hardcodes `"1.0.0"` as the session state version; reads from `package.json` via `createRequire` so `omp hud` always displays the installed package version
 
 ---
 
 ## [v1.4.1] — CLI shebang fix, dynamic version
 
 ### Fixes
+
 - **CLI shebang** — `bin/omp.mjs` now includes `#!/usr/bin/env node` banner (via esbuild `banner` option); the binary is executable directly without explicit `node` invocation (`550b764`)
 - **Dynamic version** — `omp version` now reads name and version from `package.json` at runtime via `createRequire`; no more hardcoded version string in source (`550b764`)
 
@@ -16,10 +203,12 @@ Each section corresponds to commits between conceptual version boundaries (no gi
 ## [v1.4.0] — Package renamed to oh-my-githubcopilot
 
 ### Breaking Changes
+
 - **Package renamed** — npm package renamed from `oh-my-copilot` to `oh-my-githubcopilot`; GitHub Packages now publishes as `@r3dlex/oh-my-githubcopilot`; install with `npm install oh-my-githubcopilot`
 - **Repository moved** — git remote updated to `git@github.com:r3dlex/oh-my-githubcopilot.git`
 
 ### Changes
+
 - All source files, tests, specs, docs, and manifests updated to reflect the new package name
 - MCP server identity updated to `oh-my-githubcopilot`
 - All 11 localized READMEs, archgate ADRs, and release docs updated
@@ -32,16 +221,19 @@ Each section corresponds to commits between conceptual version boundaries (no gi
 Commits: `fd366e6`…`a26f673`
 
 ### Features
+
 - **Continuous alpha releases** — every push to `main` publishes `X.Y.Z-alpha.<sha>` to the `alpha` dist-tag; tagged commits (`vX.Y.Z`) publish stable to `latest` (`ec8fffa`)
 - **Hybrid dual-registry publish** — publishes to GitHub Packages (`@r3dlex/oh-my-githubcopilot`) always via `GITHUB_TOKEN`; publishes to npmjs.com (`oh-my-githubcopilot`) when `NPM_TOKEN` secret is configured; graceful skip with notice if absent (`ee42604`)
 - **npm release CI pipeline** — `release.yml` with four jobs: `build` (version resolution + artifact), `test` (CHANGELOG gate for stable only), `publish` (dual-registry), `github-release` (stable only, attaches `.tgz`) (`5a3ae67`)
 
 ### Fixes
+
 - **Workflow parse error** — replaced `secrets.NPM_TOKEN != ''` in step `if:` conditions with a dedicated check step outputting `available=true/false` (`e82e807`)
 - **Version-agnostic plugin test assertions** — `plugin-install.test.mts` now reads version from `packageJson().version`; `marketplace.json` metadata.version synced (`7f99f14`)
 - **Stale agent/skill counts** — JSON descriptors and e2e tests corrected to 23 agents / 25 skills (`74c5122`)
 
 ### Documentation
+
 - **CHANGELOG rewritten** — entries now derived from actual git log commit ranges per version (`a26f673`)
 - **Agent and skill docs normalized** — all 23 agent descriptors and 25 skill `SKILL.md` files updated to consistent format (`fd366e6`)
 
@@ -52,6 +244,7 @@ Commits: `fd366e6`…`a26f673`
 Commits: `a234799`, `feb5e65` (PR #10)
 
 ### Features
+
 - **GraphProvider abstraction** — new `src/graph/` module with `GraphBuildable` and `GraphWikiClient` interfaces; provider resolved from `.omp/config.json` `graph.provider` with local > global > default (`graphwiki`) resolution
 - **GraphifyAdapter** — extracted graphify CLI wrapper from `src/skills/graphify.mts` into `src/graph/graphify-adapter.mts`; graphify skill now delegates to the adapter (public API unchanged)
 - **GraphwikiAdapter** — new `src/graph/graphwiki-adapter.mts` wrapping the `graphwiki` npm CLI (`npm install -g graphwiki`); implements both `GraphBuildable` and `GraphWikiClient`
@@ -61,6 +254,7 @@ Commits: `a234799`, `feb5e65` (PR #10)
 - **keyword-detector wiring** — 8 new keyword entries: `graphify:`, `graphwiki:`, `graph:`, `spending:`, `/graphify`, `/graphwiki`, `/graph-provider`, `/spending`
 
 ### Fixes
+
 - **plugin.json** — removed non-existent `./agents` path from agents array; added `graphify`, `graphwiki`, `graph-provider`, `spending` to skills list (25 skills total)
 - **gitignore** — untracked `coverage/.tmp`, `.omc/` state files, `devops.md` (`a234799`)
 
@@ -71,10 +265,12 @@ Commits: `a234799`, `feb5e65` (PR #10)
 Commits: `ce6f3bd`…`051ac20` (PR #9)
 
 ### Features
+
 - **HUD format: `tools:N` → `tools:N/M`** — all count fields (tools, skills, agents) now display as used/total (e.g., `tools:12/13`, `skills:5/25`, `agents:3/23`); added `toolsTotal`, `skillsTotal`, `agentsTotal` fields to `HudState` and `HudMetrics`
 - **CLI elicitation support** — expanded OMP setup wizard to handle interactive CLI prompts during MCP config generation
 
 ### Fixes
+
 - **CI: zero-install artifact pattern** — build artifact uploaded once in `build` job and downloaded in `test`/`publish` jobs; eliminates redundant `npm install` across CI jobs (`d46f647`)
 - **CI: vitest hanging** — added `< /dev/null` stdin redirect and `timeout 120` to prevent vitest blocking indefinitely in non-TTY environments (`fa9fdfb`)
 - **CI: vitest `--forceExit`** — added flag to ensure process exits after tests complete in CI (`c88c2c7`)
@@ -91,6 +287,7 @@ Commits: `804fc37`…`0f96d48` (initial implementation + `6ee243f` rename)
 Initial release of **oh-my-githubcopilot (OMP)** — a multi-agent orchestration plugin for GitHub Copilot CLI.
 
 ### Features
+
 - **23 specialized agents** via Claude Code subagents: orchestrator, explorer, planner, executor, verifier, writer, reviewer, designer, researcher, tester, debugger, architect, security-reviewer, simplifier, test-engineer, critic, tracer, scientist, code-reviewer, document-specialist, qa-tester, git-master, analyst
 - **22 skills** including: `setup`, `mcp-setup`, `autopilot`, `ralph`, `ultrawork`, `team`, `ecomode`, `swarm`, `pipeline`, `plan`, `omp-plan`, `hud`, `note`, `trace`, `learner`, `swe-bench`, `wiki`, `psm`, `release`, `graphify`, `spending`, `spawn`
 - **6 hooks**: `keyword-detector`, `delegation-enforcer`, `model-router`, `token-tracker`, `hud-emitter`, `stop-continuation`
@@ -104,6 +301,7 @@ Initial release of **oh-my-githubcopilot (OMP)** — a multi-agent orchestration
 - **OMP rename** — project renamed from `oh-my-claudecode (OMC)` to `oh-my-githubcopilot (OMP)` targeting GitHub Copilot CLI (`6ee243f`)
 
 ### Documentation
+
 - `AGENTS.md` — agent registry and delegation rules
 - `CLAUDE.md` — project instructions and quick reference
 - `SECURITY.md` — vulnerability reporting policy

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