add context files for coding agents

Author: Gin

CodingAgentContext/AutomationProgramPatterns.md

@@ -0,0 +1,137 @@
+# Automation Program Patterns
+
+## Basic Program Structure (for Single-Switch Programs)
+
+### Required Files
+```
+GameName_ProgramName.h      // Header with class declarations
+GameName_ProgramName.cpp    // Implementation
+```
+Example game names: `PokemonLA`, `PokemonSwSh`, `PokemonSV`, `PokemonBDSP`
+
+### Core Classes
+```cpp
+class ProgramName_Descriptor : public SingleSwitchProgramDescriptor
+class ProgramName : public SingleSwitchProgramInstance
+```
+
+## Essential Includes
+
+### Header (.h)
+```cpp
+#include "CommonFramework/Notifications/EventNotificationsTable.h"
+#include "NintendoSwitch/NintendoSwitch_SingleSwitchProgram.h"
+```
+
+### Implementation (.cpp)
+```cpp
+#include "CommonFramework/Exceptions/ProgramFinishedException.h"
+#include "CommonFramework/Notifications/ProgramNotifications.h"
+#include "NintendoSwitch/Commands/NintendoSwitch_Commands_PushButtons.h"
+```
+
+## Example Program Options
+
+### Common Option Types
+```cpp
+SimpleIntegerOption<uint16_t> NUM_BOXES(
+    "<b>Number of Boxes:</b>",
+    LockMode::LOCK_WHILE_RUNNING,
+    5, 1, 30  // default, min, max
+);
+
+BooleanCheckBoxOption ENABLE_FEATURE(
+    "<b>Enable Feature:</b>",
+    LockMode::LOCK_WHILE_RUNNING,
+    true
+);
+```
+
+### Register Options
+```cpp
+PA_ADD_OPTION(NUM_BOXES);
+PA_ADD_OPTION(ENABLE_FEATURE);
+```
+
+## Notifications
+
+### Declaration (in .h)
+```cpp
+EventNotificationOption NOTIFICATION_STATUS_UPDATE;
+EventNotificationsOption NOTIFICATIONS;
+```
+
+### Initialization (in constructor)
+```cpp
+NOTIFICATION_STATUS_UPDATE("Status Update", true, false, std::chrono::seconds(3600))
+, NOTIFICATIONS({
+    &NOTIFICATION_STATUS_UPDATE,
+    &NOTIFICATION_PROGRAM_FINISH,
+    &NOTIFICATION_ERROR_FATAL,
+})
+```
+
+### Sending Notifications
+```cpp
+send_program_status_notification(env, NOTIFICATION_STATUS_UPDATE);
+send_program_finished_notification(env, NOTIFICATION_PROGRAM_FINISH);
+send_program_fatal_error_notification(env, NOTIFICATION_ERROR_FATAL, "Error message");
+```
+
+## Error Handling
+
+### Standard Pattern
+```cpp
+try{
+    // Main program logic
+    send_program_finished_notification(env, NOTIFICATION_PROGRAM_FINISH);
+}catch(ProgramFinishedException&){
+    send_program_finished_notification(env, NOTIFICATION_PROGRAM_FINISH);
+    throw;
+}catch(std::exception& e){
+    send_program_fatal_error_notification(env, NOTIFICATION_ERROR_FATAL, e.what());
+    throw;
+}
+```
+
+## Controller Input
+
+### Button Presses
+```cpp
+pbf_press_button(context, BUTTON_A, 10, 100);  // button, hold_time, release_time
+pbf_press_dpad(context, DPAD_DOWN, 20, 50);
+context.wait_for_all_requests();  // wait for button to finish execution
+```
+
+### Delays
+```cpp
+context.wait_for(std::chrono::milliseconds(1000));
+```
+
+## Program Registration
+
+### In GameName_Panels.cpp
+```cpp
+// Add include
+#include "Programs/Category/GameName_ProgramName.h"
+
+// Add to make_panels()
+ret.emplace_back(make_single_switch_program<ProgramName_Descriptor, ProgramName>());
+```
+Examples: `PokemonLA_Panels.cpp`, `PokemonSwSh_Panels.cpp`, `PokemonSV_Panels.cpp`
+
+## Descriptor Configuration
+
+```cpp
+ProgramName_Descriptor::ProgramName_Descriptor()
+    : SingleSwitchProgramDescriptor(
+        "GameName:ProgramName",                // Unique ID
+        STRING_POKEMON + " [GameName]", "Display Name",  // Category, Name
+        "ComputerControl/blob/master/Wiki/...",     // Wiki URL
+        "Brief description.",                       // Description
+        ProgramControllerClass::StandardController_NoRestrictions,
+        FeedbackType::REQUIRED,                     // or NONE
+        AllowCommandsWhenRunning::DISABLE_COMMANDS
+    )
+{}
+```

CodingAgentContext/ProjectOverview.md

@@ -0,0 +1,12 @@
+Pokémon Automation - an open-source project for automating Pokémon (and other) games on Nintendo Switch and Switch 2 using Arduino and other micro-controllers.
+
+Key aspects:
+
+- Games supported: Multiple Pokémon titles plus Zelda: Tears of the Kingdom
+- Tech stack: C++23, Qt6, Tesseract OCR, OpenCV, ONNX Runtime
+- Functionality: Uses computer vision, OCR, and predefined controller sequences to automate gameplay
+- Values brought to users:
+    - Automate tedious or grinding tasks in Pokémon games.
+    - Automate hunting rare or shiny Pokémon and Pokémon with specified stats for competitive PvP.
+    - Automate glitch execution to e.g. dupe items.
+    - Automate multiplayer Pokémon raid hosting and joining.