diff --git a/libary.md b/libary.md
index be723f4..53b244c 100644
--- a/libary.md
+++ b/libary.md
@@ -7,12 +7,12 @@ This file lists every prompt theme, color codes, design intent, and configuratio
 What it is: a compact git status block shown on line 2 when you're inside a git repo.
 It uses `__git_ps1` when available, with a safe fallback to `git rev-parse` for the branch.
 
-States + emojis:
-- Clean repo: ✨
-- Dirty working tree: 🔨
-- Staged changes: 📌
-- Untracked files: 🧷
-- Stashed changes: 📦
+States + emojis (plain language):
+- Clean repo: ✨ no local changes; your files match the last commit
+- Dirty working tree: 🔨 you edited tracked files but haven’t staged them yet
+- Staged changes: 📌 changes are staged and ready to commit
+- Untracked files: 🧷 new files git hasn’t started tracking
+- Stashed changes: 📦 work saved with `git stash` (not in your working tree)
 
 How it works:
 - The capsule only renders when a repo is detected (no extra noise outside git).