blueprints-organization

Organizes project blueprints with naming conventions and duplicate prevention.

187|20|Updated Nov 20, 2025

Search Tags:#documentation #organization #blueprints #duplication #cross-reference

Ready to run

npx skills add https://github.com/TheBushidoCollective/han --skill blueprints-organization

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: blueprints-organization
Source: https://github.com/TheBushidoCollective/han/tree/main/hashi/hashi-blueprints/skills/blueprints-organization
Command: npx skills add https://github.com/TheBushidoCollective/han --skill blueprints-organization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides organizing a blueprints directory, avoiding duplication, and cross-referencing related blueprints.

Core Features & Use Cases

Directory conventions: Flat vs nested structures.
Naming & cross-references: Descriptive kebab-case names and linking.
Duplication prevention: Search before creating new blueprints with MCP tools.

Quick Start

Create a new blueprint file named mcp-server.md and reference it from the index.

Frequently Asked Questions about blueprints-organization

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I organize blueprint documentation to avoid duplication across multiple systems?▼

Organize blueprints in a centralized directory with kebab-case naming and a searchable index README. Before creating new blueprints, search the existing collection to prevent duplicates across system, feature, and integration blueprints, using MCP tools to read and cross-reference related documentation.

What's the best way to structure a blueprints directory for a multi-system project?▼

Blueprints-organization supports both flat and nested directory structures. Choose based on project scale, apply consistent kebab-case naming throughout, maintain centralized cross-references in an index README, and use MCP tooling to enforce naming conventions and search workflows.

How do I set up cross-references between related blueprints?▼

Link related blueprints using descriptive references in your centralized index README. MCP tools enable you to search, read, and write blueprints with consistent naming, ensuring all system, feature, and integration blueprints reference each other accurately during creation and updates.

Can I use this approach with a flat or nested blueprint directory structure?▼

Yes, blueprints-organization applies to projects with both flat and nested directory structures. The Skill enforces consistent naming, centralized indexing, and search-before-create workflows regardless of which structure your project uses.

Why should I search before creating a new blueprint?▼

Searching before creation prevents duplicate documentation across your blueprint collection. Using MCP tools to search existing blueprints ensures you link to or update related content instead of creating redundant system, feature, or integration documentation.