Does it overwrite my existing CLAUDE.md file?

It intelligently detects whether CLAUDE.md or AGENTS.md exists, checks for symlinks to avoid breaking them, and updates the target file with optimized agent instructions while preserving essential context.

Can I run this skill multiple times?

Yes, you can run the onboard skill multiple times to refine the structure, add missing files, or update documentation as the project evolves.

What is the primary purpose of the Blueprint Onboarding skill?

The skill is designed to analyze an existing repository and automatically build a structured documentation environment (Blueprint) that includes ADRs, product specs, and agent instructions to improve AI-assisted coding.

What happens if the skill can't find the rationale for a technology choice?

The skill uses the AskUserQuestion tool to present a list of common rationales (like 'Team familiarity' or 'Industry standard') for you to select from, ensuring your ADRs are accurate.

Blueprint Onboarding

Name: Blueprint Onboarding
Author: rickardp

byrickardp

•

内容管理

Automatically generates a standardized documentation structure including ADRs and technical specs for any repository.

Blueprint Onboarding is a specialized skill for Claude Code designed to accelerate spec-driven development by automatically establishing a comprehensive documentation framework. It scans your repository's dependencies, READMEs, and existing docs to generate Architecture Decision Records (ADRs), product specifications, and boundary rules while intelligently managing agent instruction files like CLAUDE.md. By consolidating tribal knowledge into a structured 'source of truth,' this skill ensures that both human developers and AI agents have the context needed for high-quality, consistent code generation.

主要功能

01Redundant documentation cleanup to ensure a single source of truth

02Intelligent detection and management of CLAUDE.md and AGENTS.md symlinks

03Automatic extraction of tech decisions from package.json and README files

04Creation of detailed product, tech-stack, and boundary specifications

05Standardized ADR generation with YAML frontmatter and rationale tracking

061 GitHub stars

使用场景

01Standardizing documentation structures across a portfolio of microservices

02Initial setup of a repository for AI-assisted coding and spec-driven development

03Auditing and documenting architectural decisions in legacy codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rickardp/blueprint-mode onboard

For use in Claude.ai and ChatGPT

Download Skill