diff --git a/README.md b/README.md
index daba65b..bccec7f 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,25 @@
-# raphael-ai-notes
+# Placeholder art for web prototypes
 
-Prompt notes for Raphael AI, a free AI image generator - https://raphael.app
\ No newline at end of file
+Notes kept on git.kristacomputers.com about using [Raphael AI](https://raphael.app), a free AI image generator that runs in the browser.
+
+Lorem-ipsum images make prototypes feel fake. I generate context-appropriate placeholders with Raphael AI:
+
+## Tips
+
+1. Mark placeholders clearly in the design file so they are replaced before launch.
+2. Keep a small library for future prototypes.
+3. Match the placeholder to the real content type (food app, travel app, SaaS dashboard).
+4. Generate at the exact aspect ratio of each component.
+5. Name files by component (`hero-1.webp`, `card-3.webp`) to swap later.
+
+## Why Raphael AI
+
+- Free to use, with no install: open https://raphael.app and type a prompt.
+- Fast iterations make it practical to try several compositions.
+- Works for drafts, mock-ups and reference images; finish important assets with human review.
+
+## Responsible use
+
+Check generated images for errors before publishing, do not imitate real people without consent, and label AI-generated images where your audience expects it.
+
+Website: https://raphael.app