What problem does it solve? Projects initialized on older versions of the Claude Agent framework accumulate outdated config layouts (inline testing/build blocks, root-level mac_build, missing workflow.backend). This Skill upgrades those projects to the current schema without losing data or making silent destructive changes. ## Core Features & Use Cases - Schema version detection: Classifies a project as v1, v2, or v3 by inspecting the root agent.yaml, then runs only the migration steps needed. - Interactive, non-destructive migration: Builds a full migration ledger, asks the user to resolve every conflict and fastlane suggestion, backs up all affected files to .workflow/upgrade-backup-<timestamp>/ before writing anything. - Multi-shape support: Handles single-repo, multi-repo, and mono-repo expansions, moving per-repo config into agent-build.yaml leaf files and migrating iOS mac_build settings. - Use Case: A team whose project was initialized on schema v1 runs the upgrade; the Skill extracts inline testing/build commands into per-repo agent-build.yaml files, rewrites the root agent.yaml to the pointer shape, validates task file Repo: references, and leaves a restorable backup. ## Quick Start Ask the agent to upgrade this project's agent config to the current schema and confirm each proposed change before it is written.
