From 0f2101bce521cc5640f87936459dc6a10b2762fc Mon Sep 17 00:00:00 2001 From: Christophe Vila Date: Sat, 25 Jul 2026 19:07:48 +0200 Subject: [PATCH] docs: add IDEAS.md for informal backlog, link from CLAUDE.md A lightweight, low-friction place to jot future development ideas before they're formalized into a spec/plan -- distinct from docs/superpowers/specs/ and docs/superpowers/plans/, which are for once an idea is ready to be built. Co-Authored-By: Claude Sonnet 5 --- CLAUDE.md | 2 +- docs/IDEAS.md | 15 +++++++++++++++ 2 files changed, 16 insertions(+), 1 deletion(-) create mode 100644 docs/IDEAS.md diff --git a/CLAUDE.md b/CLAUDE.md index d079263..55ca20c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,7 +8,7 @@ geniusrun (Go module `geniusrun/backend`) is a personal web app that pulls runni All Garmin credentials and every tunable analysis-engine parameter (HR zones, phase-detection minutes, pace-artifact filtering, chart colors, etc.) live in a `profile` row scoped to the logged-in user, edited from the frontend's Profile screen. Every table holding synced/tunable data (`profile`, `workout_kinds`/`workout_type_paces`, `activities` and everything under it, `sync_state`/`sync_runs`) is scoped to a `user_id`, so each OIDC account gets its own fully isolated dataset — see Authentication below. There's no admin UI or profile switcher, and `internal/config`'s env vars are limited to process-level plumbing (listen addr, DB path, mcp-garmin subprocess paths). -The "Training plan" tab (`frontend/src/pages/Plan.tsx`) is an intentional empty stub — a future training-recommendation engine (analyzing training-effect balance across kinds, and a pace/HR-zone "delta" between declared targets and workout-derived reality) is deferred; see `docs/superpowers/specs/` and `docs/superpowers/plans/` for the design history behind what's already built and what's still open. +The "Training plan" tab (`frontend/src/pages/Plan.tsx`) is an intentional empty stub — a future training-recommendation engine (analyzing training-effect balance across kinds, and a pace/HR-zone "delta" between declared targets and workout-derived reality) is deferred; see `docs/superpowers/specs/` and `docs/superpowers/plans/` for the design history behind what's already built and what's still open, and `docs/IDEAS.md` for informal, not-yet-formalized ideas for what's next — check it at the start of a session for context on where to pick up. ## Commands diff --git a/docs/IDEAS.md b/docs/IDEAS.md new file mode 100644 index 0000000..67f3dd7 --- /dev/null +++ b/docs/IDEAS.md @@ -0,0 +1,15 @@ +# Ideas for future development + +Informal running list of things worth doing eventually. Not specs, not plans — +just enough to jog memory at the start of a future session. When one of these +is actually ready to be built, run it through the normal brainstorming -> +writing-plans flow (see `docs/superpowers/specs/` and `docs/superpowers/plans/` +for that history) and remove it from here once a spec exists. + +## Backlog + +- (add ideas here) + +## Someday / maybe + +- (lower-priority or vaguer ideas here)