feat(code,platform): update plan-with-codex syntax and add prompt refactoring guide

Update plan-with-codex argument-hint to positional syntax. Add
"Refactoring Existing Prompts" section to context-engineering skill.
Fix stale skill count in platform README. Update changelogs.

Author: shafty023

CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+### code v1.2.2
+
+#### Changed
+- Updated `plan-with-codex` command argument-hint to use positional syntax instead of optional bracket notation
+
+### platform v1.0.2
+
+#### Added
+- New "Refactoring Existing Prompts" section in `context-engineering` skill covering pitfalls for stale cross-references, over-abstraction, lost preconditions, and silent behavior changes
+
 ### code v1.2.1
 
 #### Changed

plugins/code/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "code",
   "description": "Code and planning framework plugin",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "author": {
     "name": "ClosedLoop",
     "email": "support@closedloop.ai"

plugins/code/commands/plan-with-codex.md

@@ -1,6 +1,6 @@
 ---
 description: "Iterative plan refinement debate between Claude and Codex"
-argument-hint: [--max-rounds N] [--plan-file PATH] [--codex-model MODEL] <prompt>
+argument-hint: --max-rounds N --plan-file PATH --codex-model MODEL <prompt>
 allowed-tools: Bash, Read, Write, Glob, Grep, TodoWrite, Task, AskUserQuestion
 skills: code:codex-review
 effort: max

plugins/platform/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "platform",
   "description": "ClosedLoop Platform plugin",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "author": {
     "name": "ClosedLoop",
     "email": "support@closedloop.ai"

plugins/platform/README.md

@@ -201,7 +201,7 @@ Covers skill anatomy (SKILL.md frontmatter, scripts/, references/, assets/), the
 
 ### Installing the Plugin
 
-Add the plugin to your Claude Code installation following the standard plugin installation process. Once installed, all three skills activate automatically when the conversation context matches their trigger conditions — no slash command or explicit invocation is required.
+Add the plugin to your Claude Code installation following the standard plugin installation process. Once installed, all five skills activate automatically when the conversation context matches their trigger conditions — no slash command or explicit invocation is required.
 
 ### Using claude-code-expert
 

plugins/platform/skills/context-engineering/skill.md

@@ -309,6 +309,17 @@ See [references/extended-thinking.md](references/extended-thinking.md) for detai
 | Misses context | Add role prompting |
 | Drops steps | Chain into separate prompts |
 
+### Refactoring Existing Prompts
+
+When optimizing or compressing an existing prompt, apply these checks after every structural change:
+
+| Pitfall | Check |
+|---------|-------|
+| Stale cross-references | After renaming or renumbering steps, search for ALL references to old labels (jump targets, "see Step X", resume points) and update them |
+| Over-abstraction | If the model needs exact values to execute (specific keys, field names, command arguments), keep them literal even if they look repetitive -- a generic placeholder the model cannot expand is worse than duplication |
+| Lost preconditions | When merging or removing steps, verify that any precondition checks or guards in the removed step are preserved elsewhere |
+| Silent behavior changes | Diff the before/after and confirm every deleted line is either redundant or relocated, not dropped |
+
 ### Common Tag Names
 
 | Tag | Purpose |