diff --git a/README.md b/README.md
index e16f448..711fc6e 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,44 @@
-# root.whispers
+# **root.whispers**
+
+> *Because the command line doesn’t shout… it whispers secrets to those who listen.*
+
+
+A curated collection of commands, one-liners, and operational incantations gathered from the shadowy corners of sysadmin lore.
+Some are lifesavers. Others are career-enders. All of them are here for reference, tinkering, and the occasional “wait… you can do that?” moment.
+
+---
+
+## **What’s Inside**
+
+* 🛠 **System Sorcery** – maintenance, troubleshooting, and bending machines to your will.
+* 🌐 **Network Necromancy** – packet poking, port scrying, and connection conjuring.
+* 📂 **File Incantations** – search, sort, transform, and resurrect forgotten data.
+* 🔐 **Security Shenanigans** – hashing, encryption, and locking things up (or picking the locks).
+* 🎭 **Shell Trickery** – aliases, functions, and scripts that’ll make your prompt smirk.
+
+---
+
+## **How to Use**
+
+* Treat this like a cabinet of loaded weapons:
+
+  * Test in safe environments.
+  * Read the comments.
+  * Don’t paste blindly into prod at 2 AM.
+* Commands are tagged by domain so you can jump to what you need without spelunking the entire repo.
+
+---
+
+## **Disclaimer**
+
+This archive is for practitioners who understand the cost of a single misplaced flag.
+If you brick something, summon unintended chaos, or become a campfire cautionary tale, **that’s on you**.
+
+---
+
+## **Attribution**
+
+Compiled, annotated, and occasionally cursed by **Noir Stack** for the **CodexScrolls** library.
+
+---
 
-Because the command line doesn’t shout… it whispers secrets to those who listen.
\ No newline at end of file