diff --git a/.claude/memory/MEMORY.md b/.claude/memory/MEMORY.md
new file mode 100644
index 0000000..86911fa
--- /dev/null
+++ b/.claude/memory/MEMORY.md
@@ -0,0 +1,4 @@
+# Memory Index
+
+- [Preserve markdown quotes](feedback_markdown_quotes.md) — Don't edit blockquote content unless explicitly requested or fetching fresh info from source
+- [Project-local memory](feedback_memory_location.md) — Always save memories to `.claude/memory/` in project, not user global location
diff --git a/.claude/memory/feedback_markdown_quotes.md b/.claude/memory/feedback_markdown_quotes.md
new file mode 100644
index 0000000..b9ec026
--- /dev/null
+++ b/.claude/memory/feedback_markdown_quotes.md
@@ -0,0 +1,13 @@
+---
+name: Preserve markdown quotes
+description: Do not edit quoted content in markdown unless explicitly requested
+type: feedback
+---
+
+When editing markdown files, never modify content in blockquotes (lines starting with `>`) unless:
+1. The user explicitly requests changes to that content in the prompt, OR
+2. The content is being updated from a website the user wants crawled for fresh information
+
+**Why:** Quoted content often represents exact citations or official documentation that should remain verbatim.
+
+**How to apply:** When tuning/editing markdown, skip over any blockquote sections and leave them unchanged. Only modify quotes if the user specifically asks or when fetching updated info from a source URL.
diff --git a/.claude/memory/feedback_memory_location.md b/.claude/memory/feedback_memory_location.md
new file mode 100644
index 0000000..56c4ec9
--- /dev/null
+++ b/.claude/memory/feedback_memory_location.md
@@ -0,0 +1,11 @@
+---
+name: Project-local memory
+description: Always save memories inside the project, not user global location
+type: feedback
+---
+
+Always save memory files to the project's `.claude/memory/` directory, not to the user's global memory location (`~/.claude/projects/`).
+
+**Why:** Keeps project-specific knowledge alongside the codebase for portability and version control.
+
+**How to apply:** When creating or updating memories, always write to `.claude/memory/` within the project root.
diff --git a/.claude/settings.json b/.claude/settings.json
new file mode 100644
index 0000000..b3e656c
--- /dev/null
+++ b/.claude/settings.json
@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Write(*.md)"
+    ]
+  }
+}
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..e78032c
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,22 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a curated list of budget-friendly LLM providers. It's a documentation-only project (no code) maintained in README.md.
+
+## Adding New Providers
+
+When adding a new provider to README.md, include:
+- Provider name with link to homepage
+- Pricing/plan details (if applicable)
+- Free tier limits or usage restrictions
+- Source link for verification
+- Footnote with the date information was verified (format: `[^providername]: Check at MMM DD YYYY`)
+
+## Structure
+
+README.md is organized into sections:
+- **Providers support coding plans**: Subscription-based coding plans
+- **Free providers**: Providers with free tiers or trials