Merge pull request #11 from mennlo/update-instructions

fix(): update the copilot instructions

Author: mennlo

.github/copilot-instructions.md

@@ -2,117 +2,151 @@
 
 This document provides instructions for GitHub Copilot to follow when generating or modifying markdown files for the Grappling Games project. These guidelines ensure consistent structure and formatting across all class and game files.
 
+For detailed file structure and formatting guidelines, please refer to [game-format-guidelines.md](game-format-guidelines.md).
+
 ## General Formatting Guidelines
 
 1. Use `#` for main titles, `##` for section headings, and `###` for subsection headings
 2. Use double asterisks (`**`) for bold text, especially for field labels
 3. Use two spaces at the end of a line to create line breaks within sections
 4. Use double line breaks to separate major sections
 
-## Class File Structure (.md files in /classes/ directory)
+## Time Format Standard
 
-Class files should follow this structure:
+Always format time specifications as this unless told otherwise:
+`**Time:** 3 minutes, 2 partners or 6 minutes total - switching back and forth`
 
-```markdown
-# [Name of Class] Class
-**Class Length:** 1 hour
+## GitHub Pages URLs Format
 
-This class consists of several progressive drills that build upon each other. Each drill is available as an individual game file for reference.
+When linking to game files from class files, always use the format:
+`https://mennlo.github.io/grappling-games/md-viewer.html?file=games/path/to/game-file.md`
 
-1. [Game Name 1](https://mennlo.github.io/grappling-games/md-viewer.html?file=games/path/to/game1.md)
-2. [Game Name 2](https://mennlo.github.io/grappling-games/md-viewer.html?file=games/path/to/game2.md)
-3. [Game Name 3](https://mennlo.github.io/grappling-games/md-viewer.html?file=games/path/to/game3.md)
-...
+## Position, Objective, Constraints, Win Format
 
-## [Section Type] Drills
+Always list these fields in order:
+1. **Position:** (always required)
+2. **Objective:** (always required)
+3. **Constraints:** (don't include even if empty)
+4. **Win:** or **Win Condition:** (always required)
 
-### [Section Type] 1 - [Game Name 1](https://mennlo.github.io/grappling-games/md-viewer.html?file=games/path/to/game1.md)
+Each field should be on its own line with two trailing spaces for line breaks.
+
+## Game Format Guidelines
 
-**Overview:** Brief description of the drill.
+## Asymmetric Games (Different Roles for Each Player)
+When creating games where players have different roles, positions, and objectives:
 
+### Details Section Format
+```markdown
+## Details
 **Time:** 3 minutes, 2 partners or 6 minutes total - switching back and forth
 
-#### [Player Role]
-**Position:** Starting position description  
-**Objective:** What the player should try to accomplish  
-**Constraints:** Any limitations on actions (optional)  
-**Win:** Win condition
-
-#### [Other Player Role]
-**Position:** Starting position description  
-**Objective:** What the player should try to accomplish  
-**Constraints:** Any limitations on actions (optional)  
-**Win:** Win condition
-
-**Instructions:**
-1. Step 1
-2. Step 2
-3. Step 3
-4. Step 4
-```
+### Role 1 (e.g., Attacking Player, Bottom Player)
+**Position:** [Starting position description]  
+**Objective:** [What this player should try to accomplish]  
+**Win:** [Win condition for this player]
 
-## Game File Structure (.md files in /games/ directory)
+### Role 2 (e.g., Defending Player, Top Player)
+**Position:** [Starting position description]  
+**Objective:** [What this player should try to accomplish]  
+**Win:** [Win condition for this player]
+```
 
-Game files should follow this structure:
+### Instructions Section Format
+Instructions should clearly differentiate between what each player should do:
+```markdown
+## Instructions
+1. [Role 1] starts with [specific starting position]
+2. [Role 1] works to [achieve objective]
+3. [Role 2] tries to [achieve counter-objective]
+4. [Specific interactions or transitions]
+5. Reset and repeat, switching roles after the predetermined time
+```
 
+### Coaching Points Section Format
+Separate coaching points for each role:
 ```markdown
-# [Game Name]
+## Coaching Points
+For [Role 1]:
+- [Tip 1]
+- [Tip 2]
+- [Tip 3]
+
+For [Role 2]:
+- [Tip 1]
+- [Tip 2]
+- [Tip 3]
+```
 
-## Overview
-Brief description of the game or drill.
+## Symmetric Games (Same Role for Both Players)
+When creating games where both players have the same position, objective, and win conditions:
 
+### Details Section Format
+```markdown
 ## Details
-**Time:** 3 minutes, 2 partners or 6 minutes total - switching back and forth  
-
-### [Player Role]
-**Position:** Starting position description  
-**Objective:** What the player should try to accomplish  
-**Constraints:** Any limitations on actions (optional)  
-**Win:** Win condition
+**Time:** 3 minutes, 2 partners or 6 minutes total - switching back and forth
 
-### [Other Player Role]
-**Position:** Starting position description  
-**Objective:** What the player should try to accomplish  
-**Constraints:** Any limitations on actions (optional)  
-**Win:** Win condition
+**Position:** [Starting position description]  
+**Objective:** [What both players should try to accomplish]  
+**Win:** [Win condition for both players]
+```
 
+### Instructions Section Format
+Instructions should be clear that both players are doing the same thing:
+```markdown
 ## Instructions
-1. Step 1
-2. Step 2
-3. Step 3
-4. Step 4
+1. Both players start [specific starting position]
+2. Both players simultaneously work to [achieve objective]
+3. [Specific rules or constraints]
+4. The first player to achieve their win condition ends the round
+5. Reset and repeat for the predetermined time
+```
 
+### Coaching Points Section Format
+Common coaching points for both players:
+```markdown
 ## Coaching Points
-For [player role]:
-- Coaching tip 1
-- Coaching tip 2
-- Coaching tip 3
-
-For [other player role]:
-- Coaching tip 1
-- Coaching tip 2
-- Coaching tip 3
+For both players:
+- [Tip 1]
+- [Tip 2]
+- [Tip 3]
+- [Tip 4]
 ```
 
-## Time Format Standard
+## Class File Format
+The class file should match the format used in the individual game files:
 
-Always format time specifications as this unless told otherwise:
-`**Time:** 3 minutes, 2 partners or 6 minutes total - switching back and forth`
+### For Asymmetric Games:
+```markdown
+### [Section] [Number] - [Game Name](link)
 
-## GitHub Pages URLs Format
+**Overview:** Brief description
 
-When linking to game files from class files, always use the format:
-`https://mennlo.github.io/grappling-games/md-viewer.html?file=games/path/to/game-file.md`
+**Time:** 3 minutes, 2 partners or 6 minutes total - switching back and forth
 
-## Position, Objective, Constraints, Win Format
+#### Role 1
+**Position:** [Starting position description]  
+**Objective:** [What this player should try to accomplish]  
+**Win:** [Win condition for this player]  
 
-Always list these fields in order:
-1. **Position:** (always required)
-2. **Objective:** (always required)
-3. **Constraints:** (don't include even if empty)
-4. **Win:** or **Win Condition:** (always required)
+#### Role 2
+**Position:** [Starting position description]  
+**Objective:** [What this player should try to accomplish]  
+**Win:** [Win condition for this player]  
+```
 
-Each field should be on its own line with two trailing spaces for line breaks.
+### For Symmetric Games:
+```markdown
+### [Section] [Number] - [Game Name](link)
+
+**Overview:** Brief description
+
+**Time:** 3 minutes, 2 partners or 6 minutes total - switching back and forth
+
+**Position:** [Starting position description]  
+**Objective:** [What both players should try to accomplish]  
+**Win:** [Win condition for both players]  
+```
 
 ## Naming Conventions
 
@@ -127,4 +161,4 @@ Each field should be on its own line with two trailing spaces for line breaks.
 - Pinning Games: `/games/pinning/game-name.md`
 - Standing Games: `/games/standing/game-name.md`
 
-When generating new files, follow this directory structure and use the appropriate templates above.
+When generating new files, follow this directory structure and use the appropriate templates as specified above.

games/standing/progressive-touch-to-bodylock.md

@@ -6,12 +6,6 @@ A competitive standing drill where both partners start with no connections and r
 ## Details
 **Time:** 3 minutes, 2 partners or 6 minutes total - switching back and forth
 
-### Player One
-**Position:** Standing facing your partner with no initial connections  
-**Objective:** Complete three touches (any combination of underhook, hand behind knee, or Russian tie) before establishing a bodylock, or bypass these requirements by shooting for a double leg takedown  
-**Win:** Successfully complete three touches and establish a bodylock, or successfully execute a double leg takedown
-
-### Player Two
 **Position:** Standing facing your partner with no initial connections  
 **Objective:** Complete three touches (any combination of underhook, hand behind knee, or Russian tie) before establishing a bodylock, or bypass these requirements by shooting for a double leg takedown  
 **Win:** Successfully complete three touches and establish a bodylock, or successfully execute a double leg takedown