{"apiVersion":"2026-06-28","agentUsage":["Use bestVoicing as the preferred playable chord shape under the optimization objective.","Use voicings[].barres and voicings[].playability to explain full or partial barre requirements.","Use barreDisplayProof to render each barre span from voicings[].barres without treating diagram geometry as primary musical state.","Use voicings[].fingering and voicings[].optimization.penalties to explain hand position, barre pressure, and stretch cost."],"bestVoicing":{"barres":[],"coveredIntervals":["5","R","3"],"frets":[null,null,null,0,1,0],"id":"C-major-x-x-x-0-1-0","maxFret":1,"minFret":1,"mutedStrings":[6,5,4],"name":"C major x-x-x-0-1-0","notes":[{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3},{"fret":1,"interval":"R","midi":60,"note":"C4","pitchClass":"C","string":2},{"fret":0,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":1}],"fingering":{"assignments":[{"finger":"open","fret":0,"reason":"open string","string":3},{"finger":"index","fret":1,"reason":"fretted note","string":2},{"finger":"open","fret":0,"reason":"open string","string":1}],"barreFinger":null,"barrePressure":0,"handPositionFret":1,"maxFretReach":0,"primaryBarre":null,"suggestedShape":"S3:open S2:F1:index S1:open","warnings":[]},"optimization":{"cost":23,"efficiencyScore":77,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":0,"fingerStretch":0,"fretPosition":1,"fretSpan":0,"innerStringGaps":0,"missingBassRoot":1,"mutedStrings":3},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":0},"barreDisplayProof":{"domRoles":{"diagram":"barre-span-diagram","empty":"barre-span-empty","span":"barre-span"},"emptyState":"barres.length === 0 means no barre is required for this shape.","renderedSpanSemantics":"Render each barre as a horizontal fretboard span at barre.fret from barre.fromString through barre.toString; coveredStrings are held by the barre and mutedStringsInSpan remain muted.","sourceFields":["frets","barres[]","playability"],"stringOrder":"6-to-1"},"chord":"major","fretRange":"0-15","objective":"minimize-hand-motion-while-covering-chord-tones","root":"C","tuning":"standard-6-string","voicings":[{"barres":[],"coveredIntervals":["5","R","3"],"frets":[null,null,null,0,1,0],"id":"C-major-x-x-x-0-1-0","maxFret":1,"minFret":1,"mutedStrings":[6,5,4],"name":"C major x-x-x-0-1-0","notes":[{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3},{"fret":1,"interval":"R","midi":60,"note":"C4","pitchClass":"C","string":2},{"fret":0,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":1}],"fingering":{"assignments":[{"finger":"open","fret":0,"reason":"open string","string":3},{"finger":"index","fret":1,"reason":"fretted note","string":2},{"finger":"open","fret":0,"reason":"open string","string":1}],"barreFinger":null,"barrePressure":0,"handPositionFret":1,"maxFretReach":0,"primaryBarre":null,"suggestedShape":"S3:open S2:F1:index S1:open","warnings":[]},"optimization":{"cost":23,"efficiencyScore":77,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":0,"fingerStretch":0,"fretPosition":1,"fretSpan":0,"innerStringGaps":0,"missingBassRoot":1,"mutedStrings":3},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":0},{"barres":[],"coveredIntervals":["R","5","3"],"frets":[null,3,null,0,null,0],"id":"C-major-x-3-x-0-x-0","maxFret":3,"minFret":3,"mutedStrings":[6,4,2],"name":"C major x-3-x-0-x-0","notes":[{"fret":3,"interval":"R","midi":48,"note":"C3","pitchClass":"C","string":5},{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3},{"fret":0,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":1}],"fingering":{"assignments":[{"finger":"index","fret":3,"reason":"fretted note","string":5},{"finger":"open","fret":0,"reason":"open string","string":3},{"finger":"open","fret":0,"reason":"open string","string":1}],"barreFinger":null,"barrePressure":0,"handPositionFret":3,"maxFretReach":0,"primaryBarre":null,"suggestedShape":"S5:F3:index S3:open S1:open","warnings":[]},"optimization":{"cost":32,"efficiencyScore":68,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":0,"fingerStretch":0,"fretPosition":3,"fretSpan":0,"innerStringGaps":2,"missingBassRoot":0,"mutedStrings":3},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":0},{"barres":[],"coveredIntervals":["3","5","R"],"frets":[null,null,2,0,1,0],"id":"C-major-x-x-2-0-1-0","maxFret":2,"minFret":1,"mutedStrings":[6,5],"name":"C major x-x-2-0-1-0","notes":[{"fret":2,"interval":"3","midi":52,"note":"E3","pitchClass":"E","string":4},{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3},{"fret":1,"interval":"R","midi":60,"note":"C4","pitchClass":"C","string":2},{"fret":0,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":1}],"fingering":{"assignments":[{"finger":"index","fret":2,"reason":"fretted note","string":4},{"finger":"open","fret":0,"reason":"open string","string":3},{"finger":"index","fret":1,"reason":"fretted note","string":2},{"finger":"open","fret":0,"reason":"open string","string":1}],"barreFinger":null,"barrePressure":0,"handPositionFret":1,"maxFretReach":1,"primaryBarre":null,"suggestedShape":"S4:F2:index S3:open S2:F1:index S1:open","warnings":[]},"optimization":{"cost":33,"efficiencyScore":67,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":1,"fingerStretch":0,"fretPosition":1,"fretSpan":1,"innerStringGaps":0,"missingBassRoot":1,"mutedStrings":2},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":1},{"barres":[],"coveredIntervals":["R","3","5"],"frets":[null,3,2,0,null,0],"id":"C-major-x-3-2-0-x-0","maxFret":3,"minFret":2,"mutedStrings":[6,2],"name":"C major x-3-2-0-x-0","notes":[{"fret":3,"interval":"R","midi":48,"note":"C3","pitchClass":"C","string":5},{"fret":2,"interval":"3","midi":52,"note":"E3","pitchClass":"E","string":4},{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3},{"fret":0,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":1}],"fingering":{"assignments":[{"finger":"index","fret":3,"reason":"fretted note","string":5},{"finger":"index","fret":2,"reason":"fretted note","string":4},{"finger":"open","fret":0,"reason":"open string","string":3},{"finger":"open","fret":0,"reason":"open string","string":1}],"barreFinger":null,"barrePressure":0,"handPositionFret":2,"maxFretReach":1,"primaryBarre":null,"suggestedShape":"S5:F3:index S4:F2:index S3:open S1:open","warnings":[]},"optimization":{"cost":35,"efficiencyScore":65,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":1,"fingerStretch":0,"fretPosition":2,"fretSpan":1,"innerStringGaps":1,"missingBassRoot":0,"mutedStrings":2},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":1},{"barres":[],"coveredIntervals":["R","3","5"],"frets":[null,3,2,0,null,null],"id":"C-major-x-3-2-0-x-x","maxFret":3,"minFret":2,"mutedStrings":[6,2,1],"name":"C major x-3-2-0-x-x","notes":[{"fret":3,"interval":"R","midi":48,"note":"C3","pitchClass":"C","string":5},{"fret":2,"interval":"3","midi":52,"note":"E3","pitchClass":"E","string":4},{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3}],"fingering":{"assignments":[{"finger":"index","fret":3,"reason":"fretted note","string":5},{"finger":"index","fret":2,"reason":"fretted note","string":4},{"finger":"open","fret":0,"reason":"open string","string":3}],"barreFinger":null,"barrePressure":0,"handPositionFret":2,"maxFretReach":1,"primaryBarre":null,"suggestedShape":"S5:F3:index S4:F2:index S3:open","warnings":[]},"optimization":{"cost":35,"efficiencyScore":65,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":0,"fingerStretch":0,"fretPosition":2,"fretSpan":1,"innerStringGaps":0,"missingBassRoot":0,"mutedStrings":3},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":1},{"barres":[{"coveredStrings":[4,3,2],"fret":5,"fromString":4,"kind":"partial","mutedStringsInSpan":[],"soundedStrings":[4,3,2],"toString":2}],"coveredIntervals":["5","R","3"],"frets":[null,null,5,5,5,0],"id":"C-major-x-x-5-5-5-0","maxFret":5,"minFret":5,"mutedStrings":[6,5],"name":"C major x-x-5-5-5-0","notes":[{"fret":5,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":4},{"fret":5,"interval":"R","midi":60,"note":"C4","pitchClass":"C","string":3},{"fret":5,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":2},{"fret":0,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":1}],"fingering":{"assignments":[{"finger":"index","fret":5,"reason":"partial barre contact","string":4},{"finger":"index","fret":5,"reason":"partial barre contact","string":3},{"finger":"index","fret":5,"reason":"partial barre contact","string":2},{"finger":"open","fret":0,"reason":"open string","string":1}],"barreFinger":"index","barrePressure":10,"handPositionFret":5,"maxFretReach":0,"primaryBarre":{"coveredStrings":[4,3,2],"fret":5,"fromString":4,"kind":"partial","mutedStringsInSpan":[],"soundedStrings":[4,3,2],"toString":2},"suggestedShape":"S4:F5:index S3:F5:index S2:F5:index S1:open","warnings":["partial-barre-index-pressure"]},"optimization":{"cost":35,"efficiencyScore":65,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":10,"duplicateChordTones":1,"fingerStretch":0,"fretPosition":5,"fretSpan":0,"innerStringGaps":0,"missingBassRoot":1,"mutedStrings":2},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"partial","primaryBarreFret":5,"requiresBarre":true},"root":"C","span":0},{"barres":[],"coveredIntervals":["5","R","3"],"frets":[null,null,null,0,13,0],"id":"C-major-x-x-x-0-13-0","maxFret":13,"minFret":13,"mutedStrings":[6,5,4],"name":"C major x-x-x-0-13-0","notes":[{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3},{"fret":13,"interval":"R","midi":72,"note":"C5","pitchClass":"C","string":2},{"fret":0,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":1}],"fingering":{"assignments":[{"finger":"open","fret":0,"reason":"open string","string":3},{"finger":"index","fret":13,"reason":"fretted note","string":2},{"finger":"open","fret":0,"reason":"open string","string":1}],"barreFinger":null,"barrePressure":0,"handPositionFret":13,"maxFretReach":0,"primaryBarre":null,"suggestedShape":"S3:open S2:F13:index S1:open","warnings":[]},"optimization":{"cost":35,"efficiencyScore":65,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":0,"fingerStretch":0,"fretPosition":13,"fretSpan":0,"innerStringGaps":0,"missingBassRoot":1,"mutedStrings":3},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":0},{"barres":[],"coveredIntervals":["R","3","5"],"frets":[null,3,2,0,1,0],"id":"C-major-x-3-2-0-1-0","maxFret":3,"minFret":1,"mutedStrings":[6],"name":"C major x-3-2-0-1-0","notes":[{"fret":3,"interval":"R","midi":48,"note":"C3","pitchClass":"C","string":5},{"fret":2,"interval":"3","midi":52,"note":"E3","pitchClass":"E","string":4},{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3},{"fret":1,"interval":"R","midi":60,"note":"C4","pitchClass":"C","string":2},{"fret":0,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":1}],"fingering":{"assignments":[{"finger":"ring","fret":3,"reason":"fretted note","string":5},{"finger":"index","fret":2,"reason":"fretted note","string":4},{"finger":"open","fret":0,"reason":"open string","string":3},{"finger":"index","fret":1,"reason":"fretted note","string":2},{"finger":"open","fret":0,"reason":"open string","string":1}],"barreFinger":null,"barrePressure":0,"handPositionFret":1,"maxFretReach":2,"primaryBarre":null,"suggestedShape":"S5:F3:ring S4:F2:index S3:open S2:F1:index S1:open","warnings":[]},"optimization":{"cost":38,"efficiencyScore":62,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":2,"fingerStretch":0,"fretPosition":1,"fretSpan":2,"innerStringGaps":0,"missingBassRoot":0,"mutedStrings":1},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":2},{"barres":[],"coveredIntervals":["R","5","3"],"frets":[null,null,10,0,null,0],"id":"C-major-x-x-10-0-x-0","maxFret":10,"minFret":10,"mutedStrings":[6,5,2],"name":"C major x-x-10-0-x-0","notes":[{"fret":10,"interval":"R","midi":60,"note":"C4","pitchClass":"C","string":4},{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3},{"fret":0,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":1}],"fingering":{"assignments":[{"finger":"index","fret":10,"reason":"fretted note","string":4},{"finger":"open","fret":0,"reason":"open string","string":3},{"finger":"open","fret":0,"reason":"open string","string":1}],"barreFinger":null,"barrePressure":0,"handPositionFret":10,"maxFretReach":0,"primaryBarre":null,"suggestedShape":"S4:F10:index S3:open S1:open","warnings":[]},"optimization":{"cost":38,"efficiencyScore":62,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":0,"fingerStretch":0,"fretPosition":10,"fretSpan":0,"innerStringGaps":1,"missingBassRoot":1,"mutedStrings":3},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":0},{"barres":[],"coveredIntervals":["3","5","R"],"frets":[null,null,2,0,1,null],"id":"C-major-x-x-2-0-1-x","maxFret":2,"minFret":1,"mutedStrings":[6,5,1],"name":"C major x-x-2-0-1-x","notes":[{"fret":2,"interval":"3","midi":52,"note":"E3","pitchClass":"E","string":4},{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3},{"fret":1,"interval":"R","midi":60,"note":"C4","pitchClass":"C","string":2}],"fingering":{"assignments":[{"finger":"index","fret":2,"reason":"fretted note","string":4},{"finger":"open","fret":0,"reason":"open string","string":3},{"finger":"index","fret":1,"reason":"fretted note","string":2}],"barreFinger":null,"barrePressure":0,"handPositionFret":1,"maxFretReach":1,"primaryBarre":null,"suggestedShape":"S4:F2:index S3:open S2:F1:index","warnings":[]},"optimization":{"cost":39,"efficiencyScore":61,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":0,"fingerStretch":0,"fretPosition":1,"fretSpan":1,"innerStringGaps":0,"missingBassRoot":1,"mutedStrings":3},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":1},{"barres":[{"coveredStrings":[4,3,2],"fret":5,"fromString":4,"kind":"partial","mutedStringsInSpan":[],"soundedStrings":[4,3,2],"toString":2}],"coveredIntervals":["5","R","3"],"frets":[null,null,5,5,5,null],"id":"C-major-x-x-5-5-5-x","maxFret":5,"minFret":5,"mutedStrings":[6,5,1],"name":"C major x-x-5-5-5-x","notes":[{"fret":5,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":4},{"fret":5,"interval":"R","midi":60,"note":"C4","pitchClass":"C","string":3},{"fret":5,"interval":"3","midi":64,"note":"E4","pitchClass":"E","string":2}],"fingering":{"assignments":[{"finger":"index","fret":5,"reason":"partial barre contact","string":4},{"finger":"index","fret":5,"reason":"partial barre contact","string":3},{"finger":"index","fret":5,"reason":"partial barre contact","string":2}],"barreFinger":"index","barrePressure":10,"handPositionFret":5,"maxFretReach":0,"primaryBarre":{"coveredStrings":[4,3,2],"fret":5,"fromString":4,"kind":"partial","mutedStringsInSpan":[],"soundedStrings":[4,3,2],"toString":2},"suggestedShape":"S4:F5:index S3:F5:index S2:F5:index","warnings":["partial-barre-index-pressure"]},"optimization":{"cost":41,"efficiencyScore":59,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":10,"duplicateChordTones":0,"fingerStretch":0,"fretPosition":5,"fretSpan":0,"innerStringGaps":0,"missingBassRoot":1,"mutedStrings":3},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"partial","primaryBarreFret":5,"requiresBarre":true},"root":"C","span":0},{"barres":[],"coveredIntervals":["R","3","5"],"frets":[null,3,2,0,1,null],"id":"C-major-x-3-2-0-1-x","maxFret":3,"minFret":1,"mutedStrings":[6,1],"name":"C major x-3-2-0-1-x","notes":[{"fret":3,"interval":"R","midi":48,"note":"C3","pitchClass":"C","string":5},{"fret":2,"interval":"3","midi":52,"note":"E3","pitchClass":"E","string":4},{"fret":0,"interval":"5","midi":55,"note":"G3","pitchClass":"G","string":3},{"fret":1,"interval":"R","midi":60,"note":"C4","pitchClass":"C","string":2}],"fingering":{"assignments":[{"finger":"ring","fret":3,"reason":"fretted note","string":5},{"finger":"index","fret":2,"reason":"fretted note","string":4},{"finger":"open","fret":0,"reason":"open string","string":3},{"finger":"index","fret":1,"reason":"fretted note","string":2}],"barreFinger":null,"barrePressure":0,"handPositionFret":1,"maxFretReach":2,"primaryBarre":null,"suggestedShape":"S5:F3:ring S4:F2:index S3:open S2:F1:index","warnings":[]},"optimization":{"cost":44,"efficiencyScore":56,"objective":"minimize-hand-motion-while-covering-chord-tones","penalties":{"barrePressure":0,"duplicateChordTones":1,"fingerStretch":0,"fretPosition":1,"fretSpan":2,"innerStringGaps":0,"missingBassRoot":0,"mutedStrings":2},"proof":{"allRequiredPitchClassesCovered":true,"fretSpanWithinLimit":true,"presentPitchClasses":["C","E","G"],"requiredPitchClasses":["C","E","G"]}},"playability":{"barreDifficulty":"none","primaryBarreFret":null,"requiresBarre":false},"root":"C","span":2}]}