TurborepoNext.jsTypeScriptpnpmWindsurf

Turborepo + Next.js × Windsurf Prompt Engineering

Stop fighting Windsurf hallucinations. Generate Turborepo + Next.js-aware prompts that produce code your team can actually ship.

❌ Generic AI Output

// ❌ Generic Windsurf output for Turborepo + Next.js
// Missing Turborepo conventions
// No error handling, no types
// Ignores Next.js 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 Turborepo conventions enforced
// Proper error handling & types
// Next.js best practices included
// Production-ready, zero hallucinations

Real Generated Output

Automated Quality Enforcement

Every prompt includes strict bans and deprecation rules tailored to your Turborepo + Next.js + TypeScript + pnpm + 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 ignores monorepo boundaries, produces circular dependencies, and misuses Turborepo pipeline caching. Windsurf's Cascade feature can lose context across large codebases.

✅ The Solution

AI Prompt Architect Prompts enforce proper package boundaries, shared configs, turbo.json pipeline optimization, and workspace dependencies. 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 Turborepo projects?

Absolutely. Prompts include Turborepo-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 it handle the Next.js App Router vs Pages Router distinction?

Prompts detect your router configuration and enforce the correct patterns — layout.tsx/page.tsx for App Router or getServerSideProps/getStaticProps for Pages Router. Mixed configurations are flagged during prompt generation.

Can it generate prompts for Next.js middleware and Edge Functions?

Yes — the constraint engine includes Edge Runtime limitations (no Node.js APIs, limited crypto), proper NextRequest/NextResponse patterns, and correct matcher configurations for middleware chains.

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.

See the difference yourself

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

Try Turborepo + Next.js + Windsurf Prompts Free

Related Architectures

Explore more stack-specific prompt engineering guides

TurborepoNext.jsTypeScript

Turborepo + Next.js × Windsurf Prompt Engineering

Automated Quality Enforcement

Frequently Asked Questions

Technical Deep Dive

See the difference yourself

Related Architectures

Turborepo + Next.js × GitHub Copilot Prompt Engineering

Turborepo + Next.js × Claude Prompt Engineering

Turborepo + Next.js × Cursor AI Prompt Engineering