SolidJSSolidStartTypeScriptViteWindsurf

SolidJS × Windsurf Prompt Engineering

Stop fighting Windsurf hallucinations. Generate SolidJS-aware prompts that produce code your team can actually ship.

❌ Generic AI Output

// ❌ Generic Windsurf output for SolidJS
// Missing SolidJS conventions
// No error handling, no types
// Ignores SolidStart best practices
function getData() {
  // hallucinated API that doesn't exist
  return fetch('/api/data').then(r => r.json());
}

✅ Prompt Architect Output

// ✅ AI Prompt Architect output
// Full SolidJS conventions enforced
// Proper error handling & types
// SolidStart best practices included
// Production-ready, zero hallucinations

Real Generated Output

Automated Quality Enforcement

Every prompt includes strict bans and deprecation rules tailored to your SolidJS + SolidStart + TypeScript + Vite + Windsurf stack

strict-bans.md — AI Prompt Architect

# ⛔ STRICT BANS — Enforced Constraints

## Framework Version Enforcement
- **BANNED**: React class components → Use functional components + hooks
- **BANNED**: `componentWillMount`, `componentWillUpdate` → Use `useEffect`
- **BANNED**: `getInitialState` → Use `useState` or `useReducer`
- **BANNED**: `createClass` syntax → Use arrow function components
- **BANNED**: PropTypes runtime validation → Use TypeScript interfaces
- **BANNED**: `defaultProps` static → Use ES6 default parameters

## TypeScript Enforcement
- **BANNED**: `any` type annotations → Use `unknown` + type guards
- **BANNED**: `@ts-ignore` comments → Fix the actual type error
- **BANNED**: Non-null assertions (`!`) → Use optional chaining (?.)
- **BANNED**: `enum` keyword → Use `as const` union types
- **BANNED**: `namespace` declarations → Use ES modules

## Security Constraints
- **BANNED**: `eval()`, `Function()` constructors
- **BANNED**: `innerHTML` assignments → Use `textContent` or sanitise
- **BANNED**: Hardcoded secrets, API keys, or credentials
- **BANNED**: `http://` URLs in production → Enforce `https://`
- **BANNED**: `*` CORS origins in production → Whitelist domains
- **BANNED**: SQL string concatenation → Use parameterised queries
- **BANNED**: `localStorage` for auth tokens → Use httpOnly cookies

## State Management
- **BANNED**: Prop drilling beyond 2 levels → Use Context or Zustand
- **BANNED**: `useEffect` for data fetching → Use React Query / SWR
- **BANNED**: Mutable state mutations → Use immutable update patterns
- **BANNED**: Global mutable variables → Use React state or stores

## API & Data Patterns
- **BANNED**: `fetch` without error handling → Wrap in try/catch
- **BANNED**: Untyped API responses → Define response interfaces
- **BANNED**: `console.log` in production → Use structured logger
- **BANNED**: Synchronous file I/O → Use async/await patterns
- **BANNED**: Unbounded `.find()` / `.filter()` on large arrays → Use Map/Set

## CSS & Styling
- **BANNED**: Inline styles for layout → Use CSS modules or Tailwind
- **BANNED**: `!important` overrides → Fix specificity properly
- **BANNED**: Fixed pixel breakpoints → Use relative units (rem/em)
- **BANNED**: `z-index` values > 100 → Use a z-index scale system

❌ The Problem

AI produces React code for Solid, destructures props (breaking reactivity), and ignores createEffect patterns. Windsurf's Cascade feature can lose context across large codebases.

✅ The Solution

AI Prompt Architect Prompts enforce Solid's fine-grained reactivity — no prop destructuring, createSignal, createMemo, and Show/For components. It structures prompts to maintain context across Windsurf sessions with explicit state tracking.

Frequently Asked Questions

Does it work with Windsurf?

Yes. AI Prompt Architect generates prompts optimised for Windsurf, including context formatting and constraint syntax that Windsurf responds best to.

Can it handle SolidJS projects?

Absolutely. Prompts include SolidJS-specific conventions, API patterns, and best practices to eliminate common hallucinations.

Is there a free tier?

Yes — generate up to 5 prompts per day for free. Pro tier unlocks unlimited generations, team sharing, and advanced templates.

Technical Deep Dive

How does AI Prompt Architect optimise prompts for Windsurf?

It structures prompts to maintain context across Windsurf Cascade sessions with explicit state tracking, file-level annotations, and proper continuation points that prevent context drift in long editing sessions.

How do I set up the initial project architecture with these technologies?

Use AI Prompt Architect to generate a scaffold prompt that includes directory structure, configuration files, environment setup, and dependency installation commands tailored to your exact stack combination. The prompt enforces best-practice file organisation from the start.

See the difference yourself

Stop wasting time fixing AI-generated SolidJS code. Start with the right prompt.

Try SolidJS + Windsurf Prompts Free

Related Architectures

Explore more stack-specific prompt engineering guides

SolidJSSolidStartTypeScript

SolidJS × Windsurf Prompt Engineering

Automated Quality Enforcement

Frequently Asked Questions

Technical Deep Dive

See the difference yourself

Related Architectures

SolidJS × GitHub Copilot Prompt Engineering

SolidJS × Claude Prompt Engineering

SolidJS × Cursor AI Prompt Engineering