<!-- Parent: ../AGENTS.md -->
<!-- Generated: 2026-03-18 | Updated: 2026-03-18 -->
GrappleMap
Purpose
Vendored GrappleMap project: source, scripts, and GrappleMap.txt for BJJ positions/transitions. Lives in the Sunnah Skills repo at GrappleMap/. Do not commit preview/node_modules, **/dist, or .playwright-mcp/ (see GrappleMap/.gitignore).
Structure
| Directory | Purpose |
|---|
preview/ | Vite preview application |
drills/ | .script files for technique sequences |
doc/ | GrappleMap documentation |
blender/ | Blender-related files |
components/ | Shared components |
scripts/ | Data processing scripts |
proofs/ | Proof-of-concept code |
Key Files
| File | Description |
|---|
GrappleMap.txt | ~2.6MB plain-text database of positions and transitions |
README.md | GrappleMap project overview |
Data Flow
GrappleMap.txt (source database)
└── Scripts/process
└── JSON output
└── client/public/data/sequence.json
For AI Agents
Working In This Directory
- Has its own preview app (
preview/, run npm install there if needed)
- Pipeline output is consumed as JSON under
client/public/data/ (not the whole C++ tree)
- See
docs/technique-library.md for integration and extraction scripts
Integration
- Extract sequences from GrappleMap
- Convert to
sequence.json format
- Place in
client/public/data/
- Reference from
MannequinScene.tsx
<!-- MANUAL: -->