Does this skill automatically change my code?

No, the BDFL Migrate skill is designed to analyze and report on your project state. It identifies gaps and provides guidance but never executes the actual migration work itself.

How does the skill verify if a phase is complete?

The skill uses tools like Grep, Glob, and Bash to perform concrete checks against files and configurations to verify that the 'done criteria' defined in your migration milestones are met.

Where is my migration progress stored?

Progress is tracked locally in a .bdfl.yaml file created in your project's root directory, allowing you to resume the migration across different sessions.

Can I skip migration phases?

Phases must generally be completed in order to ensure stability. However, the skill will automatically mark phases as 'skipped' if it determines they genuinely do not apply to your project type.

BDFL Architecture Migrator

Name: BDFL Architecture Migrator
Author: codethread

bycodethread

0•

Productivity & Workflow

Guides existing projects through incremental adoption of the BDFL architecture by tracking milestones and identifying implementation gaps.

BDFL Migrate is a specialized Claude Code skill designed to streamline the transition of legacy or existing projects toward the BDFL architectural pattern. It functions as an automated auditor that reads reference documentation, analyzes your current project structure, and maintains a stateful .bdfl.yaml file to track migration progress. By identifying specific missing criteria across ordered phases, it provides developers with a clear, actionable roadmap without making destructive changes to the codebase, ensuring a stable and verified migration path that adheres to domain-specific best practices.

Key Features

01Ordered phase management to prevent skipping critical architectural dependencies

020 GitHub stars

03Incremental milestone tracking via a local .bdfl.yaml configuration

04Detailed reporting of current status, achieved milestones, and missing requirements

05Automated gap analysis against provided BDFL reference architecture

06Concrete verification of 'Done' criteria using shell commands and file analysis

Use Cases

01Auditing existing projects for compliance with organizational structural standards

02Refactoring monolithic codebases into the BDFL architectural pattern

03Tracking progress during long-term architectural migrations across teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codethread/claude-code-plugins migrate

For use in Claude.ai and ChatGPT

Key Features

01Ordered phase management to prevent skipping critical architectural dependencies

020 GitHub stars

03Incremental milestone tracking via a local .bdfl.yaml configuration

04Detailed reporting of current status, achieved milestones, and missing requirements

05Automated gap analysis against provided BDFL reference architecture

06Concrete verification of 'Done' criteria using shell commands and file analysis

Use Cases

01Auditing existing projects for compliance with organizational structural standards

02Refactoring monolithic codebases into the BDFL architectural pattern

03Tracking progress during long-term architectural migrations across teams