Is it safe to run on an existing project?

Yes, it includes safety checks, interactive prompts for destructive actions, and options to create backups or git stashes before proceeding with changes.

What does Blueprint Upgrade actually move?

It relocates documentation and state files from legacy folders like .claude/blueprints/ to a consolidated docs/blueprint/ directory, ensuring a cleaner project root.

Do I need to upgrade manually if I am on a very old version?

No, the skill handles incremental migration paths (e.g., 1.x to 2.0, then 2.x to 3.0) to ensure all data is migrated correctly regardless of your starting point.

What happens to my custom modifications during an upgrade?

The skill detects content hashes; if you have modified generated files, it offers to promote them to a custom overrides layer to preserve your changes.

What is the Task Registry introduced in v3.2?

It is a new feature that tracks when maintenance tasks (like PRD derivation or ADR validation) were last run, allowing for smarter scheduling and automated background updates.

Blueprint Upgrade

Name: Blueprint Upgrade
Author: laurigates

bylaurigates

•

Content Management

Migrates project blueprint structures and documentation schemas to the latest standardized format versions.

Blueprint Upgrade automates the transition of project-specific AI instructions, documentation, and workflow states between different format versions. It handles the relocation of files from legacy directories to modern structures, cleans up deprecated command skills, and implements new features like task registries for better maintenance scheduling. This ensures your Claude Code development environment stays compatible with the latest architectural patterns and automation capabilities while maintaining a clean, versioned project history.

Key Features

01Intelligent file relocation from legacy paths to standardized documentation directories

02Automated version detection and multi-step migration pathing

03Implementation of the v3.2 task registry for smart maintenance scheduling

0410 GitHub stars

05Deprecation cleanup for legacy generated commands and skills

06Interactive confirmation of destructive operations with built-in backup options

Use Cases

01Updating an older Claude project to use the modern docs/blueprint/ structure

02Enabling new operational metadata and task tracking features in an existing project

03Cleaning up redundant generated skills after upgrading to centralized workflow execution

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add laurigates/claude-plugins blueprint-upgrade

For use in Claude.ai and ChatGPT

Download Skill