From 7ef1a8821abe9162bd73fbe947189dfdaf3367d0 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 12 Dec 2025 22:28:33 +0000
Subject: [PATCH 01/10] Initial plan


From b8da851fc456ee89899f62dce139641ea9514f1b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 12 Dec 2025 22:31:10 +0000
Subject: [PATCH 02/10] feat: add GitHub Copilot instructions file

Co-authored-by: jog1t <39823706+jog1t@users.noreply.github.com>
---
 .github/COPILOT_INSTRUCTIONS.md | 188 ++++++++++++++++++++++++++++++++
 1 file changed, 188 insertions(+)
 create mode 100644 .github/COPILOT_INSTRUCTIONS.md

diff --git a/.github/COPILOT_INSTRUCTIONS.md b/.github/COPILOT_INSTRUCTIONS.md
new file mode 100644
index 0000000000..887d30ef36
--- /dev/null
+++ b/.github/COPILOT_INSTRUCTIONS.md
@@ -0,0 +1,188 @@
+# Copilot Instructions for Rivet
+
+## Overview
+
+Rivet is a Rust workspace-based monorepo for a distributed actor/server orchestration system. This guide provides essential context for working with the codebase.
+
+## Monorepo Structure
+
+Key packages and components:
+
+- **Core Engine** (`packages/core/engine/`) - Main orchestration service that coordinates all operations
+- **Workflow Engine** (`packages/common/gasoline/`) - Handles complex multi-step operations with reliability and observability
+- **Pegboard** (`packages/core/pegboard/`) - Actor/server lifecycle management system
+- **Common Packages** (`/packages/common/`) - Foundation utilities, database connections, caching, metrics, logging, health checks, workflow engine core
+- **Core Packages** (`/packages/core/`) - Main engine executable, Pegboard actor orchestration, workflow workers
+- **Service Infrastructure** - Distributed services communicate via NATS messaging with service discovery
+
+## Build Commands
+
+```bash
+# Build all packages in the workspace
+cargo build
+
+# Build a specific package
+cargo build -p package-name
+
+# Build with release optimizations
+cargo build --release
+```
+
+## Test Commands
+
+```bash
+# Run all tests in the workspace
+cargo test
+
+# Run tests for a specific package
+cargo test -p package-name
+
+# Run a specific test
+cargo test test_name
+
+# Run tests with output displayed
+cargo test -- --nocapture
+```
+
+## Development Commands
+
+```bash
+# Run linter and fix issues
+./scripts/cargo/fix.sh
+
+# Check for linting issues
+cargo clippy -- -W warnings
+```
+
+**Note**: Do not run `cargo fmt` automatically. Code formatting is handled by pre-commit hooks (lefthook).
+
+## Error Handling
+
+Custom error system at `packages/common/error/` using derive macros with struct-based error definitions.
+
+Example usage:
+
+```rust
+use rivet_error::*;
+use serde::{Serialize, Deserialize};
+
+// Simple error without metadata
+#[derive(RivetError)]
+#[error("auth", "invalid_token", "The provided authentication token is invalid")]
+struct AuthInvalidToken;
+
+// Error with metadata
+#[derive(RivetError, Serialize, Deserialize)]
+#[error(
+    "api",
+    "rate_limited",
+    "Rate limit exceeded",
+    "Rate limit exceeded. Limit: {limit}, resets at: {reset_at}"
+)]
+struct ApiRateLimited {
+    limit: u32,
+    reset_at: i64,
+}
+
+// Use errors in code
+let error = AuthInvalidToken.build();
+let error_with_meta = ApiRateLimited { limit: 100, reset_at: 1234567890 }.build();
+```
+
+Key error handling principles:
+- Use `#[derive(RivetError)]` on struct definitions
+- Use `#[error(group, code, description)]` or `#[error(group, code, description, formatted_message)]` attribute
+- Group errors by module/domain (e.g., "auth", "actor", "namespace")
+- Add `Serialize, Deserialize` derives for errors with metadata fields
+- Always return anyhow errors from failable functions: `fn foo() -> Result<i64> { /* ... */ }`
+- Do not glob import (`::*`) from anyhow. Import individual types and traits instead
+
+## Dependency Management
+
+- When adding a dependency, check for a workspace dependency in `Cargo.toml`
+- If available, use the workspace dependency (e.g., `anyhow.workspace = true`)
+- If adding a new dependency not in the workspace, add it to `[workspace.dependencies]` in root `Cargo.toml`, then reference it with `{dependency}.workspace = true`
+- Use pnpm for all npm-related commands (we use a pnpm workspace)
+
+## Database Usage
+
+- **UniversalDB** for distributed state storage
+- **ClickHouse** for analytics and time-series data
+- Connection pooling through `packages/common/pools/`
+
+## Code Style
+
+- Hard tabs for Rust formatting (see `rustfmt.toml`)
+- Follow existing patterns in neighboring files
+- Always check existing imports and dependencies before adding new ones
+- **Always add imports at the top of the file, not inline within functions**
+
+## Naming Conventions
+
+Data structures often include:
+- `id` (uuid)
+- `name` (machine-readable name, must be valid DNS subdomain, use kebab-case)
+- `description` (human-readable, if applicable)
+
+Timestamp naming:
+- Use `*_at` with past tense verbs (e.g., `created_at`, `destroyed_at`)
+
+## Data Storage
+
+- Use UUID (v4) for generating unique identifiers
+- Store dates as i64 epoch timestamps in milliseconds for precise time tracking
+
+## Logging Patterns
+
+Use tracing for structured logging:
+
+```rust
+// Good: structured logging
+tracing::info!(?x, "foo");
+
+// Bad: formatting into message
+tracing::info!("foo {x}");
+```
+
+- Log messages should be lowercase unless mentioning specific code symbols
+- Example: `tracing::info!("inserted UserRow")` instead of `tracing::info!("Inserted UserRow")`
+
+## Testing Guidelines
+
+- When running tests, pipe output to a file in `/tmp/` then grep in a second step
+- You can grep test logs multiple times to search for different log lines
+
+## Configuration Management
+
+- Do not make changes to `docker/dev*` configs directly
+- Instead, edit the template in `docker/template/` and rerun `(cd docker/template && pnpm start)` to regenerate
+
+## Optimizations
+
+- Never build a new reqwest client from scratch
+- Use `rivet_pools::reqwest::client().await?` to access an existing reqwest client instance
+
+## Documentation
+
+- When talking about "Rivet Actors", capitalize as a proper noun
+- Use lowercase "actor" as a generic noun
+- For Rust package documentation, visit `https://docs.rs/{package-name}`
+
+## Examples
+
+All example READMEs in `/examples/` should follow the format defined in `.claude/resources/EXAMPLE_TEMPLATE.md`.
+
+## Git Workflow
+
+When committing changes, use Graphite CLI with conventional commits:
+```bash
+gt c -m "chore(my-pkg): foo bar"
+```
+
+## Docker Development Environment
+
+```bash
+# Start the development environment with all services
+cd docker/dev
+docker-compose up -d
+```

From e0a11ebcfd73859bd3236e3db1497e85592cfe33 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 12 Dec 2025 22:32:46 +0000
Subject: [PATCH 03/10] refactor: make example template reference more generic

Co-authored-by: jog1t <39823706+jog1t@users.noreply.github.com>
---
 .github/COPILOT_INSTRUCTIONS.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/COPILOT_INSTRUCTIONS.md b/.github/COPILOT_INSTRUCTIONS.md
index 887d30ef36..c9798bef10 100644
--- a/.github/COPILOT_INSTRUCTIONS.md
+++ b/.github/COPILOT_INSTRUCTIONS.md
@@ -170,7 +170,7 @@ tracing::info!("foo {x}");
 
 ## Examples
 
-All example READMEs in `/examples/` should follow the format defined in `.claude/resources/EXAMPLE_TEMPLATE.md`.
+All example READMEs in `/examples/` should follow a consistent format. Refer to the example template in the repository for the standard structure.
 
 ## Git Workflow
 

From 9cd62fc5cc5ed1c029d66b7a0e6e18930f6b1d69 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 12 Dec 2025 22:35:02 +0000
Subject: [PATCH 04/10] fix: correct directory paths in Copilot instructions

Co-authored-by: jog1t <39823706+jog1t@users.noreply.github.com>
---
 .github/COPILOT_INSTRUCTIONS.md | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/.github/COPILOT_INSTRUCTIONS.md b/.github/COPILOT_INSTRUCTIONS.md
index c9798bef10..7e5569b3c7 100644
--- a/.github/COPILOT_INSTRUCTIONS.md
+++ b/.github/COPILOT_INSTRUCTIONS.md
@@ -8,11 +8,10 @@ Rivet is a Rust workspace-based monorepo for a distributed actor/server orchestr
 
 Key packages and components:
 
-- **Core Engine** (`packages/core/engine/`) - Main orchestration service that coordinates all operations
-- **Workflow Engine** (`packages/common/gasoline/`) - Handles complex multi-step operations with reliability and observability
-- **Pegboard** (`packages/core/pegboard/`) - Actor/server lifecycle management system
-- **Common Packages** (`/packages/common/`) - Foundation utilities, database connections, caching, metrics, logging, health checks, workflow engine core
-- **Core Packages** (`/packages/core/`) - Main engine executable, Pegboard actor orchestration, workflow workers
+- **Core Engine** (`engine/packages/engine/`) - Main orchestration service that coordinates all operations
+- **Workflow Engine** (`engine/packages/gasoline/`) - Handles complex multi-step operations with reliability and observability
+- **Pegboard** (`engine/packages/pegboard/`) - Actor/server lifecycle management system
+- **Common Packages** (`engine/packages/`) - Foundation utilities, database connections, caching, metrics, logging, health checks, workflow engine core
 - **Service Infrastructure** - Distributed services communicate via NATS messaging with service discovery
 
 ## Build Commands
@@ -58,7 +57,7 @@ cargo clippy -- -W warnings
 
 ## Error Handling
 
-Custom error system at `packages/common/error/` using derive macros with struct-based error definitions.
+Custom error system at `engine/packages/error/` using derive macros with struct-based error definitions.
 
 Example usage:
 
@@ -108,7 +107,7 @@ Key error handling principles:
 
 - **UniversalDB** for distributed state storage
 - **ClickHouse** for analytics and time-series data
-- Connection pooling through `packages/common/pools/`
+- Connection pooling through `engine/packages/pools/`
 
 ## Code Style
 
@@ -154,8 +153,8 @@ tracing::info!("foo {x}");
 
 ## Configuration Management
 
-- Do not make changes to `docker/dev*` configs directly
-- Instead, edit the template in `docker/template/` and rerun `(cd docker/template && pnpm start)` to regenerate
+- Do not make changes to `engine/docker/dev*` configs directly
+- Instead, edit the template in `engine/docker/template/` and rerun `(cd engine/docker/template && pnpm start)` to regenerate
 
 ## Optimizations
 
@@ -183,6 +182,6 @@ gt c -m "chore(my-pkg): foo bar"
 
 ```bash
 # Start the development environment with all services
-cd docker/dev
+cd engine/docker/dev
 docker-compose up -d
 ```

From 2dc9cf3121f4264a66fbb4972bc95a203be6b219 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 12 Dec 2025 22:36:22 +0000
Subject: [PATCH 05/10] docs: clarify docker config vs usage sections

Co-authored-by: jog1t <39823706+jog1t@users.noreply.github.com>
---
 .github/COPILOT_INSTRUCTIONS.md | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/.github/COPILOT_INSTRUCTIONS.md b/.github/COPILOT_INSTRUCTIONS.md
index 7e5569b3c7..6183cda56f 100644
--- a/.github/COPILOT_INSTRUCTIONS.md
+++ b/.github/COPILOT_INSTRUCTIONS.md
@@ -153,8 +153,18 @@ tracing::info!("foo {x}");
 
 ## Configuration Management
 
-- Do not make changes to `engine/docker/dev*` configs directly
-- Instead, edit the template in `engine/docker/template/` and rerun `(cd engine/docker/template && pnpm start)` to regenerate
+### Docker Configuration
+- Do not edit `engine/docker/dev*` config files directly
+- Instead, edit the template in `engine/docker/template/` and rerun `(cd engine/docker/template && pnpm start)` to regenerate the configs
+
+## Docker Development Environment
+
+To start the development environment (using the generated configs):
+
+```bash
+cd engine/docker/dev
+docker-compose up -d
+```
 
 ## Optimizations
 
@@ -177,11 +187,3 @@ When committing changes, use Graphite CLI with conventional commits:
 ```bash
 gt c -m "chore(my-pkg): foo bar"
 ```
-
-## Docker Development Environment
-
-```bash
-# Start the development environment with all services
-cd engine/docker/dev
-docker-compose up -d
-```

From b63ed31125bcc1a5ae391cbc51c6fde105ef39dc Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 12 Dec 2025 22:37:21 +0000
Subject: [PATCH 06/10] docs: clarify logging capitalization rules

Co-authored-by: jog1t <39823706+jog1t@users.noreply.github.com>
---
 .github/COPILOT_INSTRUCTIONS.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/COPILOT_INSTRUCTIONS.md b/.github/COPILOT_INSTRUCTIONS.md
index 6183cda56f..55b08440bd 100644
--- a/.github/COPILOT_INSTRUCTIONS.md
+++ b/.github/COPILOT_INSTRUCTIONS.md
@@ -143,8 +143,8 @@ tracing::info!(?x, "foo");
 tracing::info!("foo {x}");
 ```
 
-- Log messages should be lowercase unless mentioning specific code symbols
-- Example: `tracing::info!("inserted UserRow")` instead of `tracing::info!("Inserted UserRow")`
+- Log messages should use lowercase for descriptive text, but keep code symbols (like struct names) capitalized
+- Example: `tracing::info!("inserted UserRow")` (lowercase verb, capitalized struct name) instead of `tracing::info!("Inserted UserRow")` (both capitalized)
 
 ## Testing Guidelines
 

From 6580cb2db22da1f84778ba76a26ec29d996c0304 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 12 Dec 2025 22:38:49 +0000
Subject: [PATCH 07/10] docs: add specific path to example template

Co-authored-by: jog1t <39823706+jog1t@users.noreply.github.com>
---
 .github/COPILOT_INSTRUCTIONS.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/COPILOT_INSTRUCTIONS.md b/.github/COPILOT_INSTRUCTIONS.md
index 55b08440bd..c8eba7663c 100644
--- a/.github/COPILOT_INSTRUCTIONS.md
+++ b/.github/COPILOT_INSTRUCTIONS.md
@@ -179,7 +179,7 @@ docker-compose up -d
 
 ## Examples
 
-All example READMEs in `/examples/` should follow a consistent format. Refer to the example template in the repository for the standard structure.
+All example READMEs in `/examples/` should follow a consistent format. Refer to `.claude/resources/EXAMPLE_TEMPLATE.md` in the repository for the standard structure.
 
 ## Git Workflow
 

From b04ed0c40a8f4a676a35e8d5f7a31fc02643c44f Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 12 Dec 2025 22:46:20 +0000
Subject: [PATCH 08/10] feat: add separate sections for engine, rivetkit,
 frontend, and website

Co-authored-by: jog1t <39823706+jog1t@users.noreply.github.com>
---
 .github/COPILOT_INSTRUCTIONS.md | 203 +++++++++++++++++++++++++++++++-
 1 file changed, 202 insertions(+), 1 deletion(-)

diff --git a/.github/COPILOT_INSTRUCTIONS.md b/.github/COPILOT_INSTRUCTIONS.md
index c8eba7663c..27c23cb966 100644
--- a/.github/COPILOT_INSTRUCTIONS.md
+++ b/.github/COPILOT_INSTRUCTIONS.md
@@ -2,7 +2,17 @@
 
 ## Overview
 
-Rivet is a Rust workspace-based monorepo for a distributed actor/server orchestration system. This guide provides essential context for working with the codebase.
+Rivet is a monorepo containing multiple projects:
+- **Engine** - Rust-based distributed actor/server orchestration system
+- **Rivetkit** - SDK packages for multiple languages (TypeScript, Rust, Python)
+- **Frontend** - React/Vite TypeScript application for the Rivet dashboard
+- **Website** - Next.js documentation and marketing site
+
+This guide provides essential context for working with each part of the codebase.
+
+---
+
+# Rust Engine (`engine/`)
 
 ## Monorepo Structure
 
@@ -187,3 +197,194 @@ When committing changes, use Graphite CLI with conventional commits:
 ```bash
 gt c -m "chore(my-pkg): foo bar"
 ```
+
+---
+
+# Rivetkit SDK Packages
+
+Rivetkit provides SDK packages for multiple languages located in `rivetkit-*` directories:
+- **TypeScript** (`rivetkit-typescript/`) - Client SDK, React hooks, Next.js integration, Cloudflare Workers adapter
+- **Rust** (`rivetkit-rust/`) - Client SDK for Rust applications
+- **Python** (`rivetkit-python/`) - Client SDK for Python applications
+
+## TypeScript Packages
+
+Located in `rivetkit-typescript/packages/`:
+- `rivetkit` - Core TypeScript/JavaScript SDK
+- `react` - React hooks and components
+- `next-js` - Next.js integration
+- `cloudflare-workers` - Cloudflare Workers adapter
+- `db` - Database utilities
+- `framework-base` - Base framework utilities
+
+### Build Commands
+
+```bash
+# From rivetkit-typescript directory
+pnpm build
+
+# Build specific package
+pnpm --filter @rivetkit/react build
+```
+
+### Development
+
+- Follow TypeScript best practices
+- Use pnpm for package management
+- Maintain type safety across all packages
+- Follow existing patterns for API design
+
+## Rust SDK
+
+Located in `rivetkit-rust/packages/client/`:
+- Client SDK for Rust applications
+- Follows Rust best practices and patterns from engine
+
+### Build Commands
+
+```bash
+# From rivetkit-rust directory
+cargo build
+
+# Run tests
+cargo test
+```
+
+---
+
+# Frontend (`frontend/`)
+
+React/Vite TypeScript application for the Rivet dashboard with multiple configurations:
+- **Inspector** - Actor inspection interface
+- **Engine** - Engine management interface
+- **Cloud** - Cloud dashboard interface
+
+## Technology Stack
+
+- **React** - UI framework
+- **Vite** - Build tool and dev server
+- **TypeScript** - Type-safe JavaScript
+- **Tailwind CSS** - Utility-first CSS
+- **Radix UI** - Accessible component primitives
+- **Clerk** - Authentication
+- **CodeMirror** - Code editing components
+
+## Build Commands
+
+```bash
+# Development (runs all three apps)
+pnpm dev
+
+# Development for specific app
+pnpm dev:inspector
+pnpm dev:engine
+pnpm dev:cloud
+
+# Production builds
+pnpm build:inspector
+pnpm build:engine
+pnpm build:cloud
+
+# Type checking
+pnpm ts-check
+```
+
+## Development Guidelines
+
+- Follow React best practices and hooks patterns
+- Maintain type safety with TypeScript
+- Use existing UI components from `@radix-ui` before creating new ones
+- Follow Tailwind CSS utility patterns
+- Keep components modular and reusable
+- Use proper error boundaries
+
+## Code Style
+
+- Use TypeScript for all new files
+- Follow existing component structure patterns
+- Use functional components with hooks
+- Prefer composition over inheritance
+- Keep components focused and single-purpose
+
+---
+
+# Website (`website/`)
+
+Next.js-based documentation and marketing site.
+
+## Technology Stack
+
+- **Next.js** - React framework with SSR/SSG
+- **TypeScript** - Type-safe JavaScript
+- **MDX** - Markdown with JSX for content
+- **Tailwind CSS** - Utility-first CSS
+- **Giscus** - GitHub discussions-based comments
+
+## Build Commands
+
+```bash
+# Development
+pnpm dev
+
+# Production build
+pnpm build
+
+# Linting
+pnpm lint
+
+# Code formatting
+pnpm format
+```
+
+## Content Generation
+
+The website has several content generation scripts:
+
+```bash
+# Generate navigation structure
+pnpm gen:navigation
+
+# Generate examples from repository
+pnpm gen:examples
+
+# Generate markdown and LLM content
+pnpm gen:markdown
+
+# Generate README files
+pnpm gen:readme
+
+# Generate TypeDoc API documentation
+pnpm gen:typedoc
+
+# Run all generators
+pnpm gen
+```
+
+## Development Guidelines
+
+- **Avoid `"use client"`** for components with text content for SEO and performance
+- If client-side functionality is needed:
+  - Add a `useEffect` hook, or
+  - Move client-side code to a separate client-only component
+- Follow Next.js best practices for SSR/SSG
+- Use MDX for documentation content
+- Maintain consistent documentation structure
+- Ensure all links are valid (use `pnpm lint` to check)
+
+## Content Structure
+
+- Documentation lives in `src/app/(docs)/` 
+- Blog posts and articles follow specific formats
+- Use frontmatter for metadata
+- Follow existing patterns for new content pages
+
+---
+
+# General Guidelines
+
+## Git Workflow
+
+When committing changes, use Graphite CLI with conventional commits:
+```bash
+gt c -m "chore(my-pkg): foo bar"
+```

From 8e375a2af8c36b5b813ba8346366e5a6831e1730 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 12 Dec 2025 22:47:21 +0000
Subject: [PATCH 09/10] docs: clarify use client guidelines and fix trailing
 space

Co-authored-by: jog1t <39823706+jog1t@users.noreply.github.com>
---
 .github/COPILOT_INSTRUCTIONS.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/COPILOT_INSTRUCTIONS.md b/.github/COPILOT_INSTRUCTIONS.md
index 27c23cb966..93364d772c 100644
--- a/.github/COPILOT_INSTRUCTIONS.md
+++ b/.github/COPILOT_INSTRUCTIONS.md
@@ -362,10 +362,10 @@ pnpm gen
 
 ## Development Guidelines
 
-- **Avoid `"use client"`** for components with text content for SEO and performance
-- If client-side functionality is needed:
-  - Add a `useEffect` hook, or
-  - Move client-side code to a separate client-only component
+- **Minimize `"use client"`** - Avoid using `"use client"` for components with text content that should be indexed by search engines or primarily contain static content
+- For client-side functionality:
+  - Add a `useEffect` hook for minimal client-side logic, or
+  - Move interactive code to a separate client-only component while keeping static content server-rendered
 - Follow Next.js best practices for SSR/SSG
 - Use MDX for documentation content
 - Maintain consistent documentation structure
@@ -373,7 +373,7 @@ pnpm gen
 
 ## Content Structure
 
-- Documentation lives in `src/app/(docs)/` 
+- Documentation lives in `src/app/(docs)/`
 - Blog posts and articles follow specific formats
 - Use frontmatter for metadata
 - Follow existing patterns for new content pages

From c13cc0c4145fe7e67a1e2fff483210b942e0ebcb Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 12 Dec 2025 22:48:42 +0000
Subject: [PATCH 10/10] docs: add Python SDK section and remove duplicate git
 workflow

Co-authored-by: jog1t <39823706+jog1t@users.noreply.github.com>
---
 .github/COPILOT_INSTRUCTIONS.md | 32 +++++++++++++++++++++++++-------
 1 file changed, 25 insertions(+), 7 deletions(-)

diff --git a/.github/COPILOT_INSTRUCTIONS.md b/.github/COPILOT_INSTRUCTIONS.md
index 93364d772c..65bbb4b1ea 100644
--- a/.github/COPILOT_INSTRUCTIONS.md
+++ b/.github/COPILOT_INSTRUCTIONS.md
@@ -191,13 +191,6 @@ docker-compose up -d
 
 All example READMEs in `/examples/` should follow a consistent format. Refer to `.claude/resources/EXAMPLE_TEMPLATE.md` in the repository for the standard structure.
 
-## Git Workflow
-
-When committing changes, use Graphite CLI with conventional commits:
-```bash
-gt c -m "chore(my-pkg): foo bar"
-```
-
 ---
 
 # Rivetkit SDK Packages
@@ -250,6 +243,31 @@ cargo build
 cargo test
 ```
 
+## Python SDK
+
+Located in `rivetkit-python/`:
+- Client SDK for Python applications
+- Python type hints for type safety
+- Async/await support
+
+### Build Commands
+
+```bash
+# From rivetkit-python directory
+# Install in development mode
+pip install -e .
+
+# Run tests
+pytest
+```
+
+### Development
+
+- Follow Python best practices (PEP 8)
+- Use type hints for all public APIs
+- Maintain compatibility with Python 3.8+
+- Follow existing patterns for API design
+
 ---
 
 # Frontend (`frontend/`)