Embeddings update

ai/factory/bots/guitar/config.yml

@@ -16,8 +16,8 @@ bot:
 
   rag:
     embedding_model: "openai"
-    top_k: 3
-    similarity_threshold: 0.5
+    top_k: 10
+    similarity_threshold: 0.4
 
   boundaries:
     discuss_guitar: true

ai/factory/bots/guitar/data/00-basics.yml

@@ -0,0 +1,62 @@
+meta:
+  bot_id: guitar
+  title: "Guitar Basics"
+  version: "1"
+  date: "2026-02-21"
+
+entries:
+  - id: basics_guitar_anatomy
+    format: object
+    category: Basics
+    heading: Parts of an electric guitar
+    search_terms: "guitar parts, guitar anatomy, parts of guitar, headstock, bridge, pickups"
+    template: "{part}: {description}"
+    items:
+      - part: Headstock
+        description: Top of the neck where tuning pegs (machine heads) are mounted. Turn them to tune each string.
+      - part: Nut
+        description: Small slotted piece between the headstock and first fret. Guides string spacing and sets the open string height.
+      - part: Neck and fretboard
+        description: The long piece you press strings against. Frets are the metal strips. Pressing behind a fret shortens the string and raises the pitch.
+      - part: Body
+        description: Main section of the guitar. Houses the pickups, bridge, controls, and output jack.
+      - part: Pickups
+        description: Magnetic devices under the strings that convert vibrations into electrical signal. Neck pickup is warmer, bridge pickup is brighter.
+      - part: Bridge
+        description: Anchors the strings to the body. Adjustable for intonation (tuning accuracy up the neck) and string height (action).
+      - part: Volume and tone knobs
+        description: Control output level and treble rolloff. Pickup selector switch chooses which pickup is active.
+      - part: Output jack
+        description: Where you plug in the cable to connect to an amp or audio interface.
+
+  - id: basics_string_names
+    format: string
+    category: Basics
+    heading: Guitar string names, numbers, and order
+    search_terms: "string names, string numbers, EADGBE, which string is which, string order"
+    content: |
+      Electric guitar has 6 strings. From thickest (lowest pitch) to thinnest (highest pitch): 6th string = low E, 5th = A, 4th = D, 3rd = G, 2nd = B, 1st = high E. Memory trick: Eddie Ate Dynamite Good Bye Eddie. The 6th string is closest to your face when holding the guitar. Tab and chord diagrams usually show the 1st (high E) string on top.
+
+  - id: basics_how_to_hold
+    format: string
+    category: Basics
+    heading: How to hold an electric guitar and pick
+    search_terms: "how to hold guitar, hold pick, picking hand, fretting hand, guitar posture"
+    content: |
+      Sit or stand with the guitar body resting comfortably. The neck should angle slightly upward, not pointing at the floor. Fretting hand: thumb behind the neck (not wrapped over the top for now), fingers curved, press strings with fingertips just behind the fret (not on top of it). Picking hand: hold the pick between thumb and side of index finger, with a small amount of pick tip showing. Rest your forearm on the guitar body for stability. Stay relaxed; tension causes fatigue and slows you down.
+
+  - id: basics_reading_tab
+    format: string
+    category: Basics
+    heading: How to read guitar tablature (tab)
+    search_terms: "read tab, tablature, guitar tab, how to read tablature, tab notation"
+    content: |
+      Guitar tab uses 6 horizontal lines representing the 6 strings. The top line is the 1st string (high E), bottom line is the 6th string (low E). Numbers on the lines tell you which fret to press. 0 means play the string open. x means mute or do not play that string. Read left to right. Numbers stacked vertically are played at the same time (a chord). Common tab symbols: h = hammer-on, p = pull-off, b = bend, / = slide up, \ = slide down.
+
+  - id: basics_fret_numbering
+    format: string
+    category: Basics
+    heading: How frets and fret numbering work
+    search_terms: "fret numbers, which fret, fret numbering, how frets work"
+    content: |
+      Frets are the metal strips embedded across the fretboard. The first fret is closest to the headstock. Each fret raises the pitch by one half step (one semitone). Fret 12 is one octave above the open string (marked with double dots on most guitars). When someone says "play the 3rd fret," press the string in the space between the 2nd and 3rd fret wire, close to the 3rd fret wire for a clean sound.

ai/factory/bots/guitar/data/01-restringing-tuning.yml

@@ -0,0 +1,68 @@
+meta:
+  bot_id: guitar
+  title: "Restringing and Tuning"
+  version: "1"
+  date: "2026-02-21"
+
+entries:
+  - id: restring_overview
+    format: string
+    category: Restringing
+    heading: How to Restring an Electric Guitar
+    search_terms: "restring guitar, change strings, new strings, replace strings, how to restring"
+    content: |
+      What you need: new strings (correct gauge), string winder (optional), wire cutters, tuner, clean cloth. For floating tremolo bridges, consider a small block/wedge to keep the bridge stable while strings are off.
+
+      Before you start: work on a stable surface; support the neck. If changing string gauge, expect to re-check neck relief and intonation afterward.
+
+      Step-by-step:
+
+      1) Loosen the old strings: detune each string until slack. Cut only if needed; keep the cut end pointed away from you.
+
+      2) Remove old strings: pull the ball end from the bridge (or trem block) and unwind from the tuner post.
+
+      3) Clean while strings are off: wipe the fretboard and frets; remove grime.
+
+      4) Install the new string at the bridge: insert ball end into bridge/tremolo block and pull until seated.
+
+      5) Measure slack at the tuner: pull taut, then back off slightly so you have ~2–3 wraps on wound strings and ~3–5 wraps on plain strings.
+
+      6) Lock into the tuner post: thread through the post hole, bend back on itself, and wind so wraps go downward (toward the headstock face).
+
+      7) Wind to pitch gradually: bring close to pitch, but don't fully crank one string to pitch while others are slack (especially trem guitars).
+
+      8) Repeat for all strings: install low E to high E (or vice versa); keep winding direction consistent and wraps downward.
+
+      9) Stretch and re-tune: gently stretch each string along its length, then re-tune; repeat until stable.
+
+  - id: restring_mistakes
+    format: string
+    category: Restringing
+    heading: Common mistakes to avoid when restringing
+    search_terms: "restring mistakes, string problems, tuning drift, string slipping"
+    content: |
+      Too many wraps (tuning drift), wraps crossing (slip), cutting strings too short (not enough wraps), and not stretching strings (constant de-tuning).
+
+  - id: tuning_standard
+    format: string
+    category: Tuning
+    heading: How to Tune an Electric Guitar (Standard Tuning)
+    search_terms: "tune guitar, standard tuning, tuning, how to tune, EADGBE"
+    content: |
+      Standard tuning from low to high: E A D G B E. Tune each open string with a tuner, then double-check with simple chords (G, C, D, E). Approach pitch from below for stability.
+
+  - id: tuning_reference_pitches
+    format: string
+    category: Tuning
+    heading: Reference pitches for standard tuning
+    search_terms: "reference pitch, 440 Hz, string frequencies, concert pitch"
+    content: |
+      Concert pitch commonly uses A4 = 440 Hz. Approximate open-string fundamental frequencies: E2 82.41 Hz, A2 110.00 Hz, D3 146.83 Hz, G3 196.00 Hz, B3 246.94 Hz, E4 329.63 Hz.
+
+  - id: tuning_checklist
+    format: string
+    category: Tuning
+    heading: Quick tuning checklist
+    search_terms: "tuning checklist, tuning steps, quick tune"
+    content: |
+      1) Tune each open string. 2) Stretch strings lightly. 3) Re-tune. 4) Check again after 5–10 minutes of playing.

ai/factory/bots/guitar/data/02-techniques.yml

@@ -0,0 +1,66 @@
+meta:
+  bot_id: guitar
+  title: "Guitar Techniques"
+  version: "1"
+  date: "2026-02-21"
+
+entries:
+  - id: technique_strumming_patterns
+    format: object
+    category: Techniques
+    heading: Basic strumming patterns for beginners
+    search_terms: "strumming pattern, strum pattern, how to strum, beginner strumming"
+    template: "{name}: {pattern}. {description}"
+    items:
+      - name: All downstrokes
+        pattern: D D D D
+        description: Simplest pattern. One down strum per beat. Good for punk rock and building rhythm.
+      - name: Down-up basic
+        pattern: D DU DU D
+        description: Standard beginner pattern. Down on beats 1-2-3-4, add upstrokes between beats 2-3 and 3-4.
+      - name: Folk/pop strum
+        pattern: D DU UDU
+        description: Versatile pattern for acoustic and pop songs. Accent the down on beat 1 and the up on the "and" of beat 2.
+      - name: Muted 16th feel
+        pattern: D x U x D x U x
+        description: Keep your hand moving in constant down-up motion. Use x to mute by relaxing fretting hand pressure. Creates a funky rhythmic feel.
+
+  - id: technique_palm_muting
+    format: string
+    category: Techniques
+    heading: Palm muting technique
+    search_terms: "palm mute, palm muting, muted strumming, chunky sound, P.M."
+    content: |
+      Palm muting creates a chunky, percussive sound. Rest the fleshy edge of your picking hand lightly on the strings right where they meet the bridge. Too far forward and you completely deaden the strings; too far back and you get no muting. The sweet spot is right at the bridge saddles. Palm muting is essential for power chord riffs and metal rhythm guitar. In tab it is written as P.M. with dashes showing how long to mute.
+
+  - id: technique_hammer_on_pull_off
+    format: string
+    category: Techniques
+    heading: Hammer-ons and pull-offs (legato technique)
+    search_terms: "hammer on, pull off, legato, hammer-on, pull-off, slur"
+    content: |
+      A hammer-on means picking a note then slamming another finger down onto a higher fret without picking again. The force of the finger hitting the fretboard keeps the string ringing. A pull-off is the reverse: start with both fingers down, pick the higher note, then pull the higher finger off (slightly sideways to pluck the string) to sound the lower note. These are the foundation of legato playing and make fast runs smoother. In tab: h = hammer-on, p = pull-off. Example: 5h7 means pick fret 5 then hammer onto fret 7.
+
+  - id: technique_bending
+    format: string
+    category: Techniques
+    heading: String bending and vibrato
+    search_terms: "bend, string bend, bending, vibrato, bend technique"
+    content: |
+      Bending pushes a string sideways (toward the ceiling on the higher strings, toward the floor on the low strings) to raise its pitch. A half-step bend raises the pitch one fret. A full bend raises it two frets. Use your ring finger backed up by the middle and index fingers for strength. Push from the wrist, not just the fingers. Vibrato is a rapid, controlled series of small bends that add expression and sustain to a note. Practice bending to a target pitch by fretting the target note first, listening, then bending up to match it.
+
+  - id: technique_alternate_picking
+    format: string
+    category: Techniques
+    heading: Alternate picking
+    search_terms: "alternate picking, picking technique, down up picking, fast picking"
+    content: |
+      Alternate picking means strictly alternating between downstrokes and upstrokes with the pick, regardless of string changes. Down-up-down-up, never two downs or two ups in a row. This is the most efficient way to pick single notes at speed. Start slow with a metronome. Practice on a single string first, then add string crossing. Keep your picking motion small and relaxed. Economy of motion is the key to speed.
+
+  - id: technique_slides
+    format: string
+    category: Techniques
+    heading: Sliding between notes
+    search_terms: "slide, sliding, slide technique, legato slide"
+    content: |
+      A slide means picking a note and then moving your fretting finger up or down the fretboard to a different fret while maintaining pressure so the string keeps ringing. Slides connect notes smoothly. In tab: / means slide up, \ means slide down. Example: 5/7 means pick fret 5 then slide up to fret 7. Slides can also be used as an approach into a note from a few frets below or above for a soulful effect.

ai/factory/bots/guitar/data/03-scales.yml

@@ -0,0 +1,86 @@
+meta:
+  bot_id: guitar
+  title: "Guitar Scales"
+  version: "1"
+  date: "2026-02-21"
+
+entries:
+  - id: scale_minor_pentatonic
+    format: object
+    category: Scales
+    heading: Minor pentatonic scale (the first scale every guitarist should learn)
+    search_terms: "minor pentatonic, pentatonic scale, first scale, blues scale, box 1"
+    template: |
+      Minor pentatonic {position}. Key of {key}. Root: {root_location}. {tip}
+
+      Tab:
+      {tab}
+    items:
+      - position: box 1 (position 1)
+        key: A minor
+        root_location: 6th string 5th fret
+        tip: The most important scale pattern on guitar. This one box covers most blues and rock soloing. Move it to any fret to change key.
+        tab: |
+          e|---5---8---|
+          B|---5---8---|
+          G|---5---7---|
+          D|---5---7---|
+          A|---5---7---|
+          E|---5---8---|
+      - position: box 2 (position 2)
+        key: A minor
+        root_location: 4th string 7th fret
+        tip: Connects to box 1 going up the neck. Practice shifting between box 1 and box 2 for a wider range.
+        tab: |
+          e|---8---10---|
+          B|---8---10---|
+          G|---7---9----|
+          D|---7---9----|
+          A|---7---10---|
+          E|---8---10---|
+
+  - id: scale_major_pentatonic
+    format: object
+    category: Scales
+    heading: Major pentatonic scale
+    search_terms: "major pentatonic, pentatonic major, country scale, happy scale"
+    template: |
+      Major pentatonic {position}. Key of {key}. Root: {root_location}. {tip}
+
+      Tab:
+      {tab}
+    items:
+      - position: box 1 (position 1)
+        key: G major
+        root_location: 6th string 3rd fret
+        tip: Same shape as E minor pentatonic box 1 but rooted 3 frets lower. Bright, happy sound. Great for country and pop soloing.
+        tab: |
+          e|---2---3---5---|
+          B|---3---5-------|
+          G|---2---4-------|
+          D|---2---4---5---|
+          A|---2---5-------|
+          E|---2---3---5---|
+
+  - id: scale_blues_scale
+    format: object
+    category: Scales
+    heading: Blues scale (minor pentatonic with the blue note)
+    search_terms: "blues scale, blue note, blues solo, blues lick"
+    template: |
+      Blues scale {position}. Key of {key}. Root: {root_location}. {tip}
+
+      Tab:
+      {tab}
+    items:
+      - position: box 1 (position 1)
+        key: A minor blues
+        root_location: 6th string 5th fret
+        tip: "The minor pentatonic with one added note: the flat 5th (blue note) on the D string 8th fret. Notes: A, C, D, Eb, E, G. Use the blue note as a passing tone or bend into it for maximum expression."
+        tab: |
+          e|---5---8-------|
+          B|---5---8-------|
+          G|---5---7-------|
+          D|---5---7---8---|
+          A|---5---7-------|
+          E|---5---8-------|

ai/factory/bots/guitar/data/04-practice.yml

@@ -0,0 +1,26 @@
+meta:
+  bot_id: guitar
+  title: "Guitar Practice Tips"
+  version: "1"
+  date: "2026-02-21"
+
+entries:
+  - id: practice_tips
+    format: object
+    category: Practice
+    heading: Guitar practice tips and routine advice
+    search_terms: "practice tips, how to practice, practice routine, get better at guitar"
+    template: "{tip_title}: {advice}"
+    items:
+      - tip_title: Use a metronome
+        advice: Practice with a metronome or drum track. Start slower than you think you need to. Speed comes from accuracy, not force.
+      - tip_title: Short daily sessions beat long weekly ones
+        advice: 15-20 minutes every day is far more effective than a 2-hour session once a week. Consistency builds muscle memory.
+      - tip_title: Practice what you cannot do
+        advice: It is tempting to play what you already know, but growth comes from working on the hard stuff. Spend at least half your time on challenges.
+      - tip_title: Learn songs you love
+        advice: Theory and exercises matter, but learning real songs keeps you motivated and teaches you how techniques are actually used in music.
+      - tip_title: Record yourself
+        advice: Use your phone to record yourself playing. You will hear issues you miss while focused on fretting. Great for tracking improvement over time.
+      - tip_title: Warm up first
+        advice: Start with chromatic exercises or easy chord changes for a few minutes before diving into difficult material. Cold fingers make more mistakes.

ai/factory/bots/guitar/data/05-gear.yml

@@ -0,0 +1,34 @@
+meta:
+  bot_id: guitar
+  title: "Guitar Gear Guide"
+  version: "1"
+  date: "2026-02-21"
+
+entries:
+  - id: gear_string_gauges
+    format: object
+    category: Gear
+    heading: Electric guitar string gauge guide
+    search_terms: "string gauge, string thickness, 9s, 10s, light strings, heavy strings"
+    template: "{gauge_name} ({range}): {description}"
+    items:
+      - gauge_name: Extra light
+        range: .008-.038
+        description: Very easy to bend and fret. Can sound thin. Good for beginners or players who bend a lot.
+      - gauge_name: Light (most common)
+        range: .009-.042
+        description: The standard for most electric players. Good balance of playability and tone. Sometimes called "nines."
+      - gauge_name: Medium
+        range: .010-.046
+        description: Fuller tone and more volume. Slightly harder to bend. Popular for blues and classic rock. Sometimes called "tens."
+      - gauge_name: Heavy
+        range: .011-.050 or higher
+        description: Thick, powerful tone. Hard to bend. Common for jazz, drop tunings, and heavy rhythm playing.
+
+  - id: gear_picks
+    format: string
+    category: Gear
+    heading: Guitar pick thickness guide
+    search_terms: "pick thickness, pick gauge, thin pick, thick pick, plectrum"
+    content: |
+      Picks come in thin (under 0.60mm), medium (0.60-0.80mm), and heavy (0.80mm and above). Thin picks flex more and are good for strumming but lack control for single notes. Medium picks are the most versatile starting point. Heavy picks give better control for lead playing and precise picking but can feel stiff for strumming. Material matters too: nylon is flexible and grippy, tortex (Dunlop) is stiff with good grip, celluloid is traditional and smooth. Start with a medium pick and experiment from there.