What problem does it solve?
This Skill resolves schema drift in blitz runtime artifacts and plugin structures that occurs after plugin upgrades or when working with forked blitz repositories, preventing broken sprint workflows, failed quality gates, and invalid critic validation.
Core Features & Use Cases
- Multi-Scope Auditing: Scans project artifacts (sessions, sprints, stories, roadmap, research docs) and plugin structures (skill frontmatter, hooks, companion files) for schema drift, with support for project, plugin, and full sweep scopes.
- Safe, Idempotent Migration: Runs read-only by default; use
--fix to apply additive migrations that preserve all canonical field names and project-specific extensions, with automatic backups and per-file error isolation.
- Common Use Case: After upgrading the blitz plugin, run conform to automatically add missing
registry_entries to all sprint stories, normalize malformed activity-feed entries, and clean up orphan session locks without manual data entry.
Quick Start
Invoke the conform skill with the --fix flag to automatically migrate all non-conformant blitz artifacts in your current project directory to match the current canonical schema.