From 65db5953ecf7fedd1e1f31f158d1dbd845d4b1dc Mon Sep 17 00:00:00 2001
From: MrC <mrc@fabric>
Date: Sun, 3 May 2026 20:48:41 +0000
Subject: [PATCH] Add historical game manuals: 2024 CRESCENDO, 2025 REEFSCAPE

---
 games/2024-crescendo.md | 65 ++++++++++++++++++++++++++++++++++++++++
 games/2025-reefscape.md | 66 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 131 insertions(+)
 create mode 100644 games/2024-crescendo.md
 create mode 100644 games/2025-reefscape.md

diff --git a/games/2024-crescendo.md b/games/2024-crescendo.md
new file mode 100644
index 0000000..7d3d070
--- /dev/null
+++ b/games/2024-crescendo.md
@@ -0,0 +1,65 @@
+---
+type: game-manual
+year: 2024
+game: CRESCENDOSM
+status: historical
+source: https://firstfrc.blob.core.windows.net/frc2024/Manual/2024GameManual.pdf
+source: https://www.firstinspires.org/resource-library/frc/archived-game-documentation
+---
+
+# FRC 2024 — CRESCENDOSM presented by Haas
+
+**Season:** 2024
+**Game:** CRESCENDO
+**Field:** note-based scoring with game pieces (rings/notes)
+
+---
+
+## Game Overview
+
+Two alliances of 3 robots compete to score **NOTES** (game pieces) into targets on the field. Multiple scoring methods: speaker tags, amplifier, trap. Climb on stage at end.
+
+---
+
+## Game Pieces
+
+**NOTES** — game pieces scored in various ways:
+- Speaker tags (amp side)
+- Amplifier (human player feed)
+- Trap (end game)
+
+---
+
+## Match Structure
+
+| Period | Duration | Details |
+|--------|----------|---------|
+| AUTO | 15 sec | Pre-loaded notes, robot moves autonomous |
+| TELEOP | ~2 min | Driver control, scoring continuous |
+| END GAME | 30 sec | Stage climbing, trap scoring |
+
+---
+
+## Scoring Methods
+
+| Target | Points |
+|--------|--------|
+| Speaker tag (auto) | 5 pts |
+| Speaker tag (teleop) | 2 pts |
+| Amplifier | 1 pt |
+| Trap (end game) | 5 pts |
+
+---
+
+## Key Mechanics
+
+- **AMP** — side speaker target for scoring
+- **TRAP** — elevated scoring in end game
+- **STAGE** — robots climb for end game bonuses
+- **Coopertition** — alliance cooperation bonuses
+
+---
+
+## Source
+
+https://firstfrc.blob.core.windows.net/frc2024/Manual/2024GameManual.pdf
\ No newline at end of file
diff --git a/games/2025-reefscape.md b/games/2025-reefscape.md
new file mode 100644
index 0000000..47f052c
--- /dev/null
+++ b/games/2025-reefscape.md
@@ -0,0 +1,66 @@
+---
+type: game-manual
+year: 2025
+game: REEFSCAPE
+status: historical
+source: https://firstfrc.blob.core.windows.net/frc2025/Manual/2025GameManual.pdf
+---
+
+# FRC 2025 — REEFSCAPE
+
+**Season:** 2025
+**Game:** REEFSCAPE
+**Scoring Elements:** CORAL and ALGAE
+
+---
+
+## Game Overview
+
+Two alliances of 3 robots compete to score **CORAL** on their Reef and process **ALGAE** from the opposing alliance's Reef. The field has a central Reef, Coral Stations, a Processor, and a Barge.
+
+---
+
+## Game Pieces
+
+| Element | Description | Scoring Location |
+|---------|-------------|-----------------|
+| **CORAL** | Main scoring element | Reef levels 1-4 |
+| **ALGAE** | Secondary element | Processor, Barge |
+
+---
+
+## Match Structure
+
+| Period | Duration | Details |
+|--------|----------|---------|
+| AUTO | 15 sec | Pre-loaded coral, robots score autonomously |
+| TELEOP | ~2 min | Driver control, continuous scoring |
+| END GAME | 30 sec | Handling on Reef, Barge scoring |
+
+---
+
+## Scoring Methods
+
+**CORAL:**
+- Scored on Reef at levels 1, 2, 3, 4 (higher = more points)
+
+**ALGAE:**
+- Retrieved from own Reef
+- Scored on own Barge OR
+- Processed through Processor for opposing alliance Barge
+
+---
+
+## Key Mechanics
+
+- **REEF** — central structure with 4 scoring levels
+- **CORAL STATION** — where robots get coral
+- **PROCESSOR** — converts algae for opposing alliance
+- **BARGE** — elevated scoring for algae
+- **HANDLING** — end game robot handling on reef structure
+
+---
+
+## Source
+
+https://firstfrc.blob.core.windows.net/frc2025/Manual/2025GameManual.pdf
\ No newline at end of file