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/
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
Finding all BMAD agents
Type: Agent
Agent type: BMAD
Location: 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