Migrate CKS project state files across plugin versions. Detects version gaps, applies structural changes to .prd/, .learnings/, .monetize/, .context/ directories and state files. Use when: "migrate", "upgrade", "version mismatch", "state migration", "update project state", or when session-start hook reports a version gap.
From cksnpx claudepluginhub cardinalconseils/claude-starter --plugin cksThis skill is limited to using the following tools:
references/version-changes.mdEnables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Ensures user project state files stay compatible as the CKS plugin evolves.
Version stamp: .prd/.cks-version — single-line file containing the CKS version that last touched this project's state.
Migration direction: Always forward. Compare project stamp against plugin version from .claude-plugin/plugin.json.
Idempotent: Every migration must be safe to re-run. Check before writing.
| Path | Created By | Purpose |
|---|---|---|
.prd/PRD-STATE.md | /cks:new | Active phase, status, next action |
.prd/prd-config.json | /cks:bootstrap | Versioning strategy, profile |
.prd/logs/lifecycle.jsonl | Hooks | Append-only event log |
.prd/logs/.current_session_id | session-start.sh | Session correlation ID |
.prd/phases/{NN}-*.md | Phase agents | Phase artifacts |
.learnings/session-*.md | session-learnings.sh | Cross-session knowledge |
.learnings/conventions.md | /cks:sprint-close | Pending convention proposals |
.kickstart/state.md | /cks:kickstart | Kickstart phase tracking |
.monetize/*.md | /cks:monetize | Monetization workflow state |
.context/config.md | /cks:bootstrap | Research source config |
.bootstrap/scan-context.md | /cks:bootstrap | Codebase scan results |
Read references/version-changes.md for the complete changelog of structural changes per version.
.prd/.cks-version first — if missing and .prd/PRD-STATE.md exists, treat as v0.0.0 (pre-migration project).prd/backups/{version}/ first.prd/.cks-version only after all changes succeed.prd/logs/lifecycle.jsonl