Onboarding

Before we start the hands-on sessions, let's get your environment set up. If you already have your preferred AI harness installed and configured, feel free to skip the first section.

1. AI Harness

Make sure you have one of the following AI harnesses installed and configured to use during the workshop:

• Claude Code
• Cursor
• Antigravity IDE
• Codex

2. Install the OpenSpec CLI

OpenSpec is our Spec-Driven Development (SDD) coordination framework. Install it globally:

npm install -g @fission-ai/openspec@latest

Verify the installation by running:

openspec --help

3. Prepare the Boilerplate Project

Now, let's download the starter project and initialize OpenSpec:

1. Download the Boilerplate:

   • Download the starter boilerplate ZIP archive.
   • Extract the contents into a new directory (e.g., hyperbytes/).

2. Install Dependencies: Open the project in your IDE or terminal, and run:

   pnpm install

   (Note: If you do not have pnpm installed, run npm install instead).

3. Initialize OpenSpec: In the root of the project folder, run:

   openspec init

   • When prompted, select the AI harness(es) you plan to use (e.g., claude, cursor, or antigravity).
   • This command will create the required configuration files (such as CLAUDE.md, .agent/rules/, or .cursorrules) to coordinate your agent's workflow.

4. Verify the Project Setup: Ensure everything compiles and the local development server starts correctly:

   pnpm run check
   pnpm run dev

   Open http://localhost:5173 in your browser to confirm the application layout is running.