Route Stage

Analyze an enriched note against routing memory, vault rules, and generic signals. Move to destination or mark for review.

See references/pipeline.md for stage definitions and status flow. See references/routing.md for the scoring algorithm. See references/para.md and references/johnny-decimal.md for the two folder systems a vault may use (often both, mid-migration). See references/routing-memory.md for the correction and learning loop.

Input

An enriched note in the inbox with status: enriched.

Process

1. Load routing context:

• Read .routing-memory.md from vault root (create with defaults if missing)
• Read vault CLAUDE.md for disambiguation rules
• Run sb vault structure for available destinations
• Run sb note context --note "{note-path}" for keywords and signals

1. Score destinations (priority order):

a. Check .routing-memory.md corrections for matching topics/keywords b. Check .routing-memory.md learned patterns c. Apply vault CLAUDE.md disambiguation rules d. Apply generic signal scoring (per references/routing.md)

Each destination from sb vault structure carries a type. For Johnny Decimal destinations (type: 'jd') also use area and code when scoring: match the note's topic to the area, and prefer an ID code (e.g. 67.01) for a specific note or its parent category code (e.g. 67) for a loose note. See references/johnny-decimal.md.

1. Apply threshold:

• Score >= auto-route-threshold: auto-route, move file, set status: routed
• Score < threshold: set status: pending-review, return without moving

1. If auto-routing, move the file:

   npx @techpickles/sb note move --from "{note-path}" --to "{destination}/"

Update frontmatter: status: routed

1. If pending-review, present suggestions to human (when called by orchestrator):

• Show top 2-3 destinations with scores and reasoning
• Include "Leave in inbox" option
• If user overrides suggestion, capture correction to .routing-memory.md

Capturing Corrections

When the user picks a destination different from the top suggestion:

1. Ask: "Quick note on why {chosen} over {suggested}?"
2. Append to ## Corrections in .routing-memory.md:

   - {YYYY-MM-DD}: "{note title}" routed to "{suggested}", corrected to "{chosen}"
     Reason: {user's reason}

For Johnny Decimal destinations, key the correction on the JD code (e.g. "corrected to 67.01") so the learning loop can match by number, not just folder name.

Output

• Note moved to destination with status: routed, OR
• Note marked status: pending-review for human input

Constraints

• Only suggest destinations from sb vault structure output
• Always include "Leave in inbox" for pending-review notes
• Show reasoning for all suggestions
• Capture corrections on every override (this is how routing improves)