diff --git a/README.md b/README.md
index 3d5872b6..c32f20df 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
Cybersecurity Projects 🐉
-
67 Cybersecurity Projects, Certification Roadmaps & Resources
+
70 Cybersecurity Projects, Certification Roadmaps & Resources
@@ -25,7 +25,7 @@
View Complete Projects:
@@ -36,7 +36,7 @@
## Quick Navigation
### [Projects](#projects)
-67 hands-on cybersecurity projects with full source code, from beginner to advanced level.
+Hands-on cybersecurity projects with full source code, organized in four tiers — **Foundations** (pre-beginner, first-time programmers), **Beginner**, **Intermediate**, and **Advanced**.
### [Certification Roadmaps](./ROADMAPS/README.md)
10 structured career paths with certification guides for SOC Analyst, Pentester, Security Engineer, and more.
@@ -48,6 +48,35 @@ Tools, courses, certifications, communities, and frameworks for cybersecurity pr
# Projects
+
+
+---
+
+## Foundations Projects
+
+> [!NOTE]
+> **Start here if this is your first time coding.** The Foundations tier is *pre-beginner* — built for someone who has never written Python, has barely used a terminal, and is new to cybersecurity. Source files are heavily commented as a teaching aid, and every `learn/` folder explains concepts from zero. Once you're comfortable here, the Beginner projects assume you already know the language and move faster.
+>
+> **What makes Foundations different:**
+> - **Single-file projects** — the entire tool lives in one readable Python file. No file-hopping.
+> - **Heavy teaching comments** — every line that introduces a new concept is annotated inline.
+> - **Numpy-style docstrings on every function** — what it does, why it exists, every parameter.
+> - **Extra-deep `learn/` folders** — Python features and security concepts both explained from zero.
+> - **Senior-level code, beginner-level explanations** — the code itself is still production-quality.
+
+| Project | Info | What You'll Learn |
+|---------|------|-------------------|
+| **[Hash Identifier](./PROJECTS/foundations/hash-identifier)**
Identify hash types by prefix, length, and charset |     | Hash families (MD5, SHA, bcrypt, Argon2) • PHC string format • Pattern matching • Pure-function design
[Source Code](./PROJECTS/foundations/hash-identifier) \| [Docs](./PROJECTS/foundations/hash-identifier/learn) |
+| **[HTTP Headers Scanner](./PROJECTS/foundations/http-headers-scanner)**
Audit a URL's response headers for missing or weak security controls |     | HTTP fundamentals • Security headers (CSP, HSTS, X-Frame-Options) • httpx requests • Scored audits
[Source Code](./PROJECTS/foundations/http-headers-scanner) \| [Docs](./PROJECTS/foundations/http-headers-scanner/learn) |
+| **[Password Manager](./PROJECTS/foundations/password-manager)**
Encrypted local vault with master password unlock |     | Argon2id key derivation • AES-GCM authenticated encryption • Secure on-disk vaults • Master-password workflows
[Source Code](./PROJECTS/foundations/password-manager) \| [Docs](./PROJECTS/foundations/password-manager/learn) |
+
+---
+
## Beginner Projects
| Project | Info | What You'll Learn |
@@ -111,7 +140,7 @@ Tools, courses, certifications, communities, and frameworks for cybersecurity pr
| **[API Rate Limiter](./PROJECTS/advanced/api-rate-limiter)**
Distributed rate limiting middleware |     | Token bucket algorithm • Distributed systems • Redis backend
[Source Code](./PROJECTS/advanced/api-rate-limiter) \| [Docs](./PROJECTS/advanced/api-rate-limiter/learn) |
| **[Encrypted Chat Application](./PROJECTS/advanced/encrypted-p2p-chat)**
Real-time E2EE messaging |      | Signal Protocol • Double Ratchet • WebAuthn • WebSockets
[Source Code](./PROJECTS/advanced/encrypted-p2p-chat) \| [Docs](./PROJECTS/advanced/encrypted-p2p-chat/learn) |
| **[Exploit Development Framework](./SYNOPSES/advanced/Exploit.Development.Framework.md)**
Modular exploitation framework |    | Exploit development • Payload generation • Plugin architecture
[Learn More](./SYNOPSES/advanced/Exploit.Development.Framework.md) |
-| **[AI Threat Detection](./PROJECTS/advanced/ai-threat-detection)**
ML-powered nginx threat detection |      | ML ensemble (AE + RF + IF) • ONNX inference • Real-time detection
[Source Code](./PROJECTS/advanced/ai-threat-detection) \| [Docs](./PROJECTS/advanced/ai-threat-detection/learn) |
+| **[AI Threat Detection](./PROJECTS/advanced/ai-threat-detection)**
ML-powered nginx threat detection |      | ML ensemble (AE + RF + IF) • ONNX inference • Real-time detection
[Source Code](./PROJECTS/advanced/ai-threat-detection) |
| **[Bug Bounty Platform](./PROJECTS/advanced/bug-bounty-platform)**
Full vulnerability disclosure platform |      | Full-stack development • CVSS scoring • Workflow automation
[Source Code](./PROJECTS/advanced/bug-bounty-platform) \| [Docs](./PROJECTS/advanced/bug-bounty-platform/learn) |
| **[Cloud Security Compliance Dashboard](./SYNOPSES/advanced/Cloud.Security.Compliance.Dashboard.md)**
Multi-cloud compliance with CIS, SOC2, HIPAA |      | CIS benchmarks • SOC2/HIPAA compliance • Cost-security optimization • Drift detection
[Learn More](./SYNOPSES/advanced/Cloud.Security.Compliance.Dashboard.md) |
| **[Malware Analysis Platform](./SYNOPSES/advanced/Malware.Analysis.Platform.md)**
Automated sandbox analysis |     | Malware analysis • Sandboxing • YARA rules • IOC extraction
[Learn More](./SYNOPSES/advanced/Malware.Analysis.Platform.md) |