docs: recommend codex personal plugin path

Author: pejmanjohn

README.md

@@ -22,12 +22,13 @@ The installable plugin bundle lives under [`claude/README.md`](./claude/README.m
 ## Install
 
 ```bash
-git clone https://github.com/pejmanjohn/cc-plugin-codex.git
-cd cc-plugin-codex
+mkdir -p ~/.codex/plugins
+git clone https://github.com/pejmanjohn/cc-plugin-codex.git ~/.codex/plugins/cc-plugin-codex
+cd ~/.codex/plugins/cc-plugin-codex
 ./scripts/install.sh
 ```
 
-The installer uses Codex's official `plugin/install` backend against this repo's local marketplace file, so you do not need to edit any Codex marketplace configuration by hand.
+This keeps the source checkout under Codex's documented personal plugin directory convention while still using Codex's official `plugin/install` backend for the actual install.
 
 ## Verify
 
@@ -50,13 +51,15 @@ After install, you should see the bundled Claude Companion skills in Codex. The
 ## Update
 
 ```bash
+cd ~/.codex/plugins/cc-plugin-codex
 git pull
 ./scripts/install.sh
 ```
 
 ## Uninstall
 
 ```bash
+cd ~/.codex/plugins/cc-plugin-codex
 ./scripts/uninstall.sh
 ```
 

src/claude/repo-publishability.test.ts

@@ -36,8 +36,9 @@ describe('repository publishability', () => {
     expect(rootReadme).toContain('Claude Code');
     expect(rootReadme).not.toContain('local Claude CLI');
     expect(rootReadme).not.toContain('delegate rescue work');
-    expect(rootReadme).toContain('git clone https://github.com/pejmanjohn/cc-plugin-codex.git');
-    expect(rootReadme).toContain('cd cc-plugin-codex');
+    expect(rootReadme).toContain('mkdir -p ~/.codex/plugins');
+    expect(rootReadme).toContain('git clone https://github.com/pejmanjohn/cc-plugin-codex.git ~/.codex/plugins/cc-plugin-codex');
+    expect(rootReadme).toContain('cd ~/.codex/plugins/cc-plugin-codex');
     expect(rootReadme).toContain('./scripts/install.sh');
     expect(rootReadme).toContain('./scripts/uninstall.sh');
     expect(rootReadme).toContain('$claude-setup');