From 3964d267032412f9709dbcad55ec6dea42fa07f9 Mon Sep 17 00:00:00 2001
From: Luong NGUYEN <luongnv89@gmail.com>
Date: Fri, 9 Jan 2026 01:18:58 +0100
Subject: [PATCH] docs: Add tagline and "Why This Guide?" section to README

Highlight differences from official Anthropic docs:
- Visual tutorials with diagrams vs reference docs
- Production-ready templates vs basic snippets
- Progressive learning path vs feature-organized
- Guided roadmap with time estimates
---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index 1b82a68..16c0540 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,29 @@
 
 # Claude How To
 
+> A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
+
+## Why This Guide?
+
+This project complements [Anthropic's official documentation](https://docs.anthropic.com/en/docs/claude-code) with a different approach:
+
+| | Official Docs | This Guide |
+|--|---------------|------------|
+| **Format** | Reference documentation | Visual tutorials with diagrams |
+| **Depth** | Feature descriptions | How it works under the hood |
+| **Examples** | Basic snippets | Production-ready templates you can use immediately |
+| **Structure** | Feature-organized | Progressive learning path (beginner → advanced) |
+| **Onboarding** | Self-directed | Guided roadmap with time estimates |
+
+**What you'll find here:**
+- Mermaid diagrams explaining how each feature works
+- Ready-to-use configurations you can copy into your project
+- Real-world examples with context and best practices
+- Clear progression from `/help` to building custom agents
+- Troubleshooting guides based on common issues
+
+---
+
 ## Contributors
 
 Thanks to everyone who has contributed to this project!