CommitCrew handbook
Rules of Play
Fake data, real app structure, and the same clubhouse command loop.
What You Are Looking At
Season 1 is archived in the Hall of Fame.
Season 2 is the live demo leaderboard.
Demo names, commits, and scores are fictional.
In demo mode, the web app reads local seed data from apps/web/src/lib/demoData.ts. It does not need Supabase, OpenAI, WhatsApp auth state, or a dashboard password. Flip the environment flags only when you are intentionally wiring up real integrations.
Clubhouse Commands
@c [message]File a commit
Log completed work. Include useful context like time spent, outcome, and what moved forward.
Example: @c shipped the profile page fixes for 2h
@undoUndo last commit
Remove your most recent commit when you posted the wrong thing.
@d [argument]Dispute a score
Reply to a graded commit and make the case for a different ruling.
@g [goal]Add a goal
Set a target that future commits can be matched against.
Example: @g launch portfolio redesign
@glList goals
Show active goals and their numbers for edit, delete, or complete actions.
@g complete #Complete a goal
Close out a goal by number once the work is actually finished.
@bet [pts] [task] by [time]Wager points
Put points on the line for a deadline. The bot asks for confirmation before locking it in.
@callout @[user] [task]Challenge someone
Ask another player to finish a task by a natural-language deadline.
@callout listList challenges
See active callouts that still need a matching commit.
@callout verify @[user]Resolve a challenge
Let the caller or an admin manually award a completed callout.
How Points Hit The Board
Complexity
Blends technical difficulty, time investment, cognitive load, and how much focus the task required.
Impact
Ranges from routine upkeep to a meaningful milestone or finished goal.
Goal matches, reaction bonuses, weekly wins, bets, and callouts can all move the final result. Disputes can also create per-user grading rules so similar work is handled consistently later.
Monthly Standings
Live season
The main board defaults to the current season, with a toggle for all-time totals.
Hall of Fame
Completed seasons move to the trophy shelf with champion details and final standings.
The public demo is seeded so Season 1 appears as a completed Hall of Fame season and Season 2 stays active on the main scoreboard.
Public-Safe By Default
Fake players
Names, avatars, commits, seasons, and changelog commits are safe demo records.
No auth state
.env, auth_info/, build output, dumps, exports, and local sessions stay ignored.
The demo intentionally shows fictional named players, which keeps screenshots human while avoiding private group data.
When You Wire Up The Real Thing
NEXT_PUBLIC_DEMO_MODE=trueNEXT_PUBLIC_DEMO_MODE=false, NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, JWT_SECRETDEMO_MODE=trueDEMO_MODE=false, SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, OPENAI_API_KEY, COMMIT_API_KEYALLOWED_GROUPS, PRODUCTIVITY_GROUP_JID