How to Create Cursor Project Rules with .mdc Files

吴冲 — Thu, 25 Jun 2026 13:30:45 +0000

Cursor project rules work best when they are small, scoped and easy to maintain. Instead of keeping every instruction in one large file, split your rules into focused .mdc files.

Suggested structure

project/
  .cursor/
    rules/
      project-overview.mdc
      code-style.mdc
      framework-rules.mdc
      testing.mdc

Example `.mdc` rule

---
description: "React component conventions"
globs: "**/*.tsx"
alwaysApply: false
---

- Use functional components.
- Define explicit TypeScript props.
- Keep components focused and testable.
- Prefer accessible HTML before custom abstractions.

When to use globs

Use globs when a rule only applies to a subset of the project:

globs: "**/*.tsx"

globs: "src/**/*.{ts,tsx}"

globs: "app/**"

When to use AGENTS.md

Use AGENTS.md when you want a simpler markdown instruction file that can be read by coding agents and does not need MDC frontmatter.

Free generator

I made a free generator that creates .cursor/rules/*.mdc, AGENTS.md and legacy .cursorrules output:

https://www.cursorgenerator.dev/

How to Check If a Page Is Ready for AI Search Visibility

吴冲 — Wed, 24 Jun 2026 13:17:39 +0000

AI search is changing how people discover content. A page can rank in traditional search and still be hard for AI answer engines to extract, summarize or cite.

Here is the practical checklist I use before calling a page AI-search friendly.

1. Start with a direct answer

The page should answer the main question in the first few paragraphs. A good answer block is clear, factual and easy to quote.

2. Use a clean heading structure

Use one H1, then organize the page with descriptive H2 and H3 sections. Avoid vague headings like "Introduction" or "More details" when a specific question would be clearer.

3. Add visible Q&A content

FAQ content can help when it matches real user questions. The important part is that the questions and answers must be visible on the page, not only hidden in JSON-LD.

4. Use schema that matches the content

Useful schema types include FAQPage, Article, Product, LocalBusiness and BreadcrumbList. The markup should reflect what users can actually see on the page.

5. Show trust and freshness signals

Add author, publisher, published date and updated date where appropriate. This is especially important for guides, comparisons and advice content.

6. Keep the content crawlable

If important text only appears after client-side rendering or user interaction, search engines and AI answer systems may miss it.

Free checklist tool

I made a free AEO Checker that scans a URL for these issues and returns a score with fix suggestions:

https://www.aeotools.dev/aeo-checker

There is also a JSON-LD generator for FAQPage, Article, Product, LocalBusiness and BreadcrumbList:

https://www.aeotools.dev/schema-generator

DEV Community: 吴冲