copilot instructions - wccarobotics/ftc-decode GitHub Wiki

Copilot Instructions

This is the GitHub Wiki for the wccarobotics/ftc-decode repository. It belongs to FTC Team 32314, competing in the DECODE 2025-2026 season.

AI Interaction Log (Required)

Every time you assist with a task, you must append an entry to AI-Interaction-Log.md before finishing. Each entry should include:

  • The user's full prompt in bold
  • A brief summary of what you did in a > blockquote

Place entries under the appropriate section heading, or create a new one if needed.

Repository Structure

All content is Markdown wiki pages at the root level. Pages are linked using GitHub Wiki syntax: [[Page Name]]. Key pages:

  • Home.md — Table of contents for the wiki
  • Engineering-Log.md — Chronological build/programming log
  • AI-Interaction-Log.md — Record of all AI-assisted work (FTC rule A201 requires crediting AI usage)
  • Portfolio-*.md — Award portfolio drafts (Think, Control, Reach, Sustain)
  • Wiring.md — Robot pinout tables for the starter bot and RI3D robot
  • Programming.md — Programming exercises and learning resources

FTC Competition Manual

When referencing FTC rules, always use the HTML version at: https://ftc-resources.firstinspires.org/ftc/game/cm-html

Never use the PDF version — it cannot be reliably parsed by AI tools.

The sibling repository D:\git\robotics\wccarobotics.github.io contains a decode_manual_sections/ directory with the Competition Manual pre-split into ~88 text files by section (generated by fetching the HTML version and splitting by heading). Use those for quick, accurate rules lookups instead of fetching the HTML each time. If the files are missing or outdated (check for Team Updates), regenerate them from the HTML URL above.

Conventions

  • Wiki links use double-bracket syntax: [[Page Name]]
  • Engineering log entries are in reverse chronological order with # M/D/YYYY headings
  • The team uses Java, Pedro Pathing, Limelight 3A, GoBilda Pinpoint odometry, and REV Control/Expansion Hubs
  • The robot is a GoBilda RI3D (Robot in 3 Days) with mecanum drive, dual flywheels, intake, diverter, and color sensors

Portfolio PDF Generation

Portfolio-*.md pages contain both portfolio content and reference notes (award criteria, checklists). Use markers to separate them:

  • <!-- portfolio-start --> — content below here is included in the PDF
  • <!-- portfolio-end --> — content below here is excluded from the PDF
  • If no markers are present, the entire page is included
  • Multiple start/end pairs per page are supported

Run python generate_portfolio.py to build portfolio.pdf. The page list and order are configured in PORTFOLIO_PAGES at the top of the script.

⚠️ **GitHub.com Fallback** ⚠️