The Update Procedure, Step by Step

Preview, Apply, Confirm

Update through the template updater. Claude uses .claude/core/; Codex uses .codex/core/ with the same arguments.

node .claude/core/template-updater.js update /path/to/project --merge --dry-run   # 1. preview
node .claude/core/template-updater.js update /path/to/project --merge             # 2. apply
node .claude/core/render-shared-agents.js --check                                  # 3. confirm projections match

What --merge Keeps

• Your root instructions (managed directives refresh, your prose stays)
• Role personas and Project Context
• Bespoke skills
• Marked project additions
• Local settings

After the Update

1. Read the dry-run output before applying — it is the only free look at what will change
2. Run the render check; a mismatch means a generated file was edited by hand
3. Review or trust newly installed or changed native hooks in your runtime
4. Run your application's gate — not the toolkit's test suite