Files
GearBox/.planning/ROADMAP.md

5.9 KiB

Roadmap: GearBox

Milestones

  • v1.0 MVP — Phases 1-3 (shipped 2026-03-15)
  • v1.1 Fixes & Polish — Phases 4-6 (shipped 2026-03-15)
  • v1.2 Collection Power-Ups — Phases 7-9 (shipped 2026-03-16)
  • 🚧 v1.3 Research & Decision Tools — Phases 10-13 (in progress)

Phases

v1.0 MVP (Phases 1-3) — SHIPPED 2026-03-15
  • Phase 1: Foundation and Collection (4/4 plans) — completed 2026-03-14
  • Phase 2: Planning Threads (3/3 plans) — completed 2026-03-15
  • Phase 3: Setups and Dashboard (3/3 plans) — completed 2026-03-15
v1.1 Fixes & Polish (Phases 4-6) — SHIPPED 2026-03-15
  • Phase 4: Database & Planning Fixes (2/2 plans) — completed 2026-03-15
  • Phase 5: Image Handling (2/2 plans) — completed 2026-03-15
  • Phase 6: Category Icons (3/3 plans) — completed 2026-03-15
v1.2 Collection Power-Ups (Phases 7-9) — SHIPPED 2026-03-16
  • Phase 7: Weight Unit Selection (2/2 plans) — completed 2026-03-16
  • Phase 8: Search, Filter, and Candidate Status (2/2 plans) — completed 2026-03-16
  • Phase 9: Weight Classification and Visualization (2/2 plans) — completed 2026-03-16

🚧 v1.3 Research & Decision Tools (In Progress)

Milestone Goal: Give users the tools to actually decide between candidates — compare details side-by-side, see how a pick impacts their setup, and rank/annotate their options.

  • Phase 10: Schema Foundation + Pros/Cons Fields — Migrate schema and deliver pros/cons annotation UI (completed 2026-03-16)
  • Phase 11: Candidate Ranking — Drag-to-reorder priority ranking with rank badges
  • Phase 12: Comparison View — Side-by-side tabular comparison with relative deltas
  • Phase 13: Setup Impact Preview — Per-candidate weight and cost delta against a selected setup

Phase Details

Phase 10: Schema Foundation + Pros/Cons Fields

Goal: Candidates can be annotated with pros and cons, and the database is ready for ranking Depends on: Phase 9 Requirements: RANK-03 Success Criteria (what must be TRUE):

  1. User can open a candidate edit form and see pros and cons text fields
  2. User can save pros and cons text; the text persists across page refreshes
  3. CandidateCard shows a visual indicator when a candidate has pros or cons entered
  4. All existing tests pass after the schema migration (no column drift in test helper) Plans: 1/1 plans complete Plans:
  • 10-01-PLAN.md — Add pros/cons fields through full stack (schema, service, Zod, form, card indicator)

Phase 11: Candidate Ranking

Goal: Users can drag candidates into a priority order that persists and is visually communicated Depends on: Phase 10 Requirements: RANK-01, RANK-02, RANK-04, RANK-05 Success Criteria (what must be TRUE):

  1. User can drag a candidate card to a new position within the thread's candidate list
  2. The reordered sequence is still intact after navigating away and returning
  3. The top three candidates display gold, silver, and bronze rank badges respectively
  4. Drag handles and rank badges are absent on a resolved thread; candidates render in static order Plans: TBD

Phase 12: Comparison View

Goal: Users can view all candidates for a thread side-by-side in a table with relative weight and price deltas Depends on: Phase 11 Requirements: COMP-01, COMP-02, COMP-03, COMP-04 Success Criteria (what must be TRUE):

  1. User can toggle a "Compare" mode on a thread detail page to reveal a tabular view showing weight, price, images, notes, links, status, pros, and cons for every candidate in columns
  2. The lightest candidate column is highlighted and all other columns show their weight difference relative to it; the cheapest candidate is highlighted similarly for price
  3. The comparison table scrolls horizontally on a narrow viewport without breaking layout; the attribute label column stays fixed on the left
  4. A resolved thread shows the comparison table in read-only mode with the winning candidate visually marked Plans: TBD

Phase 13: Setup Impact Preview

Goal: Users can select any setup and see exactly how much weight and cost each candidate would add or subtract Depends on: Phase 12 Requirements: IMPC-01, IMPC-02, IMPC-03, IMPC-04 Success Criteria (what must be TRUE):

  1. User can select a setup from a dropdown in the thread header and each candidate displays a weight delta and cost delta below its name
  2. When the selected setup contains an item in the same category as the thread, the delta reflects replacing that item (negative delta is possible) rather than pure addition
  3. When no category match exists in the selected setup, the delta shows a pure addition amount clearly labeled as "add"
  4. A candidate with no weight recorded shows a "-- (no weight data)" indicator instead of a zero delta Plans: TBD

Progress

Phase Milestone Plans Complete Status Completed
1. Foundation and Collection v1.0 4/4 Complete 2026-03-14
2. Planning Threads v1.0 3/3 Complete 2026-03-15
3. Setups and Dashboard v1.0 3/3 Complete 2026-03-15
4. Database & Planning Fixes v1.1 2/2 Complete 2026-03-15
5. Image Handling v1.1 2/2 Complete 2026-03-15
6. Category Icons v1.1 3/3 Complete 2026-03-15
7. Weight Unit Selection v1.2 2/2 Complete 2026-03-16
8. Search, Filter, and Candidate Status v1.2 2/2 Complete 2026-03-16
9. Weight Classification and Visualization v1.2 2/2 Complete 2026-03-16
10. Schema Foundation + Pros/Cons Fields 1/1 Complete 2026-03-16 -
11. Candidate Ranking v1.3 0/TBD Not started -
12. Comparison View v1.3 0/TBD Not started -
13. Setup Impact Preview v1.3 0/TBD Not started -