openplanr 3.0.0 → 3.1.0

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

@@ -3,16 +3,20 @@
   "schemaVersion": "1.0.0",
   "protocolVersion": "1.8.0",
   "host": "cursor",
-  "skillCount": 28,
+  "skillCount": 30,
   "roleCount": 0,
   "files": [
+    {
+      "path": "CONNECTORS.md",
+      "digest": "sha256:0b2062a01690bbb6b5e9688663fc3c38e8128361c9ddedea149b5bccd4620296"
+    },
     {
       "path": "LICENSE",
       "digest": "sha256:ff4ad7d960f2a89a51b5db88e1efb1a3b77e6c28e1c4fee27cbd35f6a5b3debb"
     },
     {
       "path": "manifest.json",
-      "digest": "sha256:bb99c4e7aca114a4627114d9338303bd1432cad2773ca708b882b77878047598"
+      "digest": "sha256:6893f105f30ad5300dd8a617575929ba3662809840a2903dce386802d93ad501"
     },
     {
       "path": "rules/planr-artifact.mdc",
@@ -74,6 +78,14 @@
       "path": "rules/planr-cmo-review/scripts/validate-note.mjs",
       "digest": "sha256:9c3c94842059fb884c9a1b22413395f7a0169f788cded3c04bd3b251acd564ae"
     },
+    {
+      "path": "rules/planr-connect.mdc",
+      "digest": "sha256:10803ee8844a9b24d4dc7298b03e7ea29bf61380cb84b8abfb2df1612cd7104d"
+    },
+    {
+      "path": "rules/planr-connect/references/connectors.md",
+      "digest": "sha256:0b2062a01690bbb6b5e9688663fc3c38e8128361c9ddedea149b5bccd4620296"
+    },
     {
       "path": "rules/planr-coo-review.mdc",
       "digest": "sha256:5d1577760ee23f25a89e6e156afe4b6948220bb63243eae40556fe07083e0658"
@@ -444,7 +456,7 @@
     },
     {
       "path": "rules/planr-openplanr.mdc",
-      "digest": "sha256:ecc6ca8121516c96c6daf16e1768e4986714add5c2ba281cc8ccc153003a6b53"
+      "digest": "sha256:78c736fff2a4ebc4293021021a33f9bab2702e573fc8301a353a600c097f35e2"
     },
     {
       "path": "rules/planr-operate.mdc",
@@ -460,7 +472,7 @@
     },
     {
       "path": "rules/planr-plan.mdc",
-      "digest": "sha256:952f63ebe7ad028043e1c25e12737f2e56db6216efa09346fd6bd14f071a5223"
+      "digest": "sha256:e87564b05b0c8f9a17c0cf03ce9212a3104ae9321920152b2df67d7b0b705d63"
     },
     {
       "path": "rules/planr-plan/references/artifact-contract.md",
@@ -488,7 +500,7 @@
     },
     {
       "path": "rules/planr-plan/scripts/planning-ids.mjs",
-      "digest": "sha256:5962fb674a45ce1c67c0fd7aa3085151ff1c817f4004baaa865acbdff5757adb"
+      "digest": "sha256:d7051fab0540e3beb176015f174e0851a3ceb8a24c43344495b43a28d2eaceae"
     },
     {
       "path": "rules/planr-release.mdc",
@@ -518,9 +530,17 @@
       "path": "rules/planr-release/scripts/collect_changes.sh",
       "digest": "sha256:6271a1d8ea7d0a8c86dd52f85fa78666845d7d152cc95ae5148fde68dcd2f652"
     },
+    {
+      "path": "rules/planr-share.mdc",
+      "digest": "sha256:1508157747f965bc1365d6e42d116b66831422f76ab2671e52d019661fb084ee"
+    },
+    {
+      "path": "rules/planr-share/references/connectors.md",
+      "digest": "sha256:0b2062a01690bbb6b5e9688663fc3c38e8128361c9ddedea149b5bccd4620296"
+    },
     {
       "path": "rules/planr-ship.mdc",
-      "digest": "sha256:4b49139b3f14cb3ae85f57c1bd426b3ade0d5093d55ebb178e5f232ebc65bf1e"
+      "digest": "sha256:839b6a8a90182d17c32e733bb4bc3e61e11bf5c8a224daadf8112adbcc86ae02"
     },
     {
       "path": "rules/planr-ship/references/design-lineage.md",
@@ -532,7 +552,7 @@
     },
     {
       "path": "rules/planr-ship/scripts/discover-verification.mjs",
-      "digest": "sha256:e6c2bf04fc400529362a4f4e0d6bee6b81e19642e78167cf4f546f5757920b28"
+      "digest": "sha256:8805ac8d814a1d94364d455df6da350983d4c8436faa3749717da5f1b3ae63b1"
     },
     {
       "path": "rules/planr-spec.mdc",
@@ -544,7 +564,11 @@
     },
     {
       "path": "rules/planr-sprint.mdc",
-      "digest": "sha256:d7678d43e82e90cbfdb7089e637a0a0b5059d4bf5619693808571a6c2a566835"
+      "digest": "sha256:7cd45996b5aa00f16f8b23c72fbf5dfc2dc34e89af35a34e2cfd26946f5e3682"
+    },
+    {
+      "path": "rules/planr-sprint/references/connectors.md",
+      "digest": "sha256:0b2062a01690bbb6b5e9688663fc3c38e8128361c9ddedea149b5bccd4620296"
     },
     {
       "path": "rules/planr-sprint/references/refinement-contract.md",
@@ -556,7 +580,7 @@
     },
     {
       "path": "rules/planr-sprint/references/tracker-connections.md",
-      "digest": "sha256:5f7d7126ca0db062c2b14c8ac35ca9758e44433329da610d7e75ad83b9417707"
+      "digest": "sha256:f9617486a5e2ecc861566d7a7eaf1c97725f9acfcc6bc64cfda1f9b6fd3c4d36"
     },
     {
       "path": "rules/planr-sprint/schemas/refinement.schema.json",
@@ -564,19 +588,27 @@
     },
     {
       "path": "rules/planr-status.mdc",
-      "digest": "sha256:efc0ae769f57611c39cf4307d721273106a5bc22ca3dcc1e6e07ec9f19e2d508"
+      "digest": "sha256:b2a3b616038226e6cc850a337fa6bfce23db150bf6edafe088e986cfb468d820"
+    },
+    {
+      "path": "rules/planr-status/references/connectors.md",
+      "digest": "sha256:0b2062a01690bbb6b5e9688663fc3c38e8128361c9ddedea149b5bccd4620296"
     },
     {
       "path": "rules/planr-status/references/tracker-connections.md",
-      "digest": "sha256:5f7d7126ca0db062c2b14c8ac35ca9758e44433329da610d7e75ad83b9417707"
+      "digest": "sha256:f9617486a5e2ecc861566d7a7eaf1c97725f9acfcc6bc64cfda1f9b6fd3c4d36"
     },
     {
       "path": "rules/planr-sync.mdc",
-      "digest": "sha256:e2e300f5b378a7593c3ed5d133c253d7d3b2a17ad0349133f94a8ba18c4d20b9"
+      "digest": "sha256:dd861814a184e5d6cb6054342530adaa8fd7e8bb06b8cb6f34f6fd138777a2fe"
+    },
+    {
+      "path": "rules/planr-sync/references/connectors.md",
+      "digest": "sha256:0b2062a01690bbb6b5e9688663fc3c38e8128361c9ddedea149b5bccd4620296"
     },
     {
       "path": "rules/planr-sync/references/tracker-connections.md",
-      "digest": "sha256:5f7d7126ca0db062c2b14c8ac35ca9758e44433329da610d7e75ad83b9417707"
+      "digest": "sha256:f9617486a5e2ecc861566d7a7eaf1c97725f9acfcc6bc64cfda1f9b6fd3c4d36"
     },
     {
       "path": "rules/planr-sync/scripts/names.mjs",
@@ -643,7 +675,7 @@
       "digest": "sha256:c338765d9f5746bf375377bdd25e94490ac31985bab0b0335e49f9faadb5c08b"
     },
     {
-      "path": "runtime/design/scripts/design-runtime-support-336900df0d39.mjs",
+      "path": "runtime/design/scripts/design-runtime-support-e34c388a8e59.mjs",
       "digest": "sha256:6f9b75516c4c4e9468a3d27ba521664604547940a5a76e8d81425b3603a5ea4a"
     },
     {
@@ -652,7 +684,7 @@
     },
     {
       "path": "runtime/design/scripts/design-share.mjs",
-      "digest": "sha256:76a313211315e67b1fc9a216ce5b4ae415f472a34216a059fdbb4c9870ae9db7"
+      "digest": "sha256:688580ad2ecf3e4a32ea62ec8309fd1d7578ca5ebb05802d5010d95becdeb796"
     },
     {
       "path": "runtime/design/scripts/design-shared-artifact-support-dependencies-design-support-protocol-contracts-3d9b1a86.mjs",
@@ -664,7 +696,7 @@
     },
     {
       "path": "runtime/design/scripts/design-shared-protocol-contracts-31a760fc.mjs",
-      "digest": "sha256:f411ea92c48db776e2911094efeb4d22de2471330332f34a737d8d6763995715"
+      "digest": "sha256:215096cb7b59f2ec0daff6d4dd229b30ae2c0d5ab2f6fb96539f02dfd1c428b7"
     },
     {
       "path": "runtime/design/scripts/design-shared-protocol-contracts-75a938cc.mjs",
@@ -680,15 +712,15 @@
     },
     {
       "path": "runtime/design/scripts/runtime/notices/THIRD_PARTY_NOTICES.txt",
-      "digest": "sha256:2cd156e3285240dced643f0312875a23ec3681a0492bec96591bfc36c06256b9"
+      "digest": "sha256:66a4b5b0ce31ce6c5a5ea43c17dea76a48df6a1bcf5c2cd6b187b2b6c210143c"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/artifact/lib/artifact/ui/studio-shell.css",
-      "digest": "sha256:61e3736cd81f15162d877bb29481e96538d8a32f19cc4a6718026e549e193c48"
+      "digest": "sha256:b616c94f27575a9b354f53bc697a0f168aa8e17fd54ecec75c92504a17b547d3"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/artifact/templates/artifact-review-stage.js.sources.json",
-      "digest": "sha256:fc814562f0392d309efcb1232b72d0887e6815c0a5b0c26a2c658101acdd478c"
+      "digest": "sha256:d8afa31f819d5c76026a4c7f99991e981d28d047dd7f1414aacb886e08d4367f"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/artifact/templates/artifact-review-stage.js.sources/01-module-runtime.js",
@@ -700,7 +732,7 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/artifact/templates/artifact-review-stage.js.sources/03-protocol-contracts.js",
-      "digest": "sha256:2222cb9544f49c3af6ee1255085450119cb0973bba4b63c610964835c2ed0d54"
+      "digest": "sha256:3494e8e8cd50ff596dc2c00cc4c02f6dd2f016de50e0fb1c284ac03b6470b19d"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/artifact/templates/artifact-review-stage.js.sources/04-compression.js",
@@ -724,7 +756,7 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/package.json",
-      "digest": "sha256:7c884f7d4b1e20ffcfe58514413f1a36e8c00e88866fb07492c912949e87782c"
+      "digest": "sha256:1b285ebfcfd776807abf3d8278d4ced7b158b17a4172aa230030d4bf14d29e60"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/enhancements.css",
@@ -748,7 +780,7 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources.json",
-      "digest": "sha256:f517215a81d763cdc5aa903b0d6b2e679d10dc3592915e4f4c1f7062413cb6d3"
+      "digest": "sha256:37fd0d518f154d4918aefd7a3b2fc7a6c7b235e7cf7d2d0f5d3e45a82cb400b9"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/01-module-runtime.js",
@@ -756,35 +788,35 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/02-react.js",
-      "digest": "sha256:bf350d5126e53d2eebc29c96ce4c38d007dc205aded91cc3bb964c1d68e469e5"
+      "digest": "sha256:3d07031b0e1ebfe8d00491d70eb876cdd9ec829801ec3df4fc5aa72205b5ea7f"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/03-react-dom-client-fiber-foundations.js",
-      "digest": "sha256:f30ee0a7f2c9dbe1b13e64d33fd9f5a25bd816e60ca04eeda5153a1a3694cbb1"
+      "digest": "sha256:793a627a349d139397ff51c837c7cc911b08b34a49e5629af0c7967e5cb89715"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/04-react-dom-client-reconciliation-hooks.js",
-      "digest": "sha256:0f5687e30eb5029375818768c47b407d48946ad420adec5b3d9453d4e6e9b751"
+      "digest": "sha256:3839e5bdcca072a612ec48fffb6e340083f4692c516a2aeb9c8c8896ab4ea6a4"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/05-react-dom-client-render-phases.js",
-      "digest": "sha256:1fb2854c8642a5f9285fb5d30b015ef25006a5c2b433323eb6226173ec9f0d12"
+      "digest": "sha256:f057d07ab68567daebe124fe103d88157ee4ce68177e21d1a2166debf424309f"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/06-react-dom-client-commit-effects.js",
-      "digest": "sha256:6038d1c4d96e123d9f9ab7ee2516878c97bdbe5bc6149732d1064444d38b3b57"
+      "digest": "sha256:67291903232cb09062344ef0770638c9882a76178adba57c9a67f72bbdb80cbb"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/07-react-dom-client-work-loop-scheduling.js",
-      "digest": "sha256:89525ecc086cf31eff4fc4daf2e886ed603b301c8af6c855d409e9d6367df3e8"
+      "digest": "sha256:ed6b1c356c341efa060072cffa2a61fcbb425655bd00c8b58dc5b50a13d5a3ad"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/08-react-dom-client-dom-events-properties-hydration.js",
-      "digest": "sha256:02670980a272f781deb8d9e9d67c0ca5ea62fd31c9fff6ea55a1ccc7ade93262"
+      "digest": "sha256:fae78a4ea2c320638ca51a504b26dba90440d72882afdf1edf7ac49fe24853b6"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/09-react-dom-client-public-roots.js",
-      "digest": "sha256:631a2f59100373a07571b84cf75aeb8469d122721c32c5c30a85c26591721878"
+      "digest": "sha256:adca04c0e9079e354d467d17aaa6f49423611d290661f0cbbd7610545a98825e"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/10-react.js",
@@ -804,15 +836,15 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/14-interface-primitives.js",
-      "digest": "sha256:674115ab13d18062757b121898429a0ba0c6075d94cdc1318d3a1fd4d99252f7"
+      "digest": "sha256:c8d5ab2e7df79e22329daaf59e074d74345d11147c500553edd7910aaf96ed3e"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/15-interface-primitives.js",
-      "digest": "sha256:6228cf871238da64e48ae07c2998a754451462fdc0662137a15e99ce1c7408ee"
+      "digest": "sha256:e26c838db40b55f6df77606ac87b36f0298d7316ac832fa8c770c9dbab896596"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/16-studio-shell.js",
-      "digest": "sha256:5306387b1f59d43e1cd0ed2c471b18b0b35d5cc8c573ffe5439ea9315494c01e"
+      "digest": "sha256:81af29a6a5a15fd4f0ef41fc48e1eca63c30b3745fd1d92830ba83f7cf2ba603"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/17-design-studio.js",
@@ -820,7 +852,7 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:2ef4fe15be8e2037dda6786e075a02b94b3484f30465aab3565022ff7f0321e4"
+      "digest": "sha256:45ac1d8badf5ffb59a8bfafbb2af1eecd78843250a1eaf725682e4672d0647c0"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/protocol/registries/artifact-theme.json",
@@ -928,7 +960,7 @@
     },
     {
       "path": "runtime/plan/scripts/design-protocol-contracts.mjs",
-      "digest": "sha256:153160758bd6d789b015d788c0bb3a7767508763049374e4c7c75f3729dfe763"
+      "digest": "sha256:d922b8a2dfa71ba5d17c45cdc75e944f18bdc6259fba99e384ecaf0562f6daf2"
     },
     {
       "path": "runtime/plan/scripts/design.mjs",
@@ -940,12 +972,12 @@
     },
     {
       "path": "runtime/plan/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:2ef4fe15be8e2037dda6786e075a02b94b3484f30465aab3565022ff7f0321e4"
+      "digest": "sha256:45ac1d8badf5ffb59a8bfafbb2af1eecd78843250a1eaf725682e4672d0647c0"
     },
     {
       "path": "runtime/plan/scripts/runtime/packages/protocol/schemas/v1.1.0/artifact-review.schema.json",
       "digest": "sha256:b4db7b75b694c2aef2a37be2128e4635302f3473e09236aa1f37a33dcf3590b4"
     }
   ],
-  "contentDigest": "sha256:35d8b3571f0a3d2e01916e1df450e4961e64c0822e48bfd549f239d64e293e9a"
+  "contentDigest": "sha256:d596cc6a5f40c22e7deff61709e528e5bde7e58a1e8455b7fe676e505af83d1f"
 }

package/lib/host-packages/cursor/openplanr/CONNECTORS.md

@@ -0,0 +1,62 @@
+# Connectors
+
+OpenPlanr skills name a kind of service, such as `~~chat`, instead of a product. Connect
+the product your team uses through your host: the vendor publishes the connector, and
+you sign in through the host. OpenPlanr bundles no connectors; they and their credentials
+live in your host. Two optional features need a token: Linear sync (`openplanr linear`) and
+company sign-in (`openplanr company login`). Only when you use them does OpenPlanr store a
+token, in your OS keychain, or in an encrypted file at `~/.planr/credentials.enc` if you set
+`PLANR_CREDENTIAL_FILE_PASSPHRASE`. Tokens are sent only to Linear or to the company server
+you sign in to.
+`openplanr company logout` removes company tokens.
+Every skill also works with nothing connected and reports any remote step it skipped.
+
+| Category | Placeholder | Products |
+| --- | --- | --- |
+| Chat | `~~chat` | Slack, Microsoft Teams |
+| Project tracker | `~~project tracker` | Linear, GitHub Issues, Jira, Asana |
+| Source control | `~~source control` | GitHub, GitLab, Bitbucket |
+
+Never paste a token into a chat, file or command for OpenPlanr. After you connect a
+service, start a new request so the host loads its tools.
+
+## Chat (`~~chat`)
+
+Share a status report, sprint note or release notes as a message draft that you review and send yourself.
+
+| Product | Use | Claude Code | Codex | Cursor |
+| --- | --- | --- | --- | --- |
+| Slack | Message drafts | Run `/plugin install slack@claude-plugins-official`, then sign in to Slack from `/mcp`. A workspace admin may need to approve the app. | Install Slack from `/plugins` and sign in when asked. A workspace admin may need to approve the app. | Run `/add-plugin slack`, or install Slack from Customize, then sign in when asked. A workspace admin may need to approve the app. |
+
+Message format for Slack, drafting through the connector: standard Markdown, which the connector converts on send ([Slack's messaging guidance](https://github.com/slackapi/slack-mcp-plugin/blob/main/skills/slack-messaging/SKILL.md)): `**bold**`, `_italic_`, `[link text](https://example.com)`, `-` lists, `>` quotes. Do not use mrkdwn's `*bold*` or `<url|text>` here.
+
+Message format for Slack, text to paste: Slack mrkdwn ([formatting](https://docs.slack.dev/messaging/formatting-message-text)): `*bold*`, `_italic_`, `<https://example.com|link text>`, lines starting with `•` or `-` for lists, `>` for quotes; no headings or tables; escape `&`, `<` and `>` as `&amp;`, `&lt;` and `&gt;`.
+
+Also works with: [Microsoft Teams](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-teams-tools) (read for context). Add the vendor's connector in your host the same way.
+
+Verified: [Slack](https://docs.slack.dev/ai/slack-mcp-server) on 2026-10-09, [Microsoft Teams](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-teams-tools) on 2026-10-09.
+
+## Project tracker (`~~project tracker`)
+
+Push planning status to linked issues after you approve each change, and read issue state back.
+
+| Product | Use | Claude Code | Codex | Cursor |
+| --- | --- | --- | --- | --- |
+| Linear | OpenPlanr syncs with it | Run `/plugin install linear@claude-plugins-official`, then sign in to Linear from `/mcp`. | Install Linear from `/plugins` and sign in when asked. | Run `/add-plugin linear`, or install Linear from Customize, then sign in when asked. |
+| GitHub Issues | OpenPlanr syncs with it | Install the GitHub CLI from cli.github.com and run `gh auth login`. | Install GitHub from `/plugins` and sign in when asked, or install the GitHub CLI and run `gh auth login`. | Install the GitHub CLI from cli.github.com and run `gh auth login`. |
+
+Also works with: [Jira](https://support.atlassian.com/atlassian-ai-gateway/docs/get-started-with-the-atlassian-remote-mcp-server/) (read for context), [Asana](https://developers.asana.com/docs/using-asanas-mcp-server) (read for context). Add the vendor's connector in your host the same way.
+
+Verified: [Linear](https://linear.app/docs/mcp) on 2026-10-09, [GitHub Issues](https://cli.github.com/manual/gh_auth_login) on 2026-10-09, [Jira](https://support.atlassian.com/atlassian-ai-gateway/docs/get-started-with-the-atlassian-remote-mcp-server/) on 2026-10-09, [Asana](https://developers.asana.com/docs/using-asanas-mcp-server) on 2026-10-09.
+
+## Source control (`~~source control`)
+
+Read pull request and branch state for status reports and sprint reviews.
+
+| Product | Use | Claude Code | Codex | Cursor |
+| --- | --- | --- | --- | --- |
+| GitHub | Read for context | Install the GitHub CLI from cli.github.com and run `gh auth login`. | Install GitHub from `/plugins` and sign in when asked, or install the GitHub CLI and run `gh auth login`. | Install the GitHub CLI from cli.github.com and run `gh auth login`. |
+
+Also works with: [GitLab](https://docs.gitlab.com/user/gitlab_duo/model_context_protocol/mcp_server/) (read for context), [Bitbucket](https://support.atlassian.com/atlassian-ai-gateway/docs/get-started-with-the-atlassian-remote-mcp-server/) (read for context). Add the vendor's connector in your host the same way.
+
+Verified: [GitHub](https://cli.github.com/manual/gh_auth_login) on 2026-10-09, [GitLab](https://docs.gitlab.com/user/gitlab_duo/model_context_protocol/mcp_server/) on 2026-10-09, [Bitbucket](https://support.atlassian.com/atlassian-ai-gateway/docs/get-started-with-the-atlassian-remote-mcp-server/) on 2026-10-09.

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

@@ -1,7 +1,7 @@
 {
   "name": "openplanr",
-  "version": "3.0.0",
-  "ruleCount": 28,
+  "version": "3.1.0",
+  "ruleCount": 30,
   "rules": [
     "rules/planr-artifact.mdc",
     "rules/planr-browser-qa.mdc",
@@ -9,6 +9,7 @@
     "rules/planr-chair-review.mdc",
     "rules/planr-challenger-review.mdc",
     "rules/planr-cmo-review.mdc",
+    "rules/planr-connect.mdc",
     "rules/planr-coo-review.mdc",
     "rules/planr-cpo-review.mdc",
     "rules/planr-cto-review.mdc",
@@ -26,6 +27,7 @@
     "rules/planr-plan.mdc",
     "rules/planr-plan-review.mdc",
     "rules/planr-release.mdc",
+    "rules/planr-share.mdc",
     "rules/planr-ship.mdc",
     "rules/planr-spec.mdc",
     "rules/planr-sprint.mdc",

package/lib/host-packages/cursor/openplanr/rules/planr-connect/references/connectors.md

@@ -0,0 +1,62 @@
+# Connectors
+
+OpenPlanr skills name a kind of service, such as `~~chat`, instead of a product. Connect
+the product your team uses through your host: the vendor publishes the connector, and
+you sign in through the host. OpenPlanr bundles no connectors; they and their credentials
+live in your host. Two optional features need a token: Linear sync (`openplanr linear`) and
+company sign-in (`openplanr company login`). Only when you use them does OpenPlanr store a
+token, in your OS keychain, or in an encrypted file at `~/.planr/credentials.enc` if you set
+`PLANR_CREDENTIAL_FILE_PASSPHRASE`. Tokens are sent only to Linear or to the company server
+you sign in to.
+`openplanr company logout` removes company tokens.
+Every skill also works with nothing connected and reports any remote step it skipped.
+
+| Category | Placeholder | Products |
+| --- | --- | --- |
+| Chat | `~~chat` | Slack, Microsoft Teams |
+| Project tracker | `~~project tracker` | Linear, GitHub Issues, Jira, Asana |
+| Source control | `~~source control` | GitHub, GitLab, Bitbucket |
+
+Never paste a token into a chat, file or command for OpenPlanr. After you connect a
+service, start a new request so the host loads its tools.
+
+## Chat (`~~chat`)
+
+Share a status report, sprint note or release notes as a message draft that you review and send yourself.
+
+| Product | Use | Claude Code | Codex | Cursor |
+| --- | --- | --- | --- | --- |
+| Slack | Message drafts | Run `/plugin install slack@claude-plugins-official`, then sign in to Slack from `/mcp`. A workspace admin may need to approve the app. | Install Slack from `/plugins` and sign in when asked. A workspace admin may need to approve the app. | Run `/add-plugin slack`, or install Slack from Customize, then sign in when asked. A workspace admin may need to approve the app. |
+
+Message format for Slack, drafting through the connector: standard Markdown, which the connector converts on send ([Slack's messaging guidance](https://github.com/slackapi/slack-mcp-plugin/blob/main/skills/slack-messaging/SKILL.md)): `**bold**`, `_italic_`, `[link text](https://example.com)`, `-` lists, `>` quotes. Do not use mrkdwn's `*bold*` or `<url|text>` here.
+
+Message format for Slack, text to paste: Slack mrkdwn ([formatting](https://docs.slack.dev/messaging/formatting-message-text)): `*bold*`, `_italic_`, `<https://example.com|link text>`, lines starting with `•` or `-` for lists, `>` for quotes; no headings or tables; escape `&`, `<` and `>` as `&amp;`, `&lt;` and `&gt;`.
+
+Also works with: [Microsoft Teams](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-teams-tools) (read for context). Add the vendor's connector in your host the same way.
+
+Verified: [Slack](https://docs.slack.dev/ai/slack-mcp-server) on 2026-10-09, [Microsoft Teams](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-teams-tools) on 2026-10-09.
+
+## Project tracker (`~~project tracker`)
+
+Push planning status to linked issues after you approve each change, and read issue state back.
+
+| Product | Use | Claude Code | Codex | Cursor |
+| --- | --- | --- | --- | --- |
+| Linear | OpenPlanr syncs with it | Run `/plugin install linear@claude-plugins-official`, then sign in to Linear from `/mcp`. | Install Linear from `/plugins` and sign in when asked. | Run `/add-plugin linear`, or install Linear from Customize, then sign in when asked. |
+| GitHub Issues | OpenPlanr syncs with it | Install the GitHub CLI from cli.github.com and run `gh auth login`. | Install GitHub from `/plugins` and sign in when asked, or install the GitHub CLI and run `gh auth login`. | Install the GitHub CLI from cli.github.com and run `gh auth login`. |
+
+Also works with: [Jira](https://support.atlassian.com/atlassian-ai-gateway/docs/get-started-with-the-atlassian-remote-mcp-server/) (read for context), [Asana](https://developers.asana.com/docs/using-asanas-mcp-server) (read for context). Add the vendor's connector in your host the same way.
+
+Verified: [Linear](https://linear.app/docs/mcp) on 2026-10-09, [GitHub Issues](https://cli.github.com/manual/gh_auth_login) on 2026-10-09, [Jira](https://support.atlassian.com/atlassian-ai-gateway/docs/get-started-with-the-atlassian-remote-mcp-server/) on 2026-10-09, [Asana](https://developers.asana.com/docs/using-asanas-mcp-server) on 2026-10-09.
+
+## Source control (`~~source control`)
+
+Read pull request and branch state for status reports and sprint reviews.
+
+| Product | Use | Claude Code | Codex | Cursor |
+| --- | --- | --- | --- | --- |
+| GitHub | Read for context | Install the GitHub CLI from cli.github.com and run `gh auth login`. | Install GitHub from `/plugins` and sign in when asked, or install the GitHub CLI and run `gh auth login`. | Install the GitHub CLI from cli.github.com and run `gh auth login`. |
+
+Also works with: [GitLab](https://docs.gitlab.com/user/gitlab_duo/model_context_protocol/mcp_server/) (read for context), [Bitbucket](https://support.atlassian.com/atlassian-ai-gateway/docs/get-started-with-the-atlassian-remote-mcp-server/) (read for context). Add the vendor's connector in your host the same way.
+
+Verified: [GitHub](https://cli.github.com/manual/gh_auth_login) on 2026-10-09, [GitLab](https://docs.gitlab.com/user/gitlab_duo/model_context_protocol/mcp_server/) on 2026-10-09, [Bitbucket](https://support.atlassian.com/atlassian-ai-gateway/docs/get-started-with-the-atlassian-remote-mcp-server/) on 2026-10-09.

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

@@ -0,0 +1,58 @@
+---
+alwaysApply: false
+---
+
+# OpenPlanr Connect
+
+Report which chat, project tracker and source control connections the host has, and guide connecting the missing ones through the host. Use when the user wants to connect a service for OpenPlanr or asks what is connected.
+
+Report which service categories this host can reach and help the user connect
+the missing ones through the host's own connectors. OpenPlanr installs no
+connector and never handles a credential: the vendor publishes the connector and
+the user signs in through the host.
+
+## Check each category
+
+The categories are ~~chat, ~~project tracker and ~~source control; their
+products and per-host steps are in [connectors](planr-connect/references/connectors.md). With an
+argument, check only that category; a product name from connectors selects the
+category it belongs to.
+
+A category is connected when the host exposes a tool for one of its products,
+loaded or deferred; search the host's deferred tool list by product name when it
+has one. For ~~project tracker and ~~source control, a signed-in GitHub CLI also
+counts: `gh auth status --hostname github.com` succeeds. Judge by the tools you
+can see; never call a tool that writes, posts or changes anything to find out.
+
+## Connect a missing category
+
+Work through these steps in order for each missing category:
+
+1. **Already available.** If a matching tool appeared since the last check,
+   report the category as connected and name the product. If the host lists the
+   product's connector but offers only a sign-in or authentication notice instead
+   of its tools, report it as configured but not signed in, tell the user to sign
+   in from the host's connector settings, and skip the next two steps for it.
+2. **Connector suggestions.** If the host offers a connector-suggestion
+   capability, such as a tool that searches its connector directory and another
+   that shows a Connect card from a search result, search with the category's
+   product names and the category name, show the card for the best match, and
+   wait for the user to connect. Do not assume any particular tool name.
+3. **Host step.** Otherwise print the current host's step and the vendor's
+   documentation link from [connectors](planr-connect/references/connectors.md).
+
+Then ask the user to run `/planr-connect` again once signed in. Do not retry on
+your own. If a workspace admin must approve the vendor's app first, say so.
+
+## Rules
+
+- Never ask for, read, store or print a token, key or password. If the user
+  pastes one, do not repeat it, and tell them OpenPlanr does not need it.
+- Never edit host configuration, run install or sign-in commands, or sign in on
+  the user's behalf.
+- Recommend the vendor's own connector from the catalog, never a third-party one.
+
+## Return
+
+One line per category: connected (product), configured but not signed in
+(product), or missing with the step shown (Connect card or host step). End with what the user does next.

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

@@ -30,6 +30,8 @@ Claude Code and `$planr:plan` in Codex). Do not perform the routed work here.
 | Refine the open backlog and select the sprint for the next release cut | `planr-sprint` |
 | See planning or Operate state in the browser | `planr-dashboard` |
 | Check artifacts for graph, status, or schema drift | `planr-sync` |
+| Post a status, sprint, or release update to chat | `planr-share` (user-invoked) |
+| Connect chat, a tracker, or source control, or see what is connected | `planr-connect` (user-invoked) |
 | 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` |
@@ -46,6 +48,8 @@ Claude Code and `$planr:plan` in Codex). Do not perform the routed work here.
   review code does not request implementation delegation.
 - PLAN and SHIP are separate user-invoked workflows. Route to one; never chain
   `planr-plan` into `planr-ship` on the user's behalf.
+- `planr-share` and `planr-connect` run only when the user invokes them. When a
+  request matches one, name the command for the user to run instead of running it.
 - 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

package/lib/host-packages/cursor/openplanr/rules/planr-plan/scripts/planning-ids.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
-import { mkdir, open, readdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
-import { resolve } from 'node:path';
+import { open, readdir, readFile, rename, stat, unlink, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
 
 const KINDS = Object.freeze(['SPEC', 'US', 'T']);
 const EMPTY = Object.freeze({ SPEC: 1, US: 1, T: 1 });
@@ -71,9 +71,55 @@ function parseArgs(argv) {
   return options;
 }
 
+const shellQuote = (value) => (/^[\w./-]+$/u.test(value) ? value : `'${value.replaceAll("'", "'\\''")}'`);
+
+/** Returns the nearest `.planr/config.json` at or above `directory` and the specs folder it configures. */
+async function configuredRoot(directory) {
+  for (let current = directory; ; current = dirname(current)) {
+    const configPath = join(current, '.planr', 'config.json');
+    const raw = await readFile(configPath, 'utf8').catch((error) => {
+      if (error.code === 'ENOENT' || error.code === 'ENOTDIR') return null;
+      throw error;
+    });
+    if (raw !== null) {
+      let agile;
+      try {
+        agile = JSON.parse(raw).outputPaths?.agile ?? '.planr';
+      } catch (error) {
+        throw new Error(`Project config ${configPath} is not valid JSON: ${error.message}`);
+      }
+      if (typeof agile !== 'string') throw new Error(`Project config ${configPath} has a non-string outputPaths.agile.`);
+      return { configPath, expected: resolve(current, agile, 'specs') };
+    }
+    if (dirname(current) === current) return null;
+  }
+}
+
+/** Accepts only an existing directory that the nearest project config names as its planning folder. */
+async function assertPlanningRoot(planningRoot) {
+  const project = await configuredRoot(planningRoot);
+  if (!project) {
+    throw new Error(`Planning root ${planningRoot} is not inside an OpenPlanr project: no .planr/config.json in it or any parent directory.`);
+  }
+  const { configPath, expected } = project;
+  if (planningRoot !== expected) {
+    throw new Error(`Planning root ${planningRoot} is not the planning folder configured by ${configPath}, which expects ${expected}.`);
+  }
+  const status = await stat(planningRoot).catch((error) => {
+    if (error.code === 'ENOENT') return null;
+    throw error;
+  });
+  if (!status) {
+    throw new Error(
+      `Planning root ${planningRoot} does not exist; ${configPath} expects it. Create it with \`mkdir -p ${shellQuote(planningRoot)}\`, or fix outputPaths.agile in ${configPath}.`,
+    );
+  }
+  if (!status.isDirectory()) throw new Error(`Planning root ${planningRoot} is not a directory; ${configPath} expects a directory there.`);
+}
+
 async function reserve({ root, preview, counts }) {
   const planningRoot = resolve(root);
-  if (!preview) await mkdir(planningRoot, { recursive: true });
+  await assertPlanningRoot(planningRoot);
   const run = async () => {
     const sequence = await currentSequence(planningRoot);
     const ids = Object.fromEntries(

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

@@ -76,7 +76,10 @@ Write stories and tasks directly in the repository's active planning mode.
 
 - Allocate project-global monotonic `US-NNN` and `T-NNN` IDs. Never reuse a
   deleted ID. The packaged [planning ID helper](planr-plan/scripts/planning-ids.mjs) may
-  inspect or reserve IDs; it never generates content.
+  inspect or reserve IDs; it never generates content. Pass `--root` with the
+  `specs` folder under the project's configured planning path (`.planr/specs`
+  by default). It exits non-zero when that folder is missing or is not the one
+  `.planr/config.json` configures; never fall back to `US-001` or `T-001`.
 - Give each story stable acceptance IDs starting at `AC-001`.
 - Split each story into tasks that are coherent and independently verifiable.
   Separate by ownership first: UI work is a `UI` task for the frontend role and