Skip to main content

What this is

Rules, prompts, and config files you copy into your repo so Cursor (and Copilot / Antigravity) plan before coding, ask one question at a time, and pause for security when it matters.

  • It helps you figure out the right problem before you build.
  • It helps you write down what you want (a spec).
  • It helps you write code without making up stuff.
  • It reminds you to think about security.

It works with Cursor, GitHub Copilot, and Google Antigravity.

What kind of projects?​

Use it for any kind of software project—websites, APIs, mobile apps, Python scripts, data pipelines, internal tools. The workflow (plan → spec → code → security) is the same; only the tech stack and optional design system change. If your project has no UI (e.g. API, CLI, data pipeline), you can leave the design system as TODO.

When to use it​

Use it when you want AI to help you plan or code without getting confused or inventing things.

Steps​

  1. Get your stuff together: Project folder (new or existing), and if you have a UI, your design system name and docs. See Prerequisites.
  2. Get the kit: For a new project, use the starter zip (see Downloads)—unzip it and open that folder as your project root. For an existing project, use the kit-only zip or copy the kit into your repo root (see Install by copying). The kit files (.cursor/, docs/, etc.) must be at the project root, not inside a subfolder.
  3. Fill in a few placeholders (platform type, project info; design system if you have UI). See What to fill in.
  4. When you start work, open Cursor in Plan mode (Shift+Tab), then paste the Session Kickoff and Context Pack.
  5. If the AI does the wrong thing, press Shift+Tab to toggle between Plan mode (planning) and Agent mode (code). In other editors, type Switch: SPEC or Switch: IMPLEMENT.

Common mistakes​

  • Skipping the Context Pack. The AI needs it to stay focused.
  • Letting the AI ask many questions at once. It should ask only ONE question, then you answer, then it continues.
  • Forgetting to switch modes. If it is writing specs and you want code, switch to Agent mode. If it is writing code and you want a plan first, switch to Plan mode.