cat resource.md

Claude Generated Product Specification

A product specification generated by Claude as part of a workshop with work experience students.

Game Night Organiser — Product Specification

Version: 1.0
Date: March 2026
Status: Draft


1. Project Overview & Goals

Game Night Organiser is a lightweight web application that helps a regular group of friends plan, run, and remember their game nights — all without needing to create an account.

The app is accessed via a shared group link, meaning anyone with the link can participate straight away. The goal is to remove the friction of organising a game night: no more group chats trying to agree on a date, no more arguing about what to play, and no more forgetting who won last time.

Goals

  • Make scheduling a game night fast and painless
  • Give everyone in the group a voice in choosing what to play
  • Keep a fun, lasting record of results and achievements

2. Target Users

Primary users: All members of a regular, recurring friend group who play board games, card games, or similar together.

Key characteristics:

  • They already know each other — this is not a discovery or matchmaking app
  • They want something quick and easy to use, not a complex tool
  • They will access the app mostly on their phones, but also on laptops

There is no formal distinction between “host” and “guest” — anyone in the group can take on hosting responsibilities for a given night.


3. Features

Description:
The app requires no account creation or login. A group is created once and given a unique shareable URL. Anyone with the link can access the group and participate fully.

Behaviour:

  • A new group can be created from the homepage, generating a unique link
  • Any member can share the link with others to invite them
  • On first visit, a user enters their name to identify themselves within the group
  • The name is saved in the browser so they are recognised on return visits

Expected output: A persistent group space accessible to all link holders.


3.2 Scheduling — Availability & Date Suggestion

Description:
When a game night is being planned, members submit the dates they are available. The app analyses responses and recommends the date that works for the most people.

Behaviour:

  • Any member can open a new scheduling round and propose a set of candidate dates
  • All members are prompted to mark which dates they can attend
  • Once responses are in (or a deadline is reached), the app highlights the best date — the one with the highest attendance
  • The host can then confirm the date, which is displayed as the next scheduled game night

Expected output: A confirmed upcoming game night date, visible to all group members.


3.3 Game Voting

Description:
Before each game night, members can suggest games they’d like to play and vote on the shortlist.

Behaviour:

  • Any member can nominate a game by entering its name
  • All members can cast a vote for one or more suggested games
  • Votes are tallied in real time and displayed as a ranked list
  • The host can close voting and confirm the chosen game

Expected output: A confirmed game selection for the upcoming night, visible to all.


3.4 Score Tracking

Description:
After each game night, results are logged against the session. This builds up a history of past nights.

Behaviour:

  • The host (or any member) can record results for a completed session
  • The following information is recorded per session:
    • Game played — name of the game
    • Date — when the session took place
    • Duration — how long the session lasted
    • Scores or points — numeric score per player
    • Win/loss — who won
    • Player of the Night / MVP — selected by the group or host

Expected output: A saved session record, added to the group’s history log.


3.5 Leaderboard (Nice-to-have)

Description:
A running leaderboard showing all-time stats across the group, updated after each game night.

Behaviour:

  • Displays a ranked list of all players based on wins or points
  • May include additional stats such as: total games played, win rate, MVP awards
  • Visible to all group members at any time

Expected output: A live leaderboard page showing group-wide performance over time.


4. Out of Scope (Version 1)

The following features are explicitly excluded from the first version to keep scope manageable:

FeatureReason
User accounts / loginReplaced by shared link access
Notifications or remindersAdds complexity; not essential for v1
In-app chat or commentsOut of scope for MVP
Multiple groups per userSingle group link model for now
Game library / database integrationUsers type game names manually
Mobile native app (iOS/Android)Web app only; mobile-friendly design covers this need

5. Success Criteria

The product will be considered successful if:

  1. A group can set up their space and schedule their first game night without needing any instructions
  2. All members can submit availability, vote on games, and view results from a mobile browser
  3. After three game nights, the leaderboard accurately reflects all recorded results
  4. The app is fast to load and works well on a standard mobile data connection
  5. Group members find it more convenient than organising via a group chat

End of Product Specification v1.0