Claude Code Plugins

Community-maintained marketplace

Feedback

Enable AI to make intelligent decisions about where to place new things and how to find existing things

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name intelligent-routing
category collaboration-communication/thinking-methodologies
version 1.0.0
description Enable AI to make intelligent decisions about where to place new things and how to find existing things
author blackbox5/core
verified true
tags routing, organization, file-placement, discovery

Intelligent Routing

Enable AI to make intelligent decisions about where to place new things and how to find existing things in Blackbox5.

This skill ensures consistent organization, making everything discoverable and maintainable.

When placing or finding items in Blackbox5, always follow the four-phase framework: Identify, Route, Validate, Complete.

Use the Type Routing Table from SEMANTIC-INDEX.md, apply Specific Rules from PLACEMENT-RULES.md, and validate against Core Principles.

Determine what type of thing this is Determine the type using identification questions Resolve ambiguous types with clarifying questions Document the type: "This is a [TYPE]" Is it an Agent? (AI entity with its own prompt/behavior) Is it a Skill? (Reusable workflow/framework) Is it a Plan? (Project with tasks/checklist) Is it a Library? (Reusable code) Is it a Script? (Executable code) Is it a Template? (Reusable pattern) Is it a Document? (Documentation/explanation) Is it a Test? (Test code) Is it a Config? (Configuration/settings) Is it a Memory? (Working knowledge) Is it a Runtime? (Execution state) Is it a Module? (Functional unit with agents) Is it a Framework? (Framework pattern) Is it a Tool? (Maintenance/utility) Is it a Workspace? (Active work area) Is it an Example? (Demonstration) Determine where it goes based on type Apply Type Routing Table from SEMANTIC-INDEX.md Apply Specific Rules from PLACEMENT-RULES.md Determine exact path: [primary-location]/[specific-path]/[filename] Ensure the location is correct using core principles Apply Principle 1: Type Consistency Apply Principle 2: Co-location Apply Principle 3: Number Alignment Apply Principle 4: Hidden vs Visible Apply Principle 5: Single Source of Truth Resolve conflicts if multiple locations seem valid Does this match where other things of this type go? Is it near related things? Does the number prefix match the layer? (1-*=agents, 4-*=scripts, 8-*=testing) Should this be hidden (system) or visible (user-facing)? Does this already exist elsewhere? Primary Purpose - What is the MAIN purpose? Primary User - Who primarily uses it? Primary Usage - Where is it primarily used? Most Specific - Use most specific category Finalize placement and document Write down: "Place at: [FULL-PATH]" Create structure if needed (add .purpose.md for new directories) Document related items (tests, docs, examples) Update references (DISCOVERY-INDEX.md, READMEs, cross-references) Provide rationale explaining WHY this location Never guess type - use identification questions Always use Type Routing Table from SEMANTIC-INDEX.md Always validate against Core Principles Never skip conflict resolution Always document related items (tests, docs, examples) Never place randomly - use the framework Don't guess type - use identification questions Don't skip validation - always check principles Don't ignore conflicts - resolve them explicitly Don't forget related items - tests, docs, examples Don't place randomly - use framework New Specialist Agent for data analysis Type: Agent Agent type: Specialist Location: 1-agents/4-specialists/ Specific: 1-agents/4-specialists/data-analyst.md Examples: 1-agents/4-specialists/data-analyst-examples/ Place at: 1-agents/4-specialists/data-analyst.md Create examples at: 1-agents/4-specialists/data-analyst-examples/ New Phase 2 Library for task prioritization Type: Library Phase: Phase 2 (task-related) Location: 4-scripts/lib/ Specific: 4-scripts/lib/task-prioritization/ Tests: 8-testing/unit/libraries/test-task-prioritization.py Place at: 4-scripts/lib/task-prioritization/ Create tests at: 8-testing/unit/libraries/test-task-prioritization.py Update docs: .docs/phase2/ Finding all BMAD agents Type: Agent Agent type: BMAD Location: 1-agents/2-bmad/ Search: find 1-agents/2-bmad/ -name "*.md" Found at: 1-agents/2-bmad/ Search: find 1-agents/2-bmad/ -name "*.md" For placement: - Placement recommendation (where to put new thing) - Rationale explanation (why this location) - Related references (what else is related)

For discovery:

  • Discovery result (where to find existing thing)
  • Search process (how you found it)
  • Related items (what else is related)
This skill integrates with: - docs-routing - For routing documentation - deep-research - For researching before placement - first-principles-thinking - For analyzing placement decisions

Usage phrases:

  • "Use intelligent-routing to determine where to place this new agent"
  • "Use intelligent-routing to find all libraries related to Phase 2"
  • "Apply intelligent-routing to determine where this documentation should go"
docs-routing deep-research first-principles-thinking BRAIN-ARCHITECTURE.md - Overall brain architecture SEMANTIC-INDEX.md - Type system and categories PLACEMENT-RULES.md - Detailed placement rules DISCOVERY-INDEX.md - Quick reference for finding