Grappling Notation

Living Standard v0.0.3

A Symbolic Notation System for Grappling

Inspired by chess notation and fighting game move lists, this project provides a living standard you can extend over time to record matches, study flows, or analyze drills.

Notation Examples

See how the notation captures complex grappling sequences in a compact, readable format.

[Gordon ↳ Andre] :: Kimura >> Americana @ Side Control ~ Mount !!

Gordon applies a Kimura to Andre, chains to an Americana, moves from Side Control to Mount, and secures the finish.

[Taina ↳ Brianna] :: Triangle ?? @ Guard // Ref resets the action

Taina attempts a Triangle on Brianna from Guard, the submission fails, and the referee calls for a restart.

[Giancarlo ↳ Ronaldo] :: Armbar >> Omoplata @ Guard ~ Back Control // Advantage awarded

Giancarlo flows from an Armbar to an Omoplata, transitions from Guard to Back Control, and the table tracks the awarded advantage.

Symbol Reference

The core symbols that make up the notation system and their meanings.

Submission Applied

Shows who applies a submission to whom in a sequence.

::

Actor / Action Separator

Splits the competitor context from the action details.

@

Position Indicator

Marks the position where the exchange takes place.

~

Position Transition

Connects the starting position to the next stop in the chain.

!!

Finished

Signals a tap, break, or choke-out that ends the exchange.

??

Failed Attempt

Flags an unsuccessful submission or positional change.

>>

Submission Chain

Links successive attempts or follow-ups in the same sequence.

//

Comment

Adds inline notes such as referee calls or coaching cues.

Use Cases

A versatile system that grows with your needs, from casual note-taking to comprehensive match analysis.

Record Matches

Document complete grappling matches with precise notation, capturing every transition, technique, and position change.

Study Flows

Analyze technique sequences and position progressions to identify patterns and improve your game strategy.

Analyze Drills

Break down training drills into their component parts, making it easier to teach and learn complex sequences.