Browser game · TypeScript
Court Vision
A three.js basketball game that teaches newcomers to read the floor: run real plays as the point guard, first against cones, then against defenders who react.
The problem
People who have never played basketball rarely learn where to move, how to space the floor, or which pass is the right one. Most basketball games reward making shots, which teaches none of that.
What I built
Court Vision is a browser game built with three.js. You control one player, starting with the point guard, and run real plays: first with no defenders and heavy guidance, then against defenders who react. Shot-making is de-emphasised. What matters is where you move, who you pass to, and whether you take a good look.
The first version has five point guard plays (Give-and-Go, Drive-and-Kick, Dribble Handoff, High Pick-and-Roll and Horns Set) in three modes: Tutorial, Practice and Scrimmage. It is a static site with no backend. The game logic is a simulation core with no three.js or browser dependency, and plays, roles and defensive coverages are data, not code.
How AI was used
I wrote the design document; my Software Factory pipeline built the game from it. The factory broke the document into issues along its milestones and worked through them one pull request at a time. Where the document was silent or contradicted itself, the question came to me, and the answer was recorded in a decisions log in the repository that later planning runs read.
More than 40 pull requests were merged in the project's first five days.
What kept it safe
- Every pull request runs the type check, lint, unit tests and a production build. Only the main branch deploys.
- The lint step fails if the simulation, content or AI layers import three.js or use browser globals, which keeps the game logic testable without a browser.
- The design treats testing as part of the product, including bots that run each play making the correct read and the wrong one.
Results
The game is playable in the browser and redeploys on every merge.
Lessons and technologies
- A precise design document is what makes agent-built software come out the way you meant.
- TypeScript, Vite, three.js, Vitest, GitHub Actions and GitHub Pages.