Start a new project

  1. Repo: private, in the right GitHub org.
    • Platform work (Alt:SA engine, server, launcher, Godfather-API, brand) goes in the Alt-SAMP org.
    • Knot Vector's own projects go in Knot-Vector.
    • The default branch is the integration branch (dev or main), and work happens on feature/<name> branches.
  2. Docs: copy templates/repo/* and templates/data/*, fill in the placeholders, and copy tools/changelog.cjs and tools/roadmap.cjs into tools/. See the repo-handover skill.
  3. Roadmap: write stages as thin slices with real goals (roadmap-upkeep).
  4. Test before you ask: if it's a game or app, build a way for the agent to run and check it by itself first (unity-autotest for Unity). Only ask the user to test things a machine can't judge (feel, taste, design).
  5. Design gates: for anything visual (sites, apps, in-game UI), show the user 2–3 directions and get a pick before building.
  6. Website: when the project has users, give it a site (project-site). Alt:SA-family sites use altmp.app and its subdomains; knotvector.com is no longer used for new sites.
  7. Give back: anything you learned that applies beyond this project goes into this toolkit before you finish.