🤖 AI Agent & IDE Developer Guide

AI Agent Instruction Specifications

Deterministic asset streaming, dynamic on-the-fly resizing, and semantic graph search designed for Antigravity, Cursor, Windsurf, Claude Code, and Copilot.

⚡ 1. Clean CDN URL Pattern

All icons stream publicly over HTTP/2 and HTTP/3 with 1-year immutable edge caching:

https://assets.grayworth.com/:provider/:style/:size/:name.png

Iconshock

44 styles • 12,225 concepts

/iconshock/flat/32/calculator.png

Lucide Vector

2,066 vector outline icons

/lucide/default/32/search.png

Tabler Icons

5,130+ outline & filled

/tabler/outline/32/home.png

Simple Icons

3,450+ brand & tech logos

/simpleicons/default/32/github.png

Phosphor Icons

1,512 icons in 6 weights

/phosphor/regular/32/airplane.png

Feather Icons

287 precision line icons

/feather/default/32/activity.png

Apple Emoji

Natural Apple Emojipedia set

/emoji/apple/48/rocket.png

Twemoji (Twitter)

Natural Twitter open emoji

/emoji/twitter/48/fire.png

Google Emoji

Google Noto Color Emoji

/emoji/google/48/tada.png

Unicode Fallback

High-DPI symbol glyphs

/unicode/symbols/32/check.png

🔍 2. Discovery via Sub-Millisecond Search API

AI coding agents can query the in-memory semantic graph API directly via cURL before writing components:

# Search for settings or gear
curl -s "https://assets.grayworth.com/api/graph/search?q=settings&style=flat&size=24"

# Search for calculator or math icons
curl -s "https://assets.grayworth.com/api/graph/search?q=calculator&style=flat&size=32"

# Inspect a node's full style variations and semantic neighbors
curl -s "https://assets.grayworth.com/api/graph/node/calculator"

📦 3. Component Code Snippets for AI Agents

Instruct your AI agent to supply explicit width and height to eliminate Cumulative Layout Shift (CLS):

// React / JSX / Tailwind
<img
  src="https://assets.grayworth.com/iconshock/flat/24/settings.png"
  width={24}
  height={24}
  alt="Settings"
  className="inline-block align-middle"
/>

// Lucide Modern Outline Icon
<img
  src="https://assets.grayworth.com/lucide/default/24/search.png"
  width={24}
  height={24}
  alt="Search"
  className="inline-block align-middle"
/>

// Natural Apple Emoji
<img
  src="https://assets.grayworth.com/emoji/apple/32/rocket.png"
  width={32}
  height={32}
  alt="Launch"
  className="inline-block align-middle"
/>

// Unicode Fallback Glyph (when text fonts cannot render)
<img
  src="https://assets.grayworth.com/unicode/symbols/24/check.png"
  width={24}
  height={24}
  alt="Verified"
  className="inline-block align-middle"
/>

📐 4. Recommended Sizing Matrix

The dynamic resizer supports any integer size from 16px to 512px. The standard scale is:

Size	Pixel Dimensions	Primary Application Context
`16`	16 × 16 px	Favicons, compact status badges, table row action triggers, breadcrumbs
`24`	24 × 24 px	Standard UI buttons, sidebar nav links, form field prefix/suffix icons
`32`	32 × 32 px	Productivity ribbons, toolbar actions, card headers, list view items
`48`	48 × 48 px	Modal headers, category tiles, settings row avatars
`64`	64 × 64 px	Empty-state illustrations, dropzones, success dialogs
`128` / `256`	128 × 128 px	Hero cards, feature highlights, onboarding splash steps, cover pages

AI Agent Instruction Specifications

📋 Copy Full Guide for IDE System Prompt

⚡ 1. Clean CDN URL Pattern

🔍 2. Discovery via Sub-Millisecond Search API

📦 3. Component Code Snippets for AI Agents

📐 4. Recommended Sizing Matrix