AI_Cycling_Coach

AI Cycling Coach — Master Plan

Vision

A personal cycling training platform. The Coach (a VS Code Copilot agent) writes structured training plans as Markdown files in plans/. A static website reads those files directly from GitHub and displays them in calendar and list views with category filters. The athlete adds notes and feedback through the website, which commits back to the repo via GitHub API.

No backend server. No database. The repo is the database.

Tech Stack

| Layer | Technology | |——-|———–| | Frontend | React 18 + TypeScript + Vite (static site) | | Data | Markdown plan files in plans/ (YAML frontmatter + Markdown) | | Data access | GitHub API (read plan files, commit athlete notes) | | AI Coach | VS Code Copilot agent (.github/agents/coach.agent.md) | | Calendar | FullCalendar React wrapper | | Styling | CSS custom properties (dark theme) | | State | React hooks + fetch | | Hosting | Static site (GitHub Pages, Vercel, or Netlify) |

Core Features

1. Coach Agent — VS Code Copilot persona that writes/adjusts training plans in Markdown files
2. Calendar View — website displays plan entries on a visual calendar
3. List View — text-based view with category filters (Workout, Life, Work, Note, Checkin)
4. Athlete Notes — write feedback/notes on the website, committed back to repo via GitHub API
5. Plan Adaptation — Coach reads athlete notes during check-ins and adjusts upcoming plans

Project Status

• Architecture designed (v2 — static site, no backend)
• Copilot agent setup (Coach + Coder agents)
• Plan file format defined (plans/TEMPLATE.md)
• Example week created (plans/week-2026-04-13.md)
• Workspace instructions (.github/copilot-instructions.md)
• Frontend rewrite — strip chat UI, add Markdown parser for plan files
• GitHub API integration — read plan files from repo
• Calendar view — parse plan entries onto FullCalendar
• List view with category filtering
• Athlete note editing — commit back to repo via GitHub API
• Remove old backend code (Flask, DB, chat routes)
• Deploy as static site