openplanr 2.0.0 → 2.1.0

package/lib/host-packages/claude/openplanr/skills/design-loop/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/lib/host-packages/claude/openplanr/skills/design-review/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/lib/host-packages/claude/openplanr/skills/openplanr/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: openplanr
+description: Route a planning, specification, delivery, design, review, diagram, release, or operating request to the best OpenPlanr skill. Use when the right skill is unclear or the request spans several.
+license: MIT
+---
+
+# OpenPlanr router
+
+Decide which OpenPlanr skill owns the request, say which one and why in one
+line, then invoke it. Invoke a skill by its host name: the skill id without the
+`planr-` prefix, namespaced under `planr` (`planr-plan` is `/planr:plan` in
+Claude Code and `$planr:plan` in Codex). Do not perform the routed work here.
+
+## Route by intent
+
+| The user wants to… | Skill |
+| --- | --- |
+| Turn a vague idea or requirement into a measurable specification | `planr-spec` |
+| Break a specification or intent into stories and tasks | `planr-plan` |
+| Check a plan before implementation starts | `planr-plan-review` |
+| Build, fix, finish, or ship local work | `planr-ship` |
+| Find the root cause of a bug, regression, or odd behavior | `planr-investigate` |
+| Test the running application in a real browser | `planr-browser-qa` |
+| Design a new interface or a coherent design direction | `planr-design` |
+| Compare several design directions | `planr-design-loop` |
+| Revise an existing design with pinned feedback | `planr-design-review` |
+| Create or check an architecture, process, sequence, or data diagram | `planr-diagram` |
+| Share, import, or export an HTML artifact review | `planr-artifact` |
+| Know what is done, pending, blocked, or next | `planr-status` |
+| See planning or Operate state in the browser | `planr-dashboard` |
+| Check artifacts for graph, status, or schema drift | `planr-sync` |
+| Judge release readiness or prepare a landing sequence | `planr-land` |
+| Pick a versioning scheme, bump versions, write release notes | `planr-release` |
+| Diagnose the CLI, plugins, installation, or upgrade state | `planr-doctor` |
+| Run a leadership operating review across all lenses | `planr-operate` |
+| Get one executive lens on an Operate cycle | `planr-ceo-review`, `planr-cto-review`, `planr-cpo-review`, `planr-cmo-review`, `planr-coo-review` |
+| Stress-test an Operate cycle's claims, or synthesize its decisions | `planr-challenger-review`, `planr-chair-review` |
+
+## Boundaries
+
+- PLAN and SHIP are separate user-invoked workflows. Route to one; never chain
+  `planr-plan` into `planr-ship` on the user's behalf.
+- When a request spans several skills, route to the earliest step in that
+  order (spec → plan → plan-review → ship → land → release) and name the rest.
+- When the request is not OpenPlanr work at all, say so and answer directly
+  without invoking a skill.
+- Ask one concise question only when two candidate skills would produce
+  materially different work.

package/lib/host-packages/claude/openplanr/skills/openplanr/openplanr.skill.json

@@ -0,0 +1,26 @@
+{
+  "kind": "openplanr-skill-package",
+  "schemaVersion": "1.0.0",
+  "protocolVersion": "1.8.0",
+  "skillId": "planr-openplanr",
+  "skillVersion": "1.0.0",
+  "entrypoint": "SKILL.md",
+  "hosts": [
+    "claude-code",
+    "codex",
+    "chatgpt",
+    "cursor"
+  ],
+  "execution": "host-agent",
+  "resources": [
+    {
+      "path": "agents/openai.yaml",
+      "kind": "agent-metadata",
+      "hosts": [
+        "codex",
+        "chatgpt"
+      ],
+      "executable": false
+    }
+  ]
+}

package/lib/host-packages/claude/openplanr/skills/plan/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/lib/host-packages/cursor/openplanr/.openplanr-content.json

@@ -3,12 +3,12 @@
   "schemaVersion": "1.0.0",
   "protocolVersion": "1.8.0",
   "host": "cursor",
-  "skillCount": 25,
+  "skillCount": 26,
   "roleCount": 0,
   "files": [
     {
       "path": "manifest.json",
-      "digest": "sha256:a8ab4b907ef8b0b2ee530688811e22f8f5fb67c435803a57ff701baeb1ab7de0"
+      "digest": "sha256:c1c27693fe61e7cad7018a4f2ecb6e32f4fe5de078ee2ff6e6401a9b2a03422c"
     },
     {
       "path": "rules/planr-artifact.mdc",
@@ -16,7 +16,7 @@
     },
     {
       "path": "rules/planr-artifact/references/company-review.md",
-      "digest": "sha256:168066d3539dab064adeaaf0e4187df8b779d53476be17283b4a62d4bb136257"
+      "digest": "sha256:b31bb74501fd24ae388294a4ccf2b9161b128f0288b2fb03c99a762595e0eaba"
     },
     {
       "path": "rules/planr-artifact/references/design-sharing.md",
@@ -284,7 +284,7 @@
     },
     {
       "path": "rules/planr-design-loop/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:b4b9cdd63c56723fa0c64cae1ce50776bf1f221d56e345672803974e70781567"
+      "digest": "sha256:9a11f3b5e52bb2bd3f2310a9cbc1276b62b1b08e401279769228d5bfd8567995"
     },
     {
       "path": "rules/planr-design-loop/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -448,7 +448,7 @@
     },
     {
       "path": "rules/planr-design-review/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:b4b9cdd63c56723fa0c64cae1ce50776bf1f221d56e345672803974e70781567"
+      "digest": "sha256:9a11f3b5e52bb2bd3f2310a9cbc1276b62b1b08e401279769228d5bfd8567995"
     },
     {
       "path": "rules/planr-design-review/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -612,7 +612,7 @@
     },
     {
       "path": "rules/planr-design/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:b4b9cdd63c56723fa0c64cae1ce50776bf1f221d56e345672803974e70781567"
+      "digest": "sha256:9a11f3b5e52bb2bd3f2310a9cbc1276b62b1b08e401279769228d5bfd8567995"
     },
     {
       "path": "rules/planr-design/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -714,6 +714,10 @@
       "path": "rules/planr-land.mdc",
       "digest": "sha256:95b55146b5da4ee106a9d46e220e20656c3b4248f12a8f637c909fbce393ddf8"
     },
+    {
+      "path": "rules/planr-openplanr.mdc",
+      "digest": "sha256:bf88b2c937e39ab2436786abaeb2dfe58d90832f12afb496f1100845a94d8719"
+    },
     {
       "path": "rules/planr-operate.mdc",
       "digest": "sha256:55719d4bc0d9d557e8accc2b3ca53cd54c1b956d696fc3b383889388960e3548"
@@ -804,7 +808,7 @@
     },
     {
       "path": "rules/planr-plan/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:b4b9cdd63c56723fa0c64cae1ce50776bf1f221d56e345672803974e70781567"
+      "digest": "sha256:9a11f3b5e52bb2bd3f2310a9cbc1276b62b1b08e401279769228d5bfd8567995"
     },
     {
       "path": "rules/planr-plan/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -935,5 +939,5 @@
       "digest": "sha256:6378ad3477e4be8b7e916c4249404c50cafecac1c70ffbf5a1a2fce195dfea16"
     }
   ],
-  "contentDigest": "sha256:0a2f2696f5a938636ca2adc6058315d4a5d4a0ad29a0fe822128a89ce52ae3dc"
+  "contentDigest": "sha256:6513470ead50ff33f9e79a6bda9d3888397e90c3901f8183a7112176d892909a"
 }

package/lib/host-packages/cursor/openplanr/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "openplanr",
   "version": "0.1.0",
-  "ruleCount": 25,
+  "ruleCount": 26,
   "rules": [
     "rules/planr-artifact.mdc",
     "rules/planr-browser-qa.mdc",
@@ -20,6 +20,7 @@
     "rules/planr-doctor.mdc",
     "rules/planr-investigate.mdc",
     "rules/planr-land.mdc",
+    "rules/planr-openplanr.mdc",
     "rules/planr-operate.mdc",
     "rules/planr-plan.mdc",
     "rules/planr-plan-review.mdc",

package/lib/host-packages/cursor/openplanr/rules/planr-artifact/references/company-review.md

@@ -3,7 +3,7 @@
 Use this route only for an explicitly configured company workspace. Existing `planr artifact share/publish/sync` token shares keep their separate encryption and authorization model. Never silently import a token share into company storage.
 
 1. Read `planr company --help`. If this command is absent, report the actual installed CLI path/version and required local build; do not search the disk for runtime internals or silently install a public release.
-2. Start browser sign-in with `planr company login --json`; use `--no-open` to display its authorization URL and open it on the same computer. The hosted CLI uses `https://api.openplanr.dev` by default; `--api-url <origin>` is an advanced development, staging, or self-hosted override. The company service must advertise a configured public OAuth client. Choose the organization in the issuer's consent screen. The CLI stores renewable credentials in the OS keychain, or discloses its existing encrypted local-file fallback. Never print tokens, place them in arguments/URLs, or ask for them in chat. Tokens renew automatically; revoked access still fails closed. `company connect --token-stdin` and `PLANR_COMPANY_TOKEN` remain explicit developer fallbacks without automatic renewal.
+2. Start browser sign-in with `planr company login`; use `--no-open` to display its authorization URL and open it on the same computer. Add `--json` only when an automated caller needs the structured completion receipt. The hosted CLI uses `https://api.openplanr.dev` by default; `--api-url <origin>` is an advanced development, staging, or self-hosted override. The company service must advertise a configured public OAuth client. Choose the organization in the issuer's consent screen. The CLI stores renewable credentials in the OS keychain, or discloses its existing encrypted local-file fallback. Never print tokens, place them in arguments/URLs, or ask for them in chat. Tokens renew automatically; revoked access still fails closed. `company connect --token-stdin` and `PLANR_COMPANY_TOKEN` remain explicit developer fallbacks without automatic renewal.
 3. List authorized projects with `planr company projects --json`. Actor and organization come from the verified token; identifiers in a request never establish permission.
 4. For a user-requested publication, `planr company preview <repository-relative-file> --project <id> --kind diagram|design|plan|document --json` records the exact selected file, bytes, size and digest. Show the publication scope. `planr company publish <preview-id> --json` explicitly publishes that preview. Content becomes accessible to the managed company service; source code and unselected files stay local. No hidden recursive upload.
 5. Inspect synchronization with `planr company status <binding-id> --json`. Update the same artifact using `planr company push <binding-id> --preview --json`, review the changed scope/content, then `planr company push <binding-id> --json`. Conflicts are comparisons to resolve, not permission to force overwrite.

package/lib/host-packages/cursor/openplanr/rules/planr-design/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/lib/host-packages/cursor/openplanr/rules/planr-design-loop/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/lib/host-packages/cursor/openplanr/rules/planr-design-review/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/lib/host-packages/cursor/openplanr/rules/planr-openplanr.mdc

@@ -0,0 +1,47 @@
+---
+description: "Route a planning, specification, delivery, design, review, diagram, release, or operating request to the best OpenPlanr skill. Use when the right skill is unclear or the request spans several."
+alwaysApply: false
+---
+
+# OpenPlanr router
+
+Decide which OpenPlanr skill owns the request, say which one and why in one
+line, then invoke it. Invoke a skill by its host name: the skill id without the
+`planr-` prefix, namespaced under `planr` (`planr-plan` is `/planr:plan` in
+Claude Code and `$planr:plan` in Codex). Do not perform the routed work here.
+
+## Route by intent
+
+| The user wants to… | Skill |
+| --- | --- |
+| Turn a vague idea or requirement into a measurable specification | `planr-spec` |
+| Break a specification or intent into stories and tasks | `planr-plan` |
+| Check a plan before implementation starts | `planr-plan-review` |
+| Build, fix, finish, or ship local work | `planr-ship` |
+| Find the root cause of a bug, regression, or odd behavior | `planr-investigate` |
+| Test the running application in a real browser | `planr-browser-qa` |
+| Design a new interface or a coherent design direction | `planr-design` |
+| Compare several design directions | `planr-design-loop` |
+| Revise an existing design with pinned feedback | `planr-design-review` |
+| Create or check an architecture, process, sequence, or data diagram | `planr-diagram` |
+| Share, import, or export an HTML artifact review | `planr-artifact` |
+| Know what is done, pending, blocked, or next | `planr-status` |
+| See planning or Operate state in the browser | `planr-dashboard` |
+| Check artifacts for graph, status, or schema drift | `planr-sync` |
+| Judge release readiness or prepare a landing sequence | `planr-land` |
+| Pick a versioning scheme, bump versions, write release notes | `planr-release` |
+| Diagnose the CLI, plugins, installation, or upgrade state | `planr-doctor` |
+| Run a leadership operating review across all lenses | `planr-operate` |
+| Get one executive lens on an Operate cycle | `planr-ceo-review`, `planr-cto-review`, `planr-cpo-review`, `planr-cmo-review`, `planr-coo-review` |
+| Stress-test an Operate cycle's claims, or synthesize its decisions | `planr-challenger-review`, `planr-chair-review` |
+
+## Boundaries
+
+- PLAN and SHIP are separate user-invoked workflows. Route to one; never chain
+  `planr-plan` into `planr-ship` on the user's behalf.
+- When a request spans several skills, route to the earliest step in that
+  order (spec → plan → plan-review → ship → land → release) and name the rest.
+- When the request is not OpenPlanr work at all, say so and answer directly
+  without invoking a skill.
+- Ask one concise question only when two candidate skills would produce
+  materially different work.

package/lib/host-packages/cursor/openplanr/rules/planr-plan/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/lib/host-packages/openai/openplanr/.openplanr-content.json

@@ -3,7 +3,7 @@
   "schemaVersion": "1.0.0",
   "protocolVersion": "1.8.0",
   "host": "openai",
-  "skillCount": 25,
+  "skillCount": 26,
   "roleCount": 0,
   "files": [
     {
@@ -20,7 +20,7 @@
     },
     {
       "path": "skills/artifact/references/company-review.md",
-      "digest": "sha256:168066d3539dab064adeaaf0e4187df8b779d53476be17283b4a62d4bb136257"
+      "digest": "sha256:b31bb74501fd24ae388294a4ccf2b9161b128f0288b2fb03c99a762595e0eaba"
     },
     {
       "path": "skills/artifact/references/design-sharing.md",
@@ -368,7 +368,7 @@
     },
     {
       "path": "skills/design-loop/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:b4b9cdd63c56723fa0c64cae1ce50776bf1f221d56e345672803974e70781567"
+      "digest": "sha256:9a11f3b5e52bb2bd3f2310a9cbc1276b62b1b08e401279769228d5bfd8567995"
     },
     {
       "path": "skills/design-loop/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -540,7 +540,7 @@
     },
     {
       "path": "skills/design-review/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:b4b9cdd63c56723fa0c64cae1ce50776bf1f221d56e345672803974e70781567"
+      "digest": "sha256:9a11f3b5e52bb2bd3f2310a9cbc1276b62b1b08e401279769228d5bfd8567995"
     },
     {
       "path": "skills/design-review/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -712,7 +712,7 @@
     },
     {
       "path": "skills/design/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:b4b9cdd63c56723fa0c64cae1ce50776bf1f221d56e345672803974e70781567"
+      "digest": "sha256:9a11f3b5e52bb2bd3f2310a9cbc1276b62b1b08e401279769228d5bfd8567995"
     },
     {
       "path": "skills/design/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -850,6 +850,18 @@
       "path": "skills/land/SKILL.md",
       "digest": "sha256:04d2deb6b7d4c161f94580f7b6481c51ca60b55afe6f5d510fd640d57f569c2d"
     },
+    {
+      "path": "skills/openplanr/agents/openai.yaml",
+      "digest": "sha256:d52298b62edcbdaac5c48b7ced2ab5e21c999552e1734fd2a5f3fb3ba0ab66c1"
+    },
+    {
+      "path": "skills/openplanr/openplanr.skill.json",
+      "digest": "sha256:f14e20b843f7f51688ded299fbeb773eab1d244429e7baaaff5a14713bde72be"
+    },
+    {
+      "path": "skills/openplanr/SKILL.md",
+      "digest": "sha256:0796e0cce4d8fdf6f5b8cca86ef7c96fd02150493b609d08e74bb78045fcb2dd"
+    },
     {
       "path": "skills/operate/agents/openai.yaml",
       "digest": "sha256:8a1ebf2de3c0936f7f090d911a5e3d63d72286baa06c05f850cf91ea64f35cea"
@@ -960,7 +972,7 @@
     },
     {
       "path": "skills/plan/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:b4b9cdd63c56723fa0c64cae1ce50776bf1f221d56e345672803974e70781567"
+      "digest": "sha256:9a11f3b5e52bb2bd3f2310a9cbc1276b62b1b08e401279769228d5bfd8567995"
     },
     {
       "path": "skills/plan/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -1135,5 +1147,5 @@
       "digest": "sha256:53698324b62f43b672ce8fe1654c526c96fb202e313442f09c6fc1e72268677e"
     }
   ],
-  "contentDigest": "sha256:d1ba92aa5b959769e5bffb7d5c89dbcb8761bc5a642b82248d6345a1be848bef"
+  "contentDigest": "sha256:ebec93efd22f8e04e5f6dce3b933fedc54b51a69809ef85de2080c79349b0fb1"
 }

package/lib/host-packages/openai/openplanr/skills/artifact/references/company-review.md

@@ -3,7 +3,7 @@
 Use this route only for an explicitly configured company workspace. Existing `planr artifact share/publish/sync` token shares keep their separate encryption and authorization model. Never silently import a token share into company storage.
 
 1. Read `planr company --help`. If this command is absent, report the actual installed CLI path/version and required local build; do not search the disk for runtime internals or silently install a public release.
-2. Start browser sign-in with `planr company login --json`; use `--no-open` to display its authorization URL and open it on the same computer. The hosted CLI uses `https://api.openplanr.dev` by default; `--api-url <origin>` is an advanced development, staging, or self-hosted override. The company service must advertise a configured public OAuth client. Choose the organization in the issuer's consent screen. The CLI stores renewable credentials in the OS keychain, or discloses its existing encrypted local-file fallback. Never print tokens, place them in arguments/URLs, or ask for them in chat. Tokens renew automatically; revoked access still fails closed. `company connect --token-stdin` and `PLANR_COMPANY_TOKEN` remain explicit developer fallbacks without automatic renewal.
+2. Start browser sign-in with `planr company login`; use `--no-open` to display its authorization URL and open it on the same computer. Add `--json` only when an automated caller needs the structured completion receipt. The hosted CLI uses `https://api.openplanr.dev` by default; `--api-url <origin>` is an advanced development, staging, or self-hosted override. The company service must advertise a configured public OAuth client. Choose the organization in the issuer's consent screen. The CLI stores renewable credentials in the OS keychain, or discloses its existing encrypted local-file fallback. Never print tokens, place them in arguments/URLs, or ask for them in chat. Tokens renew automatically; revoked access still fails closed. `company connect --token-stdin` and `PLANR_COMPANY_TOKEN` remain explicit developer fallbacks without automatic renewal.
 3. List authorized projects with `planr company projects --json`. Actor and organization come from the verified token; identifiers in a request never establish permission.
 4. For a user-requested publication, `planr company preview <repository-relative-file> --project <id> --kind diagram|design|plan|document --json` records the exact selected file, bytes, size and digest. Show the publication scope. `planr company publish <preview-id> --json` explicitly publishes that preview. Content becomes accessible to the managed company service; source code and unselected files stay local. No hidden recursive upload.
 5. Inspect synchronization with `planr company status <binding-id> --json`. Update the same artifact using `planr company push <binding-id> --preview --json`, review the changed scope/content, then `planr company push <binding-id> --json`. Conflicts are comparisons to resolve, not permission to force overwrite.

package/lib/host-packages/openai/openplanr/skills/design/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/lib/host-packages/openai/openplanr/skills/design-loop/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/lib/host-packages/openai/openplanr/skills/design-review/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/lib/host-packages/openai/openplanr/skills/openplanr/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: openplanr
+description: Route a planning, specification, delivery, design, review, diagram, release, or operating request to the best OpenPlanr skill. Use when the right skill is unclear or the request spans several.
+license: MIT
+---
+
+# OpenPlanr router
+
+Decide which OpenPlanr skill owns the request, say which one and why in one
+line, then invoke it. Invoke a skill by its host name: the skill id without the
+`planr-` prefix, namespaced under `planr` (`planr-plan` is `/planr:plan` in
+Claude Code and `$planr:plan` in Codex). Do not perform the routed work here.
+
+## Route by intent
+
+| The user wants to… | Skill |
+| --- | --- |
+| Turn a vague idea or requirement into a measurable specification | `planr-spec` |
+| Break a specification or intent into stories and tasks | `planr-plan` |
+| Check a plan before implementation starts | `planr-plan-review` |
+| Build, fix, finish, or ship local work | `planr-ship` |
+| Find the root cause of a bug, regression, or odd behavior | `planr-investigate` |
+| Test the running application in a real browser | `planr-browser-qa` |
+| Design a new interface or a coherent design direction | `planr-design` |
+| Compare several design directions | `planr-design-loop` |
+| Revise an existing design with pinned feedback | `planr-design-review` |
+| Create or check an architecture, process, sequence, or data diagram | `planr-diagram` |
+| Share, import, or export an HTML artifact review | `planr-artifact` |
+| Know what is done, pending, blocked, or next | `planr-status` |
+| See planning or Operate state in the browser | `planr-dashboard` |
+| Check artifacts for graph, status, or schema drift | `planr-sync` |
+| Judge release readiness or prepare a landing sequence | `planr-land` |
+| Pick a versioning scheme, bump versions, write release notes | `planr-release` |
+| Diagnose the CLI, plugins, installation, or upgrade state | `planr-doctor` |
+| Run a leadership operating review across all lenses | `planr-operate` |
+| Get one executive lens on an Operate cycle | `planr-ceo-review`, `planr-cto-review`, `planr-cpo-review`, `planr-cmo-review`, `planr-coo-review` |
+| Stress-test an Operate cycle's claims, or synthesize its decisions | `planr-challenger-review`, `planr-chair-review` |
+
+## Boundaries
+
+- PLAN and SHIP are separate user-invoked workflows. Route to one; never chain
+  `planr-plan` into `planr-ship` on the user's behalf.
+- When a request spans several skills, route to the earliest step in that
+  order (spec → plan → plan-review → ship → land → release) and name the rest.
+- When the request is not OpenPlanr work at all, say so and answer directly
+  without invoking a skill.
+- Ask one concise question only when two candidate skills would produce
+  materially different work.

package/lib/host-packages/openai/openplanr/skills/openplanr/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Planr Openplanr"
+  short_description: "Route a planning, specification, delivery, design, review…"
+  default_prompt: "Use $planr:openplanr to route a planning, specification, delivery, design, review, diagram, release, or operating request to the best OpenPlanr skill. Use when the right skill is unclear or the request spans several."
+policy:
+  allow_implicit_invocation: true

package/lib/host-packages/openai/openplanr/skills/openplanr/openplanr.skill.json

@@ -0,0 +1,26 @@
+{
+  "kind": "openplanr-skill-package",
+  "schemaVersion": "1.0.0",
+  "protocolVersion": "1.8.0",
+  "skillId": "planr-openplanr",
+  "skillVersion": "1.0.0",
+  "entrypoint": "SKILL.md",
+  "hosts": [
+    "claude-code",
+    "codex",
+    "chatgpt",
+    "cursor"
+  ],
+  "execution": "host-agent",
+  "resources": [
+    {
+      "path": "agents/openai.yaml",
+      "kind": "agent-metadata",
+      "hosts": [
+        "codex",
+        "chatgpt"
+      ],
+      "executable": false
+    }
+  ]
+}

package/lib/host-packages/openai/openplanr/skills/plan/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openplanr",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Deterministic OpenPlanr utilities for planning storage, validation, rendering, setup, diagnostics, and GitHub/Linear synchronization",
   "type": "module",
   "main": "./dist/cli/index.js",
@@ -115,7 +115,7 @@
     "zod": "^4.3.6"
   },
   "optionalDependencies": {
-    "planr-pipeline": "0.45.0"
+    "planr-pipeline": "0.45.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.9",