The three files that make every Bolt.new prompt smarter

Bolt․new
358 views September 11, 2026

In this Bolt.new tutorial you'll learn how to build context files that live in your project root, so your agent always knows what you're building, which rules it can't break, and how the app should look. We'll create three markdown files inside a docs folder: product.md, rules.md, and design.md. Context files save you from re-explaining your project on every prompt. Clear the context window, start a new feature, and the agent can still read what the product is for, who it serves, which business logic is policy rather than preference, and which colors, spacing, and date formats to reuse. You'll also see how to reference these files in your project knowledge so the agent consults them before it plans or builds anything. The same approach works for a data model, your architecture, or the products you sell. Keep each file tight, read through what the agent writes before you trust it, and only point to a file in your project knowledge when the agent needs it, otherwise you're spending tokens on context that isn't helping. *Timestamps:* 00:00 Introduction 00:45 Product Markdown File 02:44 Rules Markdown File 04:14 Design Markdown File 06:30 Conclusion and Best Practices *About Bolt:* Bolt turns ideas into production software in minutes, entirely in your browser. No setup, no servers. Powered by WebContainers. *Connect with us:* X (Twitter): https://x.com/boltdotnew LinkedIn: https://www.linkedin.com/company/boltdotnew/ Questions? Check out our Support page: https://support.bolt.new #BoltNew #AIDevelopment #Prompting #WebDevelopment #NoCode #BuildWithAI #WebApps #Tutorial #context #markdown #aiagents

Keyboard shortcuts

On. Switch them off if they collide with your assistive tools; ? still opens this sheet.

Go to

Press g then the letter.

  • gh Latest
  • gs Sources
  • gm Media
  • gv Videos
  • gp Podcasts
  • gc Calendar
  • gd Decoder
  • gz Dataviz
  • ga Datasets
  • gb Blog
  • gk Markets
  • gj Careers
  • gn Prompt Notebook

On this page

  • / Focus search, where there is one
  • t Back to top
  • ? This list
  • Esc Close