When should I use the Blueprint Maintenance skill?

You should invoke this skill whenever you modify an existing system, add new features, or refactor code that is described in your project's technical blueprints.

Does this skill automatically update my code?

No, this skill is focused on the documentation side; it helps you identify what documentation needs to change based on your code modifications and ensures the docs remain accurate.

What is documentation drift?

Documentation drift occurs when a codebase evolves but the corresponding documentation is not updated, leading to misleading, outdated, or incorrect technical guides.

Can it help with refactoring projects?

Yes, it specifically guides you to update file paths, architecture diagrams, and usage examples that may have changed during a restructure even if the core logic remained the same.

How does it handle API changes?

The skill provides a process to verify API signatures and examples, ensuring that the documentation reflects the current state of public interfaces and internal behaviors.

Blueprint Maintenance

Name: Blueprint Maintenance
Author: TheBushidoCollective

byTheBushidoCollective

•

コンテンツ管理

Synchronizes technical documentation with code changes to prevent documentation drift and ensure architectural accuracy.

This skill automates and guides the process of keeping technical blueprints in sync with codebase evolutions. By enforcing a structured 'read-before, update-after' workflow, it ensures that API signatures, behavior descriptions, and file paths remain accurate as features are added, modified, or removed. It provides a comprehensive verification checklist and clear patterns for handling various types of changes—from major refactors to feature deprecations—making it an essential tool for developers who prioritize long-term maintainability and professional documentation standards.

主な機能

01Automated workflows for updating API documentation

0295 GitHub stars

03Structured verification checklists for system changes

04Integration with Claude Code hooks for proactive maintenance

05Guidance for handling feature deprecation and removal

06Documentation drift prevention and detection

ユースケース

01Updating system architecture descriptions immediately after a major refactor

02Ensuring public API documentation matches new implementation signatures during development

03Cleaning up stale documentation and orphaned files when removing deprecated features

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han blueprints-maintenance

For use in Claude.ai and ChatGPT

Download Skill