Theory and validation
How FretShuffle builds its answers
FretShuffle generates diagrams from explicit interval data rather than storing screenshots. This page documents the assumptions behind those calculations and the limits of the current library.
Instrument and tuning
Every fretboard and chord diagram assumes a six-string guitar in standard tuning, low to high: E–A–D–G–B–E. Alternate tunings, capos and instruments with a different number of strings are outside the current scope.
Scale positions and CAGED labels
Each scale is defined as pitch-class intervals above a root. Five explicit, overlapping patterns are aligned with the E, D, C, A and G CAGED landmarks and transposed as complete shapes.
Position labels describe connected neck regions, not a claim that one universal fingering is mandatory. Players can choose fingerings that suit the phrase and technique.
Note spelling
Notes are spelled by scale degree, preserving the expected sequence of letter names. A sharp or flat preference selects the tonic spelling; when that choice would create unnecessarily complex double accidentals, the simpler enharmonic tonic is used.
Interval labels remain authoritative when enharmonic spellings are possible. Diminished-seventh formulas retain ♭♭7 because that degree describes harmonic function more accurately than the equivalent major 6th.
Chord voicings
Every chord quality has one curated, compact voicing in each CAGED region. Difficult full C-, G- and D-derived grips are reduced to practical four-string forms while retaining every defining chord tone.
Major, dominant and minor seventh voicings may omit the perfect 5th. Altered 5ths and every other defining tone remain present. Finger numbers and barre spans are practical suggestions rather than the only possible fingering.
Validation and corrections
Automated tests cover interval formulas, enharmonic spelling, fretboard pitch calculation, tab order and transposed CAGED chord tones. Musical content changes are checked at the data level and reviewed visually in generated diagrams.
Found a theory or diagram issue? Send a private correction report with the root, family, position or shape, and the result you expected.