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 overlapping fretboard windows are aligned with the E, D, C, A and G CAGED landmarks as they move from low to high for the selected key.
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
Chords begin with the five familiar open CAGED forms. Each form is transposed to the chosen root and its 3rd, 5th or 7th is altered to match the selected chord formula. The result is a practical movable reference, not an exhaustive chord dictionary.
Finger numbers are suggestions derived from fret order. Real musical context, muting and hand comfort may favour partial voicings or different fingering choices.
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? Open a correction report on GitHub with the root, family, position or shape, and the result you expected.