Can it update existing documentation?

Yes, the skill includes an audit phase that reads existing blueprints and updates them to reflect the current state of the implementation.

Where does this skill store the documentation?

All blueprints are stored in a dedicated 'blueprints/' directory located strictly at the repository root to ensure visibility across the entire project.

Does it work with monorepos?

Yes, it is specifically designed to handle systems that span multiple packages or directories while maintaining a centralized documentation hub.

What format are the blueprints in?

Blueprints are generated as Markdown files with YAML frontmatter, containing sections for architecture, API interfaces, behavior, and key files.

Codebase Blueprint Generator

Name: Codebase Blueprint Generator
Author: TheBushidoCollective

byTheBushidoCollective

•

Learning & Documentation

Researches and generates comprehensive system-level documentation and architectural blueprints for your entire codebase.

The generate-blueprints skill enables Claude to perform deep architectural audits of any repository, identifying core systems, API boundaries, and integration points. It automatically builds or updates a standardized 'blueprints/' directory at the repository root, ensuring that your project's internal logic and structure are documented with precision. By using a structured YAML frontmatter format, it creates a searchable, AI-ready knowledge base that helps teams maintain a single source of truth for complex software systems.

Key Features

01Deep Architectural Discovery: Automatically identifies project modules, entry points, and dependencies.

02Smart Documentation Audit: Compares existing documentation against the live codebase to find gaps or outdated info.

03Centralized Root Organization: Enforces a clean, repository-wide documentation structure to prevent fragmented info.

0495 GitHub stars

05Automatic Index Management: Integrates with workspace hooks to maintain a synchronized index of all system blueprints.

06Standardized Markdown Output: Generates blueprints with YAML frontmatter for consistent indexing and discovery.

Use Cases

01Auditing legacy codebases to recover lost knowledge and document undocumented features.

02Accelerating developer onboarding by providing an instantly searchable map of the system architecture.

03Maintaining high documentation standards in fast-moving projects where code changes frequently.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han generate-blueprints

For use in Claude.ai and ChatGPT

Download Skill