# RulesFile

> Pick your stack and get ready-to-commit AGENTS.md, CLAUDE.md, Cursor .mdc rules, Copilot instructions and Windsurf rules. Free, open, runs in your browser.

RulesFile is a free, browser-based generator and reference for AI coding agent rules files. Each stack page offers the same rules as AGENTS.md, CLAUDE.md, Cursor .cursor/rules/*.mdc, legacy .cursorrules, GitHub Copilot instructions, Windsurf rules and GEMINI.md. Raw Markdown versions are available at /stacks/<slug>/AGENTS.md and /stacks/<slug>/CLAUDE.md.

Key facts (reviewed 2026-10-21):
- AGENTS.md is the cross-tool standard, read by Codex, Cursor, GitHub Copilot and 20+ agents.
- Claude Code reads CLAUDE.md; import shared rules with a line containing @AGENTS.md.
- Cursor project rules are .mdc files in .cursor/rules/ with description, globs and alwaysApply frontmatter.
- GitHub Copilot reads .github/copilot-instructions.md plus .github/instructions/*.instructions.md with applyTo globs.
- Gemini CLI reads GEMINI.md, or AGENTS.md via context.fileName in .gemini/settings.json.

## Format guides
- [AGENTS.md: what it is, where it goes, and a generator](https://rulesfile.pages.dev/formats/agents-md/): AGENTS.md is the open standard instructions file for AI coding agents. Learn where to put it, which tools read it, and generate one for your stack.
- [CLAUDE.md template and generator for Claude Code](https://rulesfile.pages.dev/formats/claude-md/): Generate a CLAUDE.md for Claude Code: where it lives, how imports like @AGENTS.md work, and stack-specific templates you can copy.
- [Cursor rules (.cursor/rules/*.mdc): format, examples and generator](https://rulesfile.pages.dev/formats/cursor-rules/): How Cursor project rules work: .mdc files in .cursor/rules with description, globs and alwaysApply. Generate scoped Cursor rules for your stack.
- [.cursorrules file: examples, generator and how to migrate](https://rulesfile.pages.dev/formats/cursorrules/): Generate a .cursorrules file for your stack, and learn why Cursor now recommends .cursor/rules/*.mdc and AGENTS.md instead.
- [GitHub Copilot custom instructions: copilot-instructions.md generator](https://rulesfile.pages.dev/formats/copilot-instructions/): Generate .github/copilot-instructions.md and path-scoped .instructions.md files for GitHub Copilot, with stack-specific rules.
- [Windsurf rules: .windsurf/rules format and generator](https://rulesfile.pages.dev/formats/windsurf-rules/): Generate Windsurf rules with the right trigger (always_on, glob, model_decision, manual) for your stack.
- [GEMINI.md: context files for Gemini CLI](https://rulesfile.pages.dev/formats/gemini-md/): Generate a GEMINI.md for Gemini CLI, or configure Gemini CLI to read AGENTS.md instead.

## Stack templates
- [Next.js (App Router) + Tailwind CSS v4 + shadcn/ui + Supabase + Zod validation](https://rulesfile.pages.dev/stacks/nextjs-supabase-tailwind-shadcn/): The default vibe-coding SaaS stack: Next.js App Router, Supabase for auth and Postgres, Tailwind and shadcn/ui for the interface. Raw: https://rulesfile.pages.dev/stacks/nextjs-supabase-tailwind-shadcn/AGENTS.md
- [Next.js (App Router) + Tailwind CSS v4](https://rulesfile.pages.dev/stacks/nextjs-typescript-tailwind/): A plain Next.js + TypeScript + Tailwind v4 starter, the most common front-end setup in 2026. Raw: https://rulesfile.pages.dev/stacks/nextjs-typescript-tailwind/AGENTS.md
- [Next.js (App Router) + Tailwind CSS v4 + Prisma + Stripe payments + Zod validation](https://rulesfile.pages.dev/stacks/nextjs-prisma-stripe/): A paid SaaS on Next.js with Prisma and Stripe subscriptions. Raw: https://rulesfile.pages.dev/stacks/nextjs-prisma-stripe/AGENTS.md
- [Next.js (App Router) + Tailwind CSS v4 + Drizzle ORM + Clerk auth + Zod validation](https://rulesfile.pages.dev/stacks/nextjs-drizzle-clerk/): Next.js with Clerk for auth and Drizzle ORM on Postgres: fast to build, type-safe end to end. Raw: https://rulesfile.pages.dev/stacks/nextjs-drizzle-clerk/AGENTS.md
- [Next.js (App Router) + Tailwind CSS v4 + shadcn/ui + Vercel AI SDK + Zod validation](https://rulesfile.pages.dev/stacks/nextjs-ai-sdk-chatbot/): Build an AI chat app or agent UI with Next.js and the Vercel AI SDK. Raw: https://rulesfile.pages.dev/stacks/nextjs-ai-sdk-chatbot/AGENTS.md
- [Next.js (App Router) + Tailwind CSS v4 + Supabase + Stripe payments + Zod validation + Vitest](https://rulesfile.pages.dev/stacks/nextjs-supabase-stripe-saas/): The full indie-hacker SaaS kit: auth, database, payments and tests. Raw: https://rulesfile.pages.dev/stacks/nextjs-supabase-stripe-saas/AGENTS.md
- [Next.js (App Router) + Tailwind CSS v4 + Firebase](https://rulesfile.pages.dev/stacks/nextjs-firebase/): Next.js with Firebase Auth and Firestore. Raw: https://rulesfile.pages.dev/stacks/nextjs-firebase/AGENTS.md
- [Next.js (App Router) + Tailwind CSS v4 + Vitest + Playwright E2E](https://rulesfile.pages.dev/stacks/nextjs-testing-vitest-playwright/): A Next.js app with a proper test setup: Vitest for units, Playwright for end-to-end. Raw: https://rulesfile.pages.dev/stacks/nextjs-testing-vitest-playwright/AGENTS.md
- [React + Vite + Tailwind CSS v4 + TanStack Query + Vitest + Zod validation](https://rulesfile.pages.dev/stacks/react-vite-tailwind-tanstack-query/): A classic single-page app: React + Vite with TanStack Query for server data. Raw: https://rulesfile.pages.dev/stacks/react-vite-tailwind-tanstack-query/AGENTS.md
- [React + Vite + Tailwind CSS v4 + Supabase + Zustand](https://rulesfile.pages.dev/stacks/react-vite-supabase/): A client-only React app talking straight to Supabase, popular for quick prototypes and internal tools. Raw: https://rulesfile.pages.dev/stacks/react-vite-supabase/AGENTS.md
- [React + Vite + Tailwind CSS v4 + Firebase + Vitest](https://rulesfile.pages.dev/stacks/react-vite-firebase/): A React SPA on Firebase Auth and Firestore. Raw: https://rulesfile.pages.dev/stacks/react-vite-firebase/AGENTS.md
- [Astro + Tailwind CSS v4](https://rulesfile.pages.dev/stacks/astro-tailwind/): Content sites, blogs and landing pages with Astro and Tailwind. Raw: https://rulesfile.pages.dev/stacks/astro-tailwind/AGENTS.md
- [SvelteKit (Svelte 5) + Tailwind CSS v4 + Supabase + Zod validation](https://rulesfile.pages.dev/stacks/sveltekit-tailwind-supabase/): SvelteKit with Svelte 5 runes, Tailwind and Supabase. Raw: https://rulesfile.pages.dev/stacks/sveltekit-tailwind-supabase/AGENTS.md
- [SvelteKit (Svelte 5) + Tailwind CSS v4 + Drizzle ORM + Vitest](https://rulesfile.pages.dev/stacks/sveltekit-drizzle/): SvelteKit full-stack with Drizzle ORM. Raw: https://rulesfile.pages.dev/stacks/sveltekit-drizzle/AGENTS.md
- [Nuxt (Vue 3) + Tailwind CSS v4 + Zod validation](https://rulesfile.pages.dev/stacks/nuxt-tailwind/): Nuxt and Vue 3 with Tailwind. Raw: https://rulesfile.pages.dev/stacks/nuxt-tailwind/AGENTS.md
- [Nuxt (Vue 3) + Tailwind CSS v4 + Supabase](https://rulesfile.pages.dev/stacks/nuxt-supabase/): Nuxt with Supabase auth and Postgres. Raw: https://rulesfile.pages.dev/stacks/nuxt-supabase/AGENTS.md
- [Expo (React Native) + Supabase + Zod validation + Jest](https://rulesfile.pages.dev/stacks/expo-react-native-supabase/): A mobile app with Expo Router and Supabase. Raw: https://rulesfile.pages.dev/stacks/expo-react-native-supabase/AGENTS.md
- [Expo (React Native) + TanStack Query + Zustand + Jest](https://rulesfile.pages.dev/stacks/expo-react-native-tanstack-zustand/): Expo with TanStack Query for server state and Zustand for UI state. Raw: https://rulesfile.pages.dev/stacks/expo-react-native-tanstack-zustand/AGENTS.md
- [Node.js + Express + Prisma + Zod validation + Vitest + Docker](https://rulesfile.pages.dev/stacks/express-prisma-zod/): A TypeScript REST API with Express 5, Prisma and Zod. Raw: https://rulesfile.pages.dev/stacks/express-prisma-zod/AGENTS.md
- [Node.js + Express + Drizzle ORM + Zod validation + Docker](https://rulesfile.pages.dev/stacks/express-drizzle-docker/): An Express API on Drizzle ORM, packaged with Docker. Raw: https://rulesfile.pages.dev/stacks/express-drizzle-docker/AGENTS.md
- [Python + FastAPI + SQLAlchemy 2 + Alembic + pytest + Docker](https://rulesfile.pages.dev/stacks/fastapi-sqlalchemy-pytest/): A production-style Python API: FastAPI, SQLAlchemy 2 and Alembic, tested with pytest. Raw: https://rulesfile.pages.dev/stacks/fastapi-sqlalchemy-pytest/AGENTS.md
- [Python + FastAPI + LLM / agent SDKs (Python) + pytest](https://rulesfile.pages.dev/stacks/fastapi-ai-agent/): An AI agent backend: FastAPI serving LLM calls and tools. Raw: https://rulesfile.pages.dev/stacks/fastapi-ai-agent/AGENTS.md
- [Python + FastAPI + Supabase + pytest](https://rulesfile.pages.dev/stacks/fastapi-supabase/): A FastAPI service on Supabase Postgres and auth. Raw: https://rulesfile.pages.dev/stacks/fastapi-supabase/AGENTS.md
- [Python (scripts, agents, libraries) + LLM / agent SDKs (Python) + pytest](https://rulesfile.pages.dev/stacks/python-ai-agent/): A Python AI agent or LLM script with uv, ruff and pytest. Raw: https://rulesfile.pages.dev/stacks/python-ai-agent/AGENTS.md
- [Python + Django + pytest + Docker](https://rulesfile.pages.dev/stacks/django-pytest/): A Django app tested with pytest. Raw: https://rulesfile.pages.dev/stacks/django-pytest/AGENTS.md
- [Python + Django + Tailwind CSS v4 + pytest](https://rulesfile.pages.dev/stacks/django-tailwind/): Server-rendered Django with Tailwind styling. Raw: https://rulesfile.pages.dev/stacks/django-tailwind/AGENTS.md
- [Ruby on Rails + Tailwind CSS v4 + Docker](https://rulesfile.pages.dev/stacks/rails-hotwire/): Ruby on Rails 8 with Hotwire and Tailwind. Raw: https://rulesfile.pages.dev/stacks/rails-hotwire/AGENTS.md
- [PHP + Laravel + Tailwind CSS v4 + Stripe payments](https://rulesfile.pages.dev/stacks/laravel-tailwind/): Laravel with Tailwind and Stripe billing. Raw: https://rulesfile.pages.dev/stacks/laravel-tailwind/AGENTS.md
- [Go + Docker](https://rulesfile.pages.dev/stacks/go-api-docker/): A Go HTTP service using the standard library router. Raw: https://rulesfile.pages.dev/stacks/go-api-docker/AGENTS.md
- [Rust + Axum + Docker](https://rulesfile.pages.dev/stacks/rust-axum/): A Rust web service with Axum and Tokio. Raw: https://rulesfile.pages.dev/stacks/rust-axum/AGENTS.md
- [Java + Spring Boot + Docker](https://rulesfile.pages.dev/stacks/spring-boot-docker/): A Java Spring Boot REST service. Raw: https://rulesfile.pages.dev/stacks/spring-boot-docker/AGENTS.md
- [Flutter (Dart) + Firebase](https://rulesfile.pages.dev/stacks/flutter-firebase/): A Flutter app on Firebase. Raw: https://rulesfile.pages.dev/stacks/flutter-firebase/AGENTS.md
- [Flutter (Dart) + Supabase](https://rulesfile.pages.dev/stacks/flutter-supabase/): A Flutter app with Supabase auth and database. Raw: https://rulesfile.pages.dev/stacks/flutter-supabase/AGENTS.md
- [Swift + SwiftUI](https://rulesfile.pages.dev/stacks/swiftui-ios/): A native iOS app with SwiftUI and Swift concurrency. Raw: https://rulesfile.pages.dev/stacks/swiftui-ios/AGENTS.md
- [Unity (C#)](https://rulesfile.pages.dev/stacks/unity-csharp-game/): A Unity game scripted in C#. Built for gamedev vibe coders. Raw: https://rulesfile.pages.dev/stacks/unity-csharp-game/AGENTS.md
- [Godot 4 (GDScript)](https://rulesfile.pages.dev/stacks/godot-gdscript-game/): A Godot 4 game in statically typed GDScript. Raw: https://rulesfile.pages.dev/stacks/godot-gdscript-game/AGENTS.md
- [Phaser (TypeScript web games) + Vitest](https://rulesfile.pages.dev/stacks/phaser-typescript-game/): A 2D browser game with Phaser, TypeScript and Vite. Raw: https://rulesfile.pages.dev/stacks/phaser-typescript-game/AGENTS.md
- [Chrome Extension (MV3) + Tailwind CSS v4 + Zustand + Vitest](https://rulesfile.pages.dev/stacks/chrome-extension-react/): A Manifest V3 Chrome extension with a React popup. Raw: https://rulesfile.pages.dev/stacks/chrome-extension-react/AGENTS.md

## Optional
- [Full content for LLMs](https://rulesfile.pages.dev/llms-full.txt)
- [Generator](https://rulesfile.pages.dev/#generator)
- [About](https://rulesfile.pages.dev/about/)