Move plugin payload to plugins/planr so Codex can install it

Codex 0.138 silently ignores marketplace plugins whose source path is
the repository root; the payload now lives in plugins/planr with the
marketplace manifests pointing at the subdirectory. Fix the documented
install command (codex plugin add planr@planr) and bump to 1.1.2.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: regenrek

.agents/plugins/marketplace.json

@@ -8,7 +8,7 @@
       "name": "planr",
       "source": {
         "source": "local",
-        "path": "./"
+        "path": "./plugins/planr"
       },
       "policy": {
         "installation": "AVAILABLE",

.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
   "plugins": [
     {
       "name": "planr",
-      "source": "./",
+      "source": "./plugins/planr",
       "description": "One $planr entry point, an autonomous $planr-loop, and evidence-backed task graph skills powered by the planr CLI.",
       "category": "productivity"
     }

.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "planr",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Skill-driven planning and execution loop for coding agents: one planr entry point, an autonomous planr-loop, and evidence-backed task graph skills powered by the planr CLI.",
   "author": {
     "name": "instructa"
@@ -9,5 +9,5 @@
   "repository": "https://github.com/instructa/planr",
   "license": "MIT",
   "keywords": ["planning", "task-graph", "agent-loop", "skills"],
-  "skills": "./skills/"
+  "skills": "./plugins/planr/skills/"
 }

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "planr"
-version = "1.1.1"
+version = "1.1.2"
 edition = "2021"
 license = "MIT"
 description = "Local-first planning and execution coordination for coding agents"

Cargo.toml

@@ -122,23 +122,22 @@ cargo run -- close <item-id> --summary "Verified"
 - `src/integrations.rs`: Codex, Claude Code, Cursor, and MCP install descriptors.
 - `src/util.rs`: small CLI-boundary helpers for ids, paths, output, and file writes.
 - `tests/e2e.rs`: real CLI, MCP, HTTP, import, review-gate, run-log, and concurrent-pick tests.
-- `skills/`: public Planr-native skills — `planr` (router), `planr-loop` (autonomous closing loop), `planr-verify-web` (live verification capability), and the stage skills.
-- `agents/`: worker and reviewer subagent roles registered by the plugin.
-- `.codex-plugin/`, `.claude-plugin/`, `.cursor-plugin/`: the repository root doubles as an installable plugin for Codex, Claude Code, and Cursor.
+- `plugins/planr/`: the installable plugin payload — all nine skills, the worker and reviewer subagent roles, and the per-host plugin manifests.
+- `.agents/plugins/marketplace.json`, `.claude-plugin/marketplace.json`: marketplace manifests pointing Codex and Claude Code at `plugins/planr`.
 - `docs/planr-spec/`: production-ready product specification package for Planr V1.
 - `examples/real-world-flow.md`: executable real-world operator flow.
 
 ## Install The Plugin (Skills)
 
-The repository root doubles as an installable plugin for Codex, Claude Code, and Cursor. The plugin carries the nine Planr skills plus the `planr-worker` and `planr-reviewer` subagent roles; the `planr` CLI itself must be installed separately (see [Quick Start](#quick-start)).
+The repository ships an installable plugin for Codex, Claude Code, and Cursor under `plugins/planr`. The plugin carries the nine Planr skills plus the `planr-worker` and `planr-reviewer` subagent roles; the `planr` CLI itself must be installed separately (see [Quick Start](#quick-start)).
 
 <a id="install-plugin-codex"></a>
 <details>
 <summary><strong>Codex</strong></summary>
 
 ```bash
 codex plugin marketplace add instructa/planr
-codex plugin install planr
+codex plugin add planr@planr
 ```
 
 Then invoke skills directly in a session:

README.md

@@ -6,7 +6,7 @@ The Planr repository is a Codex plugin. Install it to get the `$planr`, `$planr-
 
 ```bash
 codex plugin marketplace add instructa/planr
-codex plugin install planr
+codex plugin add planr@planr
 ```
 
 See [Skills](SKILLS.md) for the skill workflow and subagent role templates.

docs/CODEX.md

@@ -78,7 +78,7 @@ The package must include:
 - `docs/`
 - `docs/MCP_CONTRACT.md`
 - `docs/fixtures/mcp-contract.json`
-- `skills/`
+- `plugins/`
 - `README.md`
 - `LICENSE.md`
 

docs/RELEASE.md

@@ -1,8 +1,8 @@
 # Planr Skills
 
-Planr ships agent-facing skill templates under `skills/`.
+Planr ships agent-facing skill templates under `plugins/planr/skills/`.
 
-The repository root is also a plugin for Codex (`.codex-plugin/`), Claude Code (`.claude-plugin/`), and Cursor (`.cursor-plugin/`), so the skills can be installed as one package instead of copied by hand. The plugin only carries skills and agent roles; the `planr` CLI must be installed separately (`brew install instructa/tap/planr`).
+The repository ships an installable plugin under `plugins/planr` for Codex, Claude Code, and Cursor, so the skills can be installed as one package instead of copied by hand. Marketplace manifests at the repo root (`.agents/plugins/marketplace.json`, `.claude-plugin/marketplace.json`) point at that subdirectory — Codex silently ignores marketplaces whose plugin source is the repo root itself. The plugin only carries skills and agent roles; the `planr` CLI must be installed separately (`brew install instructa/tap/planr`).
 
 ## Install As Plugin (preferred)
 
@@ -11,7 +11,7 @@ Codex:
 ```bash
 codex plugin marketplace add instructa/planr
 # then install "planr" from the plugin directory picker, or:
-codex plugin install planr
+codex plugin add planr@planr
 ```
 
 Claude Code:
@@ -21,7 +21,7 @@ Claude Code:
 /plugin install planr@planr
 ```
 
-Skills are namespaced in Claude Code: `/planr:planr`, `/planr:planr-loop`. The plugin also registers the `planr-worker` and `planr-reviewer` subagents from `agents/`.
+Skills are namespaced in Claude Code: `/planr:planr`, `/planr:planr-loop`. The plugin also registers the `planr-worker` and `planr-reviewer` subagents from the plugin's `agents/` directory.
 
 Cursor: pending marketplace review; until listed, use MCP plus the CLI prompt (below).
 
@@ -32,7 +32,7 @@ opencode: no plugin yet; use `planr mcp` as an MCP server (below). A JS plugin w
 Entry points (what users invoke):
 
 - `planr`: master router. One entry point for any request; reads live map state and dispatches to the right skill. Users do not need to remember skill names.
-- `planr-loop`: autonomous closing loop. Drives one feature to verified completion — work, live verification, independent review, fix items — until the map is clean or the iteration budget runs out. Ships subagent templates under `skills/planr-loop/agents/`.
+- `planr-loop`: autonomous closing loop. Drives one feature to verified completion — work, live verification, independent review, fix items — until the map is clean or the iteration budget runs out. Ships subagent templates under `plugins/planr/skills/planr-loop/agents/`.
 
 Capability skills (dispatched by the loop's live-verification step):
 
@@ -161,10 +161,10 @@ Rules that hold in both journeys:
 
 ```bash
 # Codex: project-scoped agents preloading planr-work / planr-review
-cp skills/planr-loop/agents/*.toml .codex/agents/
+cp plugins/planr/skills/planr-loop/agents/*.toml .codex/agents/
 
 # Claude Code standalone (the plugin registers these automatically)
-cp agents/*.md .claude/agents/
+cp plugins/planr/agents/*.md .claude/agents/
 ```
 
 Dispatches stay one line: `Use $planr-work on item <id>` and `Use $planr-review on item <id>`. The map and logs are the loop memory, so any iteration can resume from zero context.
@@ -175,15 +175,15 @@ Copy the Planr skills into Codex's local skill directory:
 
 ```bash
 mkdir -p ~/.codex/skills
-cp -R skills/* ~/.codex/skills/
+cp -R plugins/planr/skills/* ~/.codex/skills/
 ```
 
 If Planr was installed from an npm package that includes `skills/`, copy from the package location instead:
 
 ```bash
 PLANR_PKG="$(npm root -g)/planr"
 mkdir -p ~/.codex/skills
-cp -R "$PLANR_PKG"/skills/* ~/.codex/skills/
+cp -R "$PLANR_PKG"/plugins/planr/skills/* ~/.codex/skills/
 ```
 
 Do not present `npx planr` as the primary install path until the npm artifact ships platform-native Planr binaries. Today the normal user path is the GitHub Release installer; npm is a development and consumer-test wrapper.
@@ -208,8 +208,8 @@ Claude Code loads project skills from `.claude/skills/`:
 
 ```bash
 mkdir -p .claude/skills .claude/agents
-cp -R skills/* .claude/skills/
-cp skills/planr-loop/agents/claude/*.md .claude/agents/
+cp -R plugins/planr/skills/* .claude/skills/
+cp plugins/planr/agents/*.md .claude/agents/
 ```
 
 Then add MCP and the Planr workflow prompt to project instructions when needed:

docs/SKILLS.md

@@ -628,7 +628,7 @@ Dependencies:
 - TASK-DATA-003.
 
 Do not do:
-- Do not reintroduce private runtime copies of agent skills; public templates live under `skills/`.
+- Do not reintroduce private runtime copies of agent skills; public templates live under `plugins/planr/skills/`.
 
 ## MCP And Agent Integrations