diff --git a/components/FAQSection.tsx b/components/FAQSection.tsx
index d7a6ab3..68f952f 100644
--- a/components/FAQSection.tsx
+++ b/components/FAQSection.tsx
@@ -16,8 +16,8 @@ export default function FAQ() {
     },
     {
       question: "What if instructions conflict?",
-      answer:
-        "The closest AGENTS.md to the edited file wins; explicit user chat prompts override everything.",
+      answer: 
+        ".agents.md beats conflicting guidance in AGENTS.md. The closest instruction file to the edited file wins; explicit user chat prompts override everything.",
     },
     {
       question: "Will the agent run testing commands found in AGENTS.md automatically?",
diff --git a/components/HowToUseSection.tsx b/components/HowToUseSection.tsx
index b200c55..dbb270f 100644
--- a/components/HowToUseSection.tsx
+++ b/components/HowToUseSection.tsx
@@ -31,6 +31,10 @@ export default function HowToUseSection() {
       title: "Add extra instructions",
       body: "Commit messages or pull request guidelines, security gotchas, large datasets, deployment steps: anything you’d tell a new teammate belongs here too.",
     },
+    {
+      title: "Add local instructions with .agents.md",
+      body: "Keep personal rules in a sibling .agents.md file. Agents read both files, give priority to .agents.md, and apply the same \"closest file wins\" hierarchy.",
+    },
     {
       title: "Large monorepo? Use nested AGENTS.md files for subprojects",
       body: (