ur-agent 1.23.3 → 1.24.1

package/docs/AGENT_FEATURES.md

@@ -64,6 +64,14 @@ ur spec run auth-refactor --all
 ur spec verify auth-refactor
 ```
 
+## v1.24.0 Additions
+
+| Addition | Surface | What it adds |
+| --- | --- | --- |
+| Plugin marketplace capability surfaces | `.ur-plugin/marketplace.json`, `src/utils/plugins/schemas.ts`, `plugins/core/engineering-discipline/` | Marketplace entries can advertise MCP tools, executable skills, templates, validators, language adapters, LSP servers, hooks, agents, and commands. The `engineering-discipline` reference plugin ships a command, reproducible-release skill, release-verifier template, release-gate validator, and Markdown adapter metadata. |
+| Autonomous engineering workflow identity | `README.md`, `documentation/`, `plugins/core/engineering-discipline/skills/reproducible-release` | Positions UR as an autonomous engineering workflow engine: plan, execute, test, verify, document, benchmark, and reproduce, with command evidence and rollback discipline as the product promise. |
+| Release readiness guard | `.github/workflows/test.yml`, `test/releaseReadiness.test.ts` | Asserts production bundle, release, package, and global-install checks run only after the Bun test step succeeds in GitHub CI. |
+
 ## v1.22.3 Additions
 
 | Addition | Surface | What it adds |

package/docs/AGENT_UPGRADE_1.15.0.md

@@ -1,4 +1,4 @@
-# UR Agent 1.15.0 Upgrade Notes
+# UR-AGENT 1.15.0 Upgrade Notes
 
 UR 1.15.0 keeps the agent local-first and Ollama-centered. The new agent
 platform surfaces do not add Anthropic, OpenAI, or other direct provider API

package/docs/AGENT_UPGRADE_1.16.0.md

@@ -1,4 +1,4 @@
-# UR Agent 1.16.0 Upgrade Notes
+# UR-AGENT 1.16.0 Upgrade Notes
 
 UR 1.16.0 adds local-network Ollama discovery. The agent can now find Ollama
 servers on your LAN, let you pick one at startup, and remember the choice for

package/docs/AGENT_UPGRADE_1.17.0.md

@@ -1,4 +1,4 @@
-# UR Agent 1.17.0 Upgrade Notes
+# UR-AGENT 1.17.0 Upgrade Notes
 
 UR 1.17.0 adds the P0 reliable repo editing surface.
 

package/docs/AGENT_UPGRADE_1.18.0.md

@@ -1,4 +1,4 @@
-# UR Agent 1.18.0 Upgrade Notes
+# UR-AGENT 1.18.0 Upgrade Notes
 
 UR 1.18.0 adds the P0 test-first execution loop.
 

package/docs/AGENT_UPGRADE_1.19.0.md

@@ -1,4 +1,4 @@
-# UR Agent 1.19.0 Upgrade Notes
+# UR-AGENT 1.19.0 Upgrade Notes
 
 UR 1.19.0 adds two P0 agent reliability surfaces: project safety policy and
 project context packing.

package/docs/AGENT_UPGRADE_1.20.0.md

@@ -1,4 +1,4 @@
-# UR Agent 1.20.0 Upgrade Notes
+# UR-AGENT 1.20.0 Upgrade Notes
 
 UR 1.20.0 adds IDE integration and a richer tool surface for agent workflows.
 

package/docs/AGENT_UPGRADE_1.21.0.md

@@ -1,4 +1,4 @@
-# Upgrading to UR Agent v1.21.0
+# Upgrading to UR-AGENT v1.21.0
 
 ## What's new
 

package/docs/AGENT_UPGRADE_1.22.0.md

@@ -1,4 +1,4 @@
-# Upgrading to UR Agent v1.22.0
+# Upgrading to UR-AGENT v1.22.0
 
 ## What's new
 

package/docs/CODE_FEATURE_INVENTORY.md

@@ -1,4 +1,4 @@
-# UR Agent code feature inventory
+# UR-AGENT code feature inventory
 
 This file is a code-derived inventory of what this agent can do in the
 `ur-agent` 1.19.0 source tree. It is meant to cover behavior that is easy to
@@ -22,7 +22,7 @@ Sources traced include:
 - `src/utils/plugins/**`
 - `src/entrypoints/mcp.ts`
 - `src/sdk/index.ts`
-- `marketplace-plugins/**`
+- `plugins/core/**`
 
 Notes:
 
@@ -853,10 +853,14 @@ Plugin loading supports:
 - plugin commands
 - plugin agents
 - plugin skills
+- plugin templates
+- plugin validators
 - plugin hooks
 - output styles
 - MCP servers
 - LSP servers
+- language adapters
+- marketplace capability metadata
 - plugin settings
 - duplicate-name handling
 - enable/disable state
@@ -872,7 +876,7 @@ Plugin loading supports:
 - strict known-marketplace policy
 - managed plugin settings
 
-Bundled marketplace plugin families in `marketplace-plugins/**`:
+Bundled marketplace plugin families in `plugins/core/**`:
 
 - code review
 - evaluate response
@@ -890,6 +894,8 @@ Bundled marketplace plugin families in `marketplace-plugins/**`:
 - PowerPoint deck creation, markdown-to-deck, review, theme, and deck-craft
   skill
 - release notes
+- reproducible release discipline, release-gate validator, release verifier
+  template, and Markdown language-adapter metadata
 - skill forge and skill authoring
 - Word document creation, markdown-to-docx, edit, review, and document-craft
   skill

package/docs/DEVELOPMENT.md

@@ -10,6 +10,8 @@
 - `src/services/` contains API, MCP, analytics, sync, safety, context, and
   runtime services.
 - `src/components/` and `src/ink/` implement the terminal UI.
+- `plugins/core/`, `plugins/community/`, and `plugins/examples/` contain
+  shipped plugins, contributed plugin staging, and copyable plugin templates.
 - `examples/` contains example prompts and workflows.
 - `test/` contains Bun tests for local UR utility modules.
 
@@ -34,11 +36,13 @@ bun run dev
 bun run typecheck
 bun run lint
 bun test
-bun run bundle
+bun run build
 bun run smoke
 bun run secrets:scan
 bun run release:check
+bun run package:check
 npm pack --dry-run
+npm publish --dry-run
 ```
 
 Use `ur test-first detect` when adding a feature to inspect the repository's
@@ -50,7 +54,7 @@ shell commands. Use `ur context-pack scan` when a change adds new manifests,
 command surfaces, or architecture rules that should be captured as project
 context.
 
-The GitHub install path uses the bundled launcher in `dist/cli.js`, so `bun run bundle` must be run before packaging or pushing a release. `bun run release:check` verifies that `package.json`, `bunfig.toml`, the bundle, docs, and `node ./bin/ur.js --version` agree.
+The GitHub install path uses the bundled launcher in `dist/cli.js`, so `bun run bundle` must be run before packaging or pushing a release. `bun run release:check` verifies that `package.json`, `bunfig.toml`, the bundle, docs, and `node ./bin/ur.js --version` agree. The GitHub workflow keeps production bundle, release, package, and global-install checks behind the Bun test step; do not publish, tag, or push release artifacts until that workflow is green.
 
 ## Build
 
@@ -70,7 +74,7 @@ only the root README. Check:
 - `docs/`
 - `documentation/`
 - `examples/`
-- extension and marketplace README files when the feature affects them
+- extension and plugin README files when the feature affects them
 
 For top-level commands, also update the static documentation site command data
 in `documentation/app.js` and any relevant tutorial section in
@@ -93,7 +97,7 @@ ur --version
 This package is configured for install without cloning:
 
 ```sh
-bun add -g github:Maitham16/UR-mapek
+bun add -g github:Maitham16/UR
 ```
 
 The package exposes the global `ur` command from `bin/ur.js`. That launcher reads `package.json` for version and repository metadata, then runs `src/entrypoints/cli.tsx` with Bun.

package/docs/USAGE.md

@@ -153,7 +153,9 @@ UR includes slash commands and CLI subcommands for common workflows:
 
 - `/help` or `ur --help` for command discovery
 - `ur mcp ...` to configure MCP servers
-- `ur plugin ...` to manage plugins and marketplaces
+- `ur plugin ...` to manage plugins and marketplaces. Marketplace plugins can
+  add MCP tools, commands, executable skills, templates, validators, language
+  adapters, LSP servers, agents, hooks, and output styles.
 - `ur agents` to list configured agents
 - `ur agent-trends` to inspect coverage for current agent technology trends
 - `ur a2a card` to print UR's Agent Card metadata for A2A discovery
@@ -185,6 +187,21 @@ UR includes slash commands and CLI subcommands for common workflows:
 
 Interactive sessions also check the published package version and show
 `Update available: <current> -> <latest>` when a newer release is available.
+Source checkouts print
+`Development build detected. To update, pull latest source or install from npm.`
+instead of attempting to mutate the checkout.
+
+## Status bar
+
+Interactive sessions include a compact bottom status bar when stdout is a real
+terminal:
+
+```text
+UR-AGENT v1.24.0 | model: qwen3-coder:480b-cloud | mode: ask | branch: main | tasks: idle | Update: 1.23.3 -> 1.24.0 available
+```
+
+The bar is not rendered in non-interactive mode, CI, dumb terminals, or
+assistant viewer mode. Custom status-line hooks override the built-in bar.
 
 Run each command with `--help` for exact flags.
 

package/docs/VALIDATION.md

@@ -11,14 +11,14 @@ You need:
   work because UR talks to the configured Ollama host.
 - A second Ollama server on the LAN if you want to test network discovery.
 - UR installed globally (`npm install -g ur-agent`) or this repo installed
-  globally (`bun add -g github:Maitham16/UR-mapek`) or a
+  globally (`bun add -g github:Maitham16/UR`) or a
   local checkout (`bun run dev`).
 
 ## 0. Smoke
 
 ```sh
 ur --version
-# expected: 1.19.0 (Ur)
+# expected: 1.24.1 (UR-AGENT)
 ```
 
 ## 0.1 Permission safety and context pack (1.19.0)
@@ -125,7 +125,7 @@ Then inside:
 
 Expected: the plugin picker lists `ur-plugins-official` and `hello`. If the
 marketplace failed to clone, you'll see no entries — fall back to
-`/plugin marketplace add github:Maitham16/UR-mapek` and re-run `/plugin`.
+`/plugin marketplace add github:Maitham16/UR` and re-run `/plugin`.
 
 Install `hello`:
 
@@ -295,7 +295,7 @@ Expected: no `unknown option` or `too many arguments` parser errors.
 ## What to do if any step fails
 
 - Step 1 (marketplace): check `ls ~/.ur/marketplaces/` — `ur-plugins-official`
-  should be there. If absent, `gh repo clone Maitham16/UR-mapek` manually
+  should be there. If absent, `gh repo clone Maitham16/UR` manually
   into `~/.ur/marketplaces/ur-plugins-official` as a fallback.
 - Steps 2-5 (verifier): set `UR_VERIFIER_MODE=off` and re-run to confirm
   the issue is the verifier path, not the rest of the loop. Then file an

package/docs/plugins.md

@@ -0,0 +1,52 @@
+# UR-AGENT plugins
+
+UR-AGENT plugins are trusted local extension bundles. They can contribute slash
+commands, MCP servers, executable skills, templates, validators, language
+adapters, LSP servers, hooks, output styles, and agents.
+
+## Repository layout
+
+```text
+plugins/
+  core/        # first-party plugins shipped with UR-AGENT
+  community/   # contributed plugins staged for review
+  examples/    # templates users can copy
+src/plugins/   # built-in plugin registration code
+```
+
+The official marketplace manifest lives at `.ur-plugin/marketplace.json` and
+uses local paths such as `./plugins/core/hello`. It does not depend on previous
+repositories.
+
+## Create a plugin
+
+Copy the command template:
+
+```bash
+cp -R plugins/examples/command-template plugins/community/my-plugin
+```
+
+Edit:
+
+```text
+plugins/community/my-plugin/.ur-plugin/plugin.json
+plugins/community/my-plugin/commands/example.md
+```
+
+Then run it locally:
+
+```bash
+ur --plugin-dir ./plugins/community/my-plugin
+```
+
+## Add a first-party marketplace plugin
+
+1. Put the plugin under `plugins/core/<name>/`.
+2. Keep its manifest at `plugins/core/<name>/.ur-plugin/plugin.json`.
+3. Add an entry to `.ur-plugin/marketplace.json` with `source` set to
+   `./plugins/core/<name>`.
+4. Set `capabilities` accurately so users know what the plugin enables.
+5. Run `bun test test/marketplaceTree.test.ts` before submitting.
+
+Plugins are loaded from local UR-AGENT paths first. Network marketplace installs
+remain explicit user actions and are subject to plugin policy checks.

package/documentation/README.md

@@ -1,6 +1,6 @@
-# UR Agent Documentation Site
+# UR-AGENT Documentation Site
 
-This folder is a static documentation project for UR Agent.
+This folder is a static documentation project for UR-AGENT.
 
 Open `index.html` directly in a browser. No build step or dev server is
 required.

package/documentation/app.js

@@ -50,7 +50,7 @@ const featureGroups = [
   {
     title: 'Interoperability',
     tags: ['MCP', 'plugins', 'A2A', 'SDK'],
-    text: 'MCP servers, plugin marketplaces, A2A Agent Card and task server, delegation tokens, and a TypeScript SDK wrapper around headless UR.',
+    text: 'MCP servers, plugin marketplaces for skills, templates, validators, language adapters, A2A Agent Card and task server, delegation tokens, and a TypeScript SDK wrapper around headless UR.',
     commands: ['ur mcp', 'ur plugin', 'ur a2a', 'ur sdk'],
   },
   {
@@ -66,7 +66,7 @@ const commands = [
     name: 'ur',
     category: 'Core',
     aliases: [],
-    summary: 'Start an interactive UR Agent session in the current workspace.',
+    summary: 'Start an interactive UR-AGENT session in the current workspace.',
     examples: ['ur', 'ur --model qwen3-coder:480b-cloud', 'ur --continue', 'ur --resume'],
   },
   {
@@ -297,8 +297,8 @@ const commands = [
     name: 'plugin',
     category: 'Interop',
     aliases: ['plugins'],
-    summary: 'Manage UR plugins and plugin marketplaces.',
-    examples: ['ur plugin list', 'ur plugin install hello@ur-plugins-official', 'ur plugin update <plugin>', 'ur plugin disable <plugin>'],
+    summary: 'Manage UR plugins and marketplaces for MCP tools, skills, templates, validators, and language adapters.',
+    examples: ['ur plugin list', 'ur plugin install hello@ur-plugins-official', 'ur plugin install engineering-discipline@ur-plugins-official', 'ur plugin update <plugin>', 'ur plugin disable <plugin>'],
   },
   {
     name: 'repo-edit',
@@ -374,7 +374,7 @@ const commands = [
     name: 'update',
     category: 'Ops',
     aliases: ['upgrade'],
-    summary: 'Check for updates and install if available. Interactive sessions also show an update-available notice when a newer package is published.',
+    summary: 'Check npm for UR-AGENT updates. Interactive sessions also show an update-available notice when a newer package is published.',
     examples: ['ur update', 'ur upgrade'],
   },
   {

package/documentation/assets/ur-architecture.svg

@@ -1,5 +1,5 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1120" height="560" viewBox="0 0 1120 560" role="img" aria-labelledby="title desc">
-  <title id="title">UR Agent runtime architecture</title>
+  <title id="title">UR-AGENT runtime architecture</title>
   <desc id="desc">A diagram showing users, the UR CLI, project context, tools, agent orchestration, local Ollama models, and outputs.</desc>
   <defs>
     <linearGradient id="panel" x1="0" x2="1" y1="0" y2="1">

package/documentation/index.html

@@ -3,8 +3,8 @@
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title>UR Agent Documentation</title>
-    <meta name="description" content="Professional documentation, tutorials, examples, and command reference for UR Agent.">
+    <title>UR-AGENT Documentation</title>
+    <meta name="description" content="Professional documentation, tutorials, examples, and command reference for UR-AGENT.">
     <link rel="stylesheet" href="styles.css">
   </head>
   <body>
@@ -14,7 +14,7 @@
       <div class="brand">
         <div class="brand-mark" aria-hidden="true">UR</div>
         <div>
-          <strong>UR Agent</strong>
+          <strong>UR-AGENT</strong>
           <span>Documentation</span>
         </div>
       </div>
@@ -43,9 +43,9 @@
     <main id="content" class="content">
       <header class="topbar">
         <div>
-          <p class="eyebrow">Version 1.22.3</p>
-          <h1>UR Agent Documentation</h1>
-          <p class="lead">A practical, tutorial-style reference for installing, configuring, automating, extending, and operating UR Agent.</p>
+          <p class="eyebrow">Version 1.24.0</p>
+          <h1>UR-AGENT Documentation</h1>
+          <p class="lead">A practical, tutorial-style reference for installing, configuring, automating, extending, and operating UR-AGENT.</p>
         </div>
         <div class="topbar-actions">
           <a class="button" href="#quickstart">Start</a>
@@ -56,8 +56,8 @@
       <section id="overview" class="section">
         <div class="section-heading">
           <p class="eyebrow">What UR Is</p>
-          <h2>Terminal coding agent with local-first model routing</h2>
-          <p>UR runs from the terminal, uses the local Ollama app for model calls, and combines project context, tools, MCP, plugins, skills, workflows, automations, and agent orchestration into one CLI.</p>
+          <h2>Autonomous engineering workflow engine</h2>
+          <p>UR is not only chat, autocomplete, or code edits. It turns work into a plan, executes patches, tests and verifies them, documents the result, benchmarks behavior, and keeps the run reproducible from the terminal.</p>
         </div>
         <div class="stat-grid">
           <article>
@@ -72,6 +72,10 @@
             <strong>Agent platform</strong>
             <span>Workflows, patterns, crews, goals, evals, memory, knowledge, A2A, provenance, and templates are first-class commands.</span>
           </article>
+          <article>
+            <strong>Plugin marketplace</strong>
+            <span>Plugins can add MCP tools, skills, templates, validators, language adapters, LSP servers, agents, hooks, and output styles.</span>
+          </article>
           <article>
             <strong>Reliable repo editing</strong>
             <span><code>ur repo-edit</code> indexes files and symbols, plans AST-aware renames, previews patches, and rolls back failed multi-file applies.</span>
@@ -86,7 +90,7 @@
           </article>
           <article>
             <strong>Release checks</strong>
-            <span>Typecheck, tests, bundle verification, smoke, package checks, and secret scan are part of the release path.</span>
+            <span>Typecheck, tests, bundle verification, smoke, package checks, secret scan, and dry-run publish are part of the release path.</span>
           </article>
         </div>
       </section>
@@ -130,7 +134,7 @@ ur -p --output-format json "Review the current diff"</code></pre>
           <p>The CLI is the control plane. Project context and <code>.ur</code> assets feed agent orchestration, which uses local Ollama models and approved tools to produce code, docs, PRs, reports, and automation outputs.</p>
         </div>
         <figure class="diagram">
-          <img src="assets/ur-architecture.svg" alt="UR Agent runtime architecture diagram">
+          <img src="assets/ur-architecture.svg" alt="UR-AGENT runtime architecture diagram">
         </figure>
       </section>
 
@@ -442,7 +446,7 @@ UR_VERIFIER_AUTO_SUBAGENT=1</code></pre>
 ur mcp add-json local-tools '{"command":"node","args":["server.js"]}'
 ur plugin list
 ur plugin install &lt;plugin&gt;</code></pre>
-            <p>MCP servers and plugins expand tool access. Treat them as trusted code.</p>
+            <p>MCP servers and marketplace plugins expand tools, executable skills, templates, validators, language adapters, and review workflows. Treat them as trusted code.</p>
           </article>
         </div>
       </section>

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "ur-agent",
-  "version": "1.23.3",
-  "description": "UR — autonomous engineering workflow engine (plan, execute, test, verify, document, benchmark, reproduce)",
+  "version": "1.24.1",
+  "description": "UR-AGENT — autonomous engineering workflow engine (plan, execute, test, verify, document, benchmark, reproduce)",
   "type": "module",
   "packageManager": "bun@1.3.14",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Maitham16/UR-mapek.git"
+    "url": "git+https://github.com/Maitham16/UR.git"
   },
   "bugs": {
-    "url": "https://github.com/Maitham16/UR-mapek/issues"
+    "url": "https://github.com/Maitham16/UR/issues"
   },
-  "homepage": "https://github.com/Maitham16/UR-mapek#readme",
-  "license": "LicenseRef-UR-Agent-Non-Commercial-Self-Responsibility",
+  "homepage": "https://github.com/Maitham16/UR#readme",
+  "license": "LicenseRef-UR-AGENT-Non-Commercial-Self-Responsibility",
   "keywords": [
     "agent",
     "cli",
@@ -30,15 +30,20 @@
     "documentation",
     "extensions",
     "examples",
+    "plugins",
     "CHANGELOG.md",
+    "CONTRIBUTING.md",
     "QUALITY.md",
     "README.md",
+    "RELEASE.md",
+    "SECURITY.md",
     "LICENSE"
   ],
   "scripts": {
     "start": "node ./bin/ur.js",
     "dev": "bun --watch run src/entrypoints/cli.tsx",
     "bundle": "node scripts/bundle.mjs",
+    "build": "node scripts/bundle.mjs",
     "release:check": "node scripts/release-check.mjs",
     "typecheck": "bun run tsc --noEmit",
     "lint": "node scripts/lint.mjs",

package/plugins/bunBundleDev.ts

@@ -0,0 +1,32 @@
+/**
+ * Bun plugin that provides a runtime implementation of the `bun:bundle` module.
+ *
+ * In production, Bun's bundler statically replaces `feature()` calls at compile
+ * time. During development (running unbundled with `bun run`), this plugin
+ * intercepts `bun:bundle` imports and returns a stub where every feature flag
+ * is `false` by default.
+ *
+ * To enable specific flags during dev, set the env var FEATURE_FLAGS as a
+ * comma-separated list:
+ *
+ *   FEATURE_FLAGS=KAIROS,VOICE_MODE bun run src/main.tsx
+ */
+import { plugin } from 'bun'
+
+const enabledFlags = new Set(
+  (process.env.FEATURE_FLAGS ?? '').split(',').filter(Boolean),
+)
+
+plugin({
+  name: 'bun-bundle-dev',
+  setup(build) {
+    build.module('bun:bundle', () => ({
+      exports: {
+        feature(flag: string): boolean {
+          return enabledFlags.has(flag)
+        },
+      },
+      loader: 'object',
+    }))
+  },
+})

package/plugins/community/.gitkeep

@@ -0,0 +1 @@
+

package/plugins/core/README.md

@@ -0,0 +1,69 @@
+# plugins/core/
+
+First-party plugins for the **ur-plugins-official** marketplace.
+
+Each subdirectory here is a self-contained plugin. The marketplace
+manifest at `.ur-plugin/marketplace.json` (at the repo root) lists which of
+them are published.
+
+## Shipped plugins
+
+| Plugin | Slash command | What it does |
+| --- | --- | --- |
+| [`hello`](./hello) | `/hello [name]` | Example greeting. Use as a template. |
+| [`git-summary`](./git-summary) | `/git-summary` | One-paragraph factual summary of the working tree and recent commits. |
+| [`code-review`](./code-review) | `/code-review [base-ref]` | Structured review of the working diff. Correctness, style, test coverage, security, TL;DR verdict. |
+| [`explain-error`](./explain-error) | `/explain-error [command]` | Re-runs a failing command and decodes the error in plain English with two next steps. |
+| [`release-notes`](./release-notes) | `/release-notes [since-ref]` | Drafts release notes grouped by Features / Fixes / Documentation / Other since the last tag. |
+| [`evaluate-response`](./evaluate-response) | `/evaluate-response` | Adversarial self-evaluation of the most recent assistant turn. |
+| [`obsidian`](./obsidian) | `/second-brain` (+4) | Operate an Obsidian vault as a second brain — atomic notes, daily notes, MOCs, backlinks, cited search. Direct file edits or the Local REST API MCP server. |
+| [`github`](./github) | `/gh-pr-review` (+3) | Review and open pull requests, triage issues, check repo health — via the official GitHub MCP server or the `gh` CLI. |
+| [`gitlab`](./gitlab) | `/gl-mr-review` (+3) | Review and open merge requests, triage issues, watch CI/CD pipelines — via the official GitLab MCP server or the `glab` CLI. |
+| [`huggingface`](./huggingface) | `/hf-model-search` (+3) | Search, vet, and download Hub models and datasets — via the official Hugging Face MCP server or the `hf` CLI. |
+| [`word`](./word) | `/docx-new` (+3) | Create, convert, review, and edit Word documents — via the Office Word MCP server or a pandoc / python-docx fallback. |
+| [`powerpoint`](./powerpoint) | `/pptx-new` (+3) | Build, convert, review, and theme PowerPoint decks — via the Office PowerPoint MCP server or a python-pptx fallback. |
+| [`miro`](./miro) | `/miro-board` (+3) | Create boards, diagrams, and sticky clusters and summarize boards — via Miro's official MCP server or the REST API. |
+| [`skill-forge`](./skill-forge) | `/forge-skill` (+1) | The active model authors a complete `SKILL.md` from your description and saves it to your skills directory. |
+| [`engineering-discipline`](./engineering-discipline) | `/discipline-check` | Reference plugin that ships a command, executable skill, agent template, validator, and Markdown language adapter metadata. |
+
+Seven of these are **integration plugins**: each bundles an official MCP server,
+several slash commands, and a methodology skill, and prompts for its config
+(tokens, vault path, output folders) on enable. The Office plugins run their MCP
+server through `uvx` (install `uv`) and fall back to local Python libraries.
+Secrets are stored in secure storage, never in plaintext settings.
+
+[`skill-forge`](./skill-forge) is a **meta plugin** (no MCP): its commands run as
+prompts, so the active session model authors and saves the skill for you.
+
+[`engineering-discipline`](./engineering-discipline) is a **marketplace
+capability reference plugin**. It demonstrates every standard extension surface
+UR accepts from marketplace plugins: commands, executable skills, reusable agent
+templates, deterministic validators, language adapters, and LSP server metadata.
+
+## Adding a new plugin
+
+1. Copy `hello/` to a new directory, e.g. `plugins/core/my-plugin/`.
+2. Edit `my-plugin/.ur-plugin/plugin.json` with the plugin's real metadata.
+3. Replace the example command in `my-plugin/commands/` with your own.
+4. Add optional extension folders as needed:
+   - `skills/<name>/SKILL.md`
+   - `templates/<name>.md`
+   - `validators/<name>.json`
+   - `mcpServers` or `lspServers` in `.ur-plugin/plugin.json`
+   - `languageAdapters` in `.ur-plugin/plugin.json`
+5. Add an entry to `.ur-plugin/marketplace.json` (sibling to existing
+   entries).
+6. Set the entry's `capabilities` array so users can see whether it adds MCP
+   tools, skills, templates, validators, language adapters, LSP servers,
+   commands, agents, or hooks before installation.
+7. Open a PR against `Maitham16/UR`.
+
+See [`hello/README.md`](./hello/README.md) for the smallest possible example.
+
+## Schemas
+
+The shapes for `marketplace.json` and `plugin.json` are defined in the
+agent source — see `src/utils/plugins/schemas.ts` (`PluginMarketplaceSchema`
+and `PluginManifestSchema`). The schemas are strict-by-default but
+unknown fields on marketplace entries are silently stripped so future
+versions stay forward-compatible.

package/plugins/core/code-review/.ur-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "code-review",
+  "version": "0.1.0",
+  "description": "Adds /code-review — structured review of the working diff against a base ref.",
+  "author": {
+    "name": "Maitham Al-rubaye",
+    "url": "https://github.com/Maitham16/UR"
+  },
+  "homepage": "https://github.com/Maitham16/UR/tree/master/plugins/core/code-review",
+  "repository": "https://github.com/Maitham16/UR",
+  "license": "LicenseRef-UR-AGENT-Non-Commercial-Self-Responsibility",
+  "keywords": ["code-review", "git", "diff", "quality"]
+}

package/plugins/core/code-review/README.md

@@ -0,0 +1,37 @@
+# code-review
+
+Adds `/code-review` — a structured review of the working diff against a
+base ref.
+
+## Use
+
+```text
+/code-review
+/code-review main
+/code-review v1.2.0
+```
+
+If no base ref is given, the plugin tries `main`, then `master`, then
+`HEAD~5`.
+
+## What it does
+
+Runs `git diff <base>...HEAD`, then asks the model for a markdown report
+with four sections (Correctness, Style, Test coverage, Security) and a
+mandatory one-line TL;DR (`Looks good` / `Has nits` / `Has blockers`).
+
+Sections with no findings are omitted, not padded.
+
+## Install
+
+```text
+/plugin install code-review@ur-plugins-official
+```
+
+## Pair with the verifier
+
+`/code-review` is a *static* read of the diff. The verifier subagent
+(`/verify` or auto on every "done") is a *dynamic* check — it actually
+runs builds, tests, and lints. They're complementary: code-review catches
+things the verifier can't (style, subtle logic), and the verifier catches
+things code-review can't (does it actually compile and pass tests).