docs: generate architectural READMEs across repository

.agent/README.md

@@ -1,28 +1,30 @@
-# 📁 .agent
+# 📁 Mavluda Beauty .agent
 
-[Root](/.) > [.agent](/.agent)
+[.agent](/.agent)
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **.agent** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 .agent"]
-  Root --> rules["📁 rules"]
-  Root --> workflows["📁 workflows"]
+  _agent["📁 .agent"]
+  _agent --> rules["📁 rules"]
+  _agent --> workflows["📁 workflows"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| _No matching files_ | - | - | - |
+| *No files in this directory* | - | - | - |
 
 
 ## 🔗 Dependencies
-- _No external or internal dependencies detected._
+No external or alias dependencies detected.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or configuration hub.
+```typescript
+// Example integration for .agent
+// Import capabilities from this directory to enrich your modules.
 ```
+> This directory provides specialized logic tailored to the Mavluda Beauty standard.

.agent/rules/README.md

@@ -1,27 +1,39 @@
-# 📁 rules
+# 📁 Mavluda Beauty rules
 
-[Root](/.) > [.agent](/.agent) > [rules](/.agent/rules)
+[.agent](/.agent) / [rules](/.agent/rules)
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **rules** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 rules"]
-  Root --> Empty["(Empty / No recognized files)"]
+  rules["📁 rules"]
+  rules --> agents_md["📄 agents.md"]
+  rules --> angular_signals_md["📄 angular-signals.md"]
+  rules --> angular_md["📄 angular.md"]
+  rules --> backend_architecture_md["📄 backend-architecture.md"]
+  rules --> frontend_md["📄 frontend.md"]
+  rules --> nestjs_md["📄 nestjs.md"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| _No matching files_ | - | - | - |
+| `agents.md` | File | Core logic and utilities for this domain. | N/A |
+| `angular-signals.md` | File | Core logic and utilities for this domain. | N/A |
+| `angular.md` | File | Core logic and utilities for this domain. | N/A |
+| `backend-architecture.md` | File | Core logic and utilities for this domain. | N/A |
+| `frontend.md` | File | Core logic and utilities for this domain. | N/A |
+| `nestjs.md` | File | Core logic and utilities for this domain. | N/A |
 
 
 ## 🔗 Dependencies
-- _No external or internal dependencies detected._
+No external or alias dependencies detected.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or configuration hub.
+```typescript
+// Example integration for rules
+// Import capabilities from this directory to enrich your modules.
 ```
+> This directory provides specialized logic tailored to the Mavluda Beauty standard.

.agent/workflows/README.md

@@ -1,27 +1,29 @@
-# 📁 workflows
+# 📁 Mavluda Beauty workflows
 
-[Root](/.) > [.agent](/.agent) > [workflows](/.agent/workflows)
+[.agent](/.agent) / [workflows](/.agent/workflows)
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **workflows** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 workflows"]
-  Root --> Empty["(Empty / No recognized files)"]
+  workflows["📁 workflows"]
+  workflows --> aaa_architecture_md["📄 aaa-architecture.md"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| _No matching files_ | - | - | - |
+| `aaa-architecture.md` | File | Core logic and utilities for this domain. | N/A |
 
 
 ## 🔗 Dependencies
-- _No external or internal dependencies detected._
+No external or alias dependencies detected.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or configuration hub.
+```typescript
+// Example integration for workflows
+// Import capabilities from this directory to enrich your modules.
 ```
+> This directory provides specialized logic tailored to the Mavluda Beauty standard.

.gemini/README.md

@@ -1,27 +1,30 @@
-# 📁 .gemini
+# 📁 Mavluda Beauty .gemini
 
-[Root](/.) > [.gemini](/.gemini)
+[.gemini](/.gemini)
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **.gemini** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 .gemini"]
-  Root --> commands["📁 commands"]
+  _gemini["📁 .gemini"]
+  _gemini --> commands["📁 commands"]
+  _gemini --> gemini_md["📄 gemini.md"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| _No matching files_ | - | - | - |
+| `gemini.md` | File | Core logic and utilities for this domain. | N/A |
 
 
 ## 🔗 Dependencies
-- _No external or internal dependencies detected._
+No external or alias dependencies detected.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or configuration hub.
+```typescript
+// Example integration for .gemini
+// Import capabilities from this directory to enrich your modules.
 ```
+> This directory provides specialized logic tailored to the Mavluda Beauty standard.

.gemini/commands/README.md

@@ -1,27 +1,29 @@
-# 📁 commands
+# 📁 Mavluda Beauty commands
 
-[Root](/.) > [.gemini](/.gemini) > [commands](/.gemini/commands)
+[.gemini](/.gemini) / [commands](/.gemini/commands)
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **commands** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 commands"]
-  Root --> test["📁 test"]
+  commands["📁 commands"]
+  commands --> test["📁 test"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| _No matching files_ | - | - | - |
+| *No files in this directory* | - | - | - |
 
 
 ## 🔗 Dependencies
-- _No external or internal dependencies detected._
+No external or alias dependencies detected.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or configuration hub.
+```typescript
+// Example integration for commands
+// Import capabilities from this directory to enrich your modules.
 ```
+> This directory provides specialized logic tailored to the Mavluda Beauty standard.

.gemini/commands/test/README.md

@@ -1,27 +1,29 @@
-# 🧪 test
+# 📁 Mavluda Beauty test
 
-[Root](/.) > [.gemini](/.gemini) > [commands](/.gemini/commands) > [test](/.gemini/commands/test)
+[.gemini](/.gemini) / [commands](/.gemini/commands) / [test](/.gemini/commands/test)
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **test** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["🧪 test"]
-  Root --> Empty["(Empty / No recognized files)"]
+  test["📁 test"]
+  test --> gen_toml["📄 gen.toml"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| _No matching files_ | - | - | - |
+| `gen.toml` | File | Core logic and utilities for this domain. | N/A |
 
 
 ## 🔗 Dependencies
-- _No external or internal dependencies detected._
+No external or alias dependencies detected.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or configuration hub.
+```typescript
+// Example integration for test
+// Import capabilities from this directory to enrich your modules.
 ```
+> This directory provides specialized logic tailored to the Mavluda Beauty standard.

.github/README.md

@@ -1,29 +1,31 @@
-# 📁 .github
+# 📁 Mavluda Beauty .github
 
-[Root](/.) > [.github](/.github)
+[.github](/.github)
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **.github** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 .github"]
-  Root --> instructions["📁 instructions"]
-  Root --> prompts["📁 prompts"]
-  Root --> workflows["📁 workflows"]
+  _github["📁 .github"]
+  _github --> instructions["📁 instructions"]
+  _github --> prompts["📁 prompts"]
+  _github --> workflows["📁 workflows"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| _No matching files_ | - | - | - |
+| *No files in this directory* | - | - | - |
 
 
 ## 🔗 Dependencies
-- _No external or internal dependencies detected._
+No external or alias dependencies detected.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or configuration hub.
+```typescript
+// Example integration for .github
+// Import capabilities from this directory to enrich your modules.
 ```
+> This directory provides specialized logic tailored to the Mavluda Beauty standard.

.github/instructions/README.md

@@ -1,27 +1,37 @@
-# 📁 instructions
+# 📁 Mavluda Beauty instructions
 
-[Root](/.) > [.github](/.github) > [instructions](/.github/instructions)
+[.github](/.github) / [instructions](/.github/instructions)
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **instructions** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 instructions"]
-  Root --> Empty["(Empty / No recognized files)"]
+  instructions["📁 instructions"]
+  instructions --> agents_md["📄 agents.md"]
+  instructions --> angular_signals_md["📄 angular-signals.md"]
+  instructions --> backend_architecture_md["📄 backend-architecture.md"]
+  instructions --> frontend_md["📄 frontend.md"]
+  instructions --> typescript_md["📄 typescript.md"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| _No matching files_ | - | - | - |
+| `agents.md` | File | Core logic and utilities for this domain. | N/A |
+| `angular-signals.md` | File | Core logic and utilities for this domain. | N/A |
+| `backend-architecture.md` | File | Core logic and utilities for this domain. | N/A |
+| `frontend.md` | File | Core logic and utilities for this domain. | N/A |
+| `typescript.md` | File | Core logic and utilities for this domain. | N/A |
 
 
 ## 🔗 Dependencies
-- _No external or internal dependencies detected._
+No external or alias dependencies detected.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or configuration hub.
+```typescript
+// Example integration for instructions
+// Import capabilities from this directory to enrich your modules.
 ```
+> This directory provides specialized logic tailored to the Mavluda Beauty standard.

.github/prompts/README.md

@@ -1,27 +1,29 @@
-# 📁 prompts
+# 📁 Mavluda Beauty prompts
 
-[Root](/.) > [.github](/.github) > [prompts](/.github/prompts)
+[.github](/.github) / [prompts](/.github/prompts)
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **prompts** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 prompts"]
-  Root --> Empty["(Empty / No recognized files)"]
+  prompts["📁 prompts"]
+  prompts --> mavluda_beauty_md["📄 mavluda-beauty.md"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| _No matching files_ | - | - | - |
+| `mavluda-beauty.md` | File | Core logic and utilities for this domain. | N/A |
 
 
 ## 🔗 Dependencies
-- _No external or internal dependencies detected._
+No external or alias dependencies detected.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or configuration hub.
+```typescript
+// Example integration for prompts
+// Import capabilities from this directory to enrich your modules.
 ```
+> This directory provides specialized logic tailored to the Mavluda Beauty standard.