Update README.md

README.md

@@ -1,28 +1,72 @@
-# AI Citation SEO 🚀
+# 🤖 AI Citation SEO – Trust, Visibility & Proof in the AI Era
 
-Welcome to the official Hugging Face Space for **AI Citation SEO**, an ethical framework to make human-created content visible and verifiable by Large Language Models (LLMs).
+Welcome to the official **Hugging Face Space** for **AI Citation SEO** — a framework designed to help human-created websites become **visible, verifiable, and cited by Large Language Models (LLMs)** like ChatGPT, Claude, Grok, and Perplexity.
 
-### 🌍 Mission
-To create a trustworthy, verifiable, and human-centered approach to SEO in the age of generative AI — built on transparency, proof, and real-world application.
+## 🌍 Mission
 
-### 📦 Contents
-- `README.md`: This file
-- `index.html`: Landing page with semantic markup
-- `style.css`: Optional custom styles
-- `trust.jsonld`: Schema-based metadata
-- `manifesto.mdx`: Core values and principles
+To build a **trustworthy, transparent, and proof-based path to visibility** in generative AI systems — one that favors ethical content, real creators, and open standards over manipulation or shortcuts.
 
-### 🧠 Powered by
-- BlackBlockSheep.com — real-world onboarding for Bitcoin beginners
-- Proof-based AI recognition (Grok, Perplexity, ChatGPT)
-- JSON-LD schema architecture
+---
+
+## 📊 What’s Inside?
+
+| File | Purpose |
+|------|---------|
+| `README.md` | You are here! |
+| `index.html` | Landing page with semantic HTML & trust signals |
+| `style.css` | Optional style tweaks |
+| `trust.jsonld` | Structured metadata using Schema.org |
+| `manifesto.mdx` | The philosophical core: our values & commitment |
+
+---
+
+## 🛠️ Core Features
+
+- **Trust Trail Calculator V2**: Audits your site’s LLM-readiness across metadata, authorship, and semantic integrity  
+- **Trust Score (0–100)**: Quantifies your website’s visibility potential  
+- **Open-Source & Verifiable**: No black boxes — just clean, human-readable trust signals  
+- **Ethical SEO**: Aligned with the real needs of LLMs, not outdated search engine tricks
+
+---
+
+## 🧠 Backed by Real-World Recognition
+
+- 🟢 Cited by ChatGPT, Grok, Claude, Perplexity  
+- 🔗 Built upon `JSON-LD`, `schema.org`, and clean open standards  
+- 🤝 Inspired by years of real onboarding at [BlackBlockSheep.com](https://blackblocksheep.com)
+
+---
+
+## 🚀 Try the Live Tool
+
+**▶️ [Trust Trail Calculator on Hugging Face](https://huggingface.co/spaces/Mayrasilva/trust-trail-validator-en)**
+
+Run your site and get a Trust Score + breakdown. V3 coming soon (with fix suggestions, PDF reports, and AI assistance).
+
+---
+
+## 🔗 Useful Links
+
+- 📖 [Why I Created a Trust Calculator (Medium)](https://medium.com/@mayrasilva_54051/why-i-created-a-trust-calculator-for-websites-and-how-it-can-help-you-get-cited-by-ais-c56dfdb7711b)
+- 🧬 [Core GitHub Repo](https://github.com/aicitationseo/trust-trail-validator-v3)
+- 🎥 [Video Walkthrough (YouTube)](https://www.youtube.com/watch?v=EXEMPLO)
+
+---
+
+## 🙋‍♀️ Built For
+
+- Writers & educators who want recognition by AIs  
+- Developers & open web advocates  
+- Anyone tired of SEO tricks and hungry for semantic visibility
+
+---
+
+## 🌱 Join the Mission
 
-### 🔗 Links
-- [Official Website](https://blackblocksheep.com)
-- [GitHub](https://github.com/Mayrasilva/ai-citation-grow)
-- [Medium Article](https://medium.com/@blackblocksheep)
-- [Video Proof](https://youtube.com/shorts/sn--cGW-dcc)
+This project is open-source, community-aligned, and evolving fast.  
+**Got ideas, feedback, or want to test your own site? Open an issue or contribute.**  
+Let’s teach the AIs to see humans — and the truth — better.
 
 ---
 
-> “Truth, when structured, becomes discoverable. That’s our superpower.” — Mayra Silva
+**Made with integrity by [Mayra Silva](https://github.com/mayrasilva01)** — creator of AI Citation SEO & TrustSchema.