diff --git a/backend/expressjs/architecture.md b/backend/expressjs/architecture.md
index e90a7d3..9deff97 100644
--- a/backend/expressjs/architecture.md
+++ b/backend/expressjs/architecture.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for Express.js within the backend domain.
technology: Express.js
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: Express.js Architecture
-vibe_coding_ready: true
version: "4.x / 5.x"
tags: [best-practices, clean-code, expressjs, vibe-coding, cursor-rules, javascript, typescript, software-architecture, system-design, mvc, production-ready, programming-standards, node-js, design-patterns, scalable-code, windsurf-rules, ai-coding, enterprise-patterns, backend]
ai_role: Senior Express.js Architecture Expert
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🏗️ Express.js Architecture Best Practices
diff --git a/backend/expressjs/readme.md b/backend/expressjs/readme.md
index 714765f..a93e5d9 100644
--- a/backend/expressjs/readme.md
+++ b/backend/expressjs/readme.md
@@ -1,5 +1,4 @@
---
-description: Vibe coding guidelines and architectural constraints for Express.js within the backend domain.
technology: Express.js
domain: backend
level: Senior/Architect
@@ -7,10 +6,7 @@ version: "4.x / 5.x"
tags: [best-practices, clean-code, expressjs, vibe-coding, cursor-rules, javascript, typescript, software-architecture, system-design, mvc, production-ready, programming-standards, node-js, design-patterns, scalable-code, windsurf-rules, ai-coding, enterprise-patterns, backend]
ai_role: Senior Express.js Backend Expert
last_updated: 2026-03-23
-topic: Express.js
-complexity: Architect
-last_evolution: 2026-03-29
-vibe_coding_ready: true---
+---
@@ -81,7 +77,7 @@ class UserController {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 2. Async/Await Error Wrapping (Express 4)
### ❌ Bad Practice
```javascript
@@ -97,7 +93,7 @@ router.get('/', asyncHandler(UserController.get));
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 3. Global Error Handler Middleware
### ❌ Bad Practice
```javascript
@@ -115,7 +111,7 @@ app.use((err, req, res, next) => {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 4. Request Payload Validation (Joi / Zod)
### ❌ Bad Practice
```javascript
@@ -135,7 +131,7 @@ router.post('/', validate(userSchema), UserController.create);
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 5. Environment Variables separation
### ❌ Bad Practice
```javascript
@@ -151,7 +147,7 @@ mongoose.connect(process.env.DB_URI);
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 6. HTTP Security Headers (Helmet)
### ❌ Bad Practice
// Приложение светит 'X-Powered-By: Express'
@@ -165,7 +161,7 @@ app.use(helmet());
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 7. Cross-Origin Resource Sharing (CORS)
### ❌ Bad Practice
```javascript
@@ -181,7 +177,7 @@ app.use(cors({ origin: 'https://myapp.com', credentials: true }));
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 8. Rate Limiting (Защита от DDoS)
### ❌ Bad Practice
// API открыт для миллиона запросов в секунду
@@ -195,7 +191,7 @@ app.use('/api/', rateLimit({ windowMs: 15 * 60 * 1000, max: 100 }));
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 9. Body Parsing & Payload Limits
### ❌ Bad Practice
```javascript
@@ -211,7 +207,7 @@ app.use(express.urlencoded({ extended: true, limit: '10kb' }));
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 10. Centralized Logging (Morgan + Winston)
### ❌ Bad Practice
```javascript
@@ -227,7 +223,7 @@ winstonLogger.info('User signed in');
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 11. Database Connection Management
### ❌ Bad Practice
```javascript
@@ -244,7 +240,7 @@ mongoose.connect(process.env.DB_URI).then(() => {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 12. JWT Authentication Middleware
### ❌ Bad Practice
```javascript
@@ -264,7 +260,7 @@ const authGuard = (req, res, next) => {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 13. Role-Based Access Control (RBAC) Middleware
### ❌ Bad Practice
```javascript
@@ -283,7 +279,7 @@ router.delete('/:id', requireRole('admin', 'manager'), Controller.del);
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 14. Standard API Response Wrapper
### ❌ Bad Practice
```javascript
@@ -301,7 +297,7 @@ class ApiResponse {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 15. Pagination details in API
### ❌ Bad Practice
```javascript
@@ -318,7 +314,7 @@ res.json({ data: users, meta: { total, page, limit, pages: Math.ceil(total/limit
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 16. Graceful Shutdown
### ❌ Bad Practice
// При получении SIGTERM сервер моментально обрывает процессы
@@ -335,7 +331,7 @@ process.on('SIGTERM', () => {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 17. 404 Route Handler
### ❌ Bad Practice
// Если роут не найден, возвращается пустая белая страница
@@ -350,7 +346,7 @@ app.use('*', (req, res) => {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 18. Application Structure (Folder organization)
### ❌ Bad Practice
```
@@ -371,7 +367,7 @@ src/
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 19. Health Check Endpoint
### ❌ Bad Practice
// Нет проверки жизнеспособности подов Kubernetes
@@ -386,7 +382,7 @@ app.get('/health', (req, res) => {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 20. Data Sanitization (XSS / NoSQL Injection)
### ❌ Bad Practice
```javascript
@@ -404,7 +400,7 @@ app.use(xss());
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 21. Swagger / OpenAPI documentation
### ❌ Bad Practice
// Документация в стороннем Word-файле
@@ -419,7 +415,7 @@ app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 22. Manual Dependency Injection
### ❌ Bad Practice
```javascript
@@ -437,7 +433,7 @@ const controller = new UserController(new UserService(db));
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 23. File Uploads (Multer)
### ❌ Bad Practice
// Парсинг бинарников руками
@@ -452,7 +448,7 @@ router.post('/avatar', upload.single('file'), Controller.upload);
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 24. Event Emitters (Фоновые задачи)
### ❌ Bad Practice
```javascript
@@ -473,7 +469,7 @@ res.send('Welcome');
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 25. Caching (Redis Middleware)
### ❌ Bad Practice
// БД обрабатывает сложные расчеты на каждый хит
@@ -491,7 +487,7 @@ const cacheMiddleware = (req, res, next) => {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 26. Custom Error Classes
### ❌ Bad Practice
```javascript
@@ -513,7 +509,7 @@ throw new AppError('User not found', 404);
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 27. Proxy Trust in Production
### ❌ Bad Practice
```javascript
@@ -528,7 +524,7 @@ app.set('trust proxy', 1); // Доверяем первому прокси
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 28. Separating Server from App
### ❌ Bad Practice
```javascript
@@ -549,7 +545,7 @@ app.listen(3000);
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 29. UUID Request Correlation
### ❌ Bad Practice
// Ошибки в логах невозможно связать с конкретным пользователем
@@ -567,7 +563,7 @@ app.use((req, res, next) => {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 30. Secure Session Management
### ❌ Bad Practice
// Сессия хранится в памяти (MemoryStore) с открытыми куками
@@ -591,4 +587,4 @@ app.use(session({
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
diff --git a/backend/expressjs/security-best-practices.md b/backend/expressjs/security-best-practices.md
index f9d402e..1167cbf 100644
--- a/backend/expressjs/security-best-practices.md
+++ b/backend/expressjs/security-best-practices.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for Express.js Security within the backend domain.
technology: Express.js
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: Express.js Security
-vibe_coding_ready: true
version: "4.x / 5.x"
tags: [best-practices, clean-code, security-patterns, vibe-coding, cursor-rules, expressjs, software-architecture, system-design, solid-principles, production-ready, programming-standards, node-js, security, scalable-code, windsurf-rules, ai-coding, enterprise-patterns]
ai_role: Senior Express.js Security Expert
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🔒 Express.js Security Best Practices
diff --git a/backend/microservices/api-design.md b/backend/microservices/api-design.md
index 4bbf083..5983bcb 100644
--- a/backend/microservices/api-design.md
+++ b/backend/microservices/api-design.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for Microservices API Design within the backend domain.
technology: Microservices
domain: backend
-level: Architect
-complexity: Architect
-topic: Microservices API Design
-vibe_coding_ready: true
+level: Senior/Architect
version: Agnostic
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, microservices, distributed-systems, system-design, solid-principles, production-ready, scalable-code]
ai_role: Senior Microservices Architect
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🧩 Microservices API Design
diff --git a/backend/microservices/architecture.md b/backend/microservices/architecture.md
index 3836708..ee69fd6 100644
--- a/backend/microservices/architecture.md
+++ b/backend/microservices/architecture.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for Microservices Architecture within the backend domain.
technology: Microservices
domain: backend
-level: Architect
-complexity: Architect
-topic: Microservices Architecture
-vibe_coding_ready: true
+level: Senior/Architect
version: Agnostic
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, microservices, distributed-systems, system-design, solid-principles, production-ready, scalable-code]
ai_role: Senior Microservices Architect
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🧩 Microservices Architecture
diff --git a/backend/microservices/readme.md b/backend/microservices/readme.md
index a3f00bd..ace22b4 100644
--- a/backend/microservices/readme.md
+++ b/backend/microservices/readme.md
@@ -1,16 +1,12 @@
---
-description: Vibe coding guidelines and architectural constraints for Microservices within the backend domain.
technology: Microservices
domain: backend
-level: Architect
-complexity: Architect
-topic: Microservices
-vibe_coding_ready: true
+level: Senior/Architect
version: Agnostic
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, microservices, distributed-systems, system-design, solid-principles, production-ready, scalable-code]
ai_role: Senior Microservices Architect
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
diff --git a/backend/microservices/security-best-practices.md b/backend/microservices/security-best-practices.md
index b79fa3a..b585921 100644
--- a/backend/microservices/security-best-practices.md
+++ b/backend/microservices/security-best-practices.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for Microservices Security within the backend domain.
technology: Microservices
domain: backend
-level: Architect
-complexity: Architect
-topic: Microservices Security
-vibe_coding_ready: true
+level: Senior/Architect
version: Agnostic
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, microservices, distributed-systems, system-design, solid-principles, production-ready, scalable-code]
ai_role: Senior Microservices Architect
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🧩 Microservices Security Best Practices
diff --git a/backend/mongodb/architecture.md b/backend/mongodb/architecture.md
index abc2124..b7f026d 100644
--- a/backend/mongodb/architecture.md
+++ b/backend/mongodb/architecture.md
@@ -1,16 +1,12 @@
---
-description: Vibe coding guidelines and architectural constraints for MongoDB within the backend domain.
technology: MongoDB
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: MongoDB Architecture
-vibe_coding_ready: true
version: "7.0+"
tags: [architecture-patterns, mongodb, nosql, database, system-design, production-ready, scalable-code]
ai_role: Senior MongoDB Database Architect
last_updated: 2026-03-28
-last_evolution: 2026-03-28---
+---
# 🏛️ MongoDB Architecture Constraints
diff --git a/backend/mongodb/database-optimization.md b/backend/mongodb/database-optimization.md
index 5acd6fa..575c9f2 100644
--- a/backend/mongodb/database-optimization.md
+++ b/backend/mongodb/database-optimization.md
@@ -1,16 +1,12 @@
---
-description: Vibe coding guidelines and database optimization constraints for MongoDB within the backend domain.
technology: MongoDB
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: MongoDB Database Optimization
-vibe_coding_ready: true
version: "7.0+"
tags: [database-optimization, mongodb, nosql, indexing, aggregation-pipeline, system-design, production-ready, scalable-code]
ai_role: Senior MongoDB Database Architect
last_updated: 2026-03-28
-last_evolution: 2026-03-28---
+---
# ⚡ MongoDB Database Optimization Best Practices
@@ -47,7 +43,7 @@ db.orders.createIndex({ status: 1, date: 1, amount: 1 })
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
---
## 🏗️ 2. Aggregation Pipeline Optimization
@@ -81,7 +77,7 @@ db.users.aggregate([
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
---
## 📉 3. Covered Queries
@@ -105,7 +101,7 @@ db.orders.find(
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
### ✅ Best Practice
diff --git a/backend/mongodb/readme.md b/backend/mongodb/readme.md
index 2cdc320..257ed72 100644
--- a/backend/mongodb/readme.md
+++ b/backend/mongodb/readme.md
@@ -1,16 +1,12 @@
---
-description: Vibe coding guidelines and architectural constraints for MongoDB within the backend domain.
technology: MongoDB
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: MongoDB
-vibe_coding_ready: true
version: "7.0+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, mongodb, nosql, database, system-design, production-ready, scalable-code, document-database]
ai_role: Senior MongoDB Database Architect
last_updated: 2026-03-28
-last_evolution: 2026-03-28---
+---
@@ -77,7 +73,7 @@ db.createCollection("users", {
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
---
[⬆ Back to Top](#-mongodb-production-ready-best-practices)
diff --git a/backend/mongodb/security-best-practices.md b/backend/mongodb/security-best-practices.md
index 1a9c93e..4e98a5d 100644
--- a/backend/mongodb/security-best-practices.md
+++ b/backend/mongodb/security-best-practices.md
@@ -1,16 +1,12 @@
---
-description: Vibe coding guidelines and security constraints for MongoDB within the backend domain.
technology: MongoDB
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: MongoDB Security Best Practices
-vibe_coding_ready: true
version: "7.0+"
tags: [security-best-practices, mongodb, nosql, database, authentication, authorization, rbac, encryption, injection-prevention, production-ready, scalable-code]
ai_role: Senior MongoDB Database Architect
last_updated: 2026-03-28
-last_evolution: 2026-03-28---
+---
# 🔒 MongoDB Security Best Practices
@@ -54,7 +50,7 @@ db.createUser({
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
---
## 🔐 2. NoSQL Injection Prevention
@@ -95,7 +91,7 @@ const user = await db.collection('users').findOne({
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
---
## 🗄️ 3. Encryption at Rest
@@ -114,7 +110,7 @@ Enable WiredTiger encryption at rest using a robust Key Management Service (KMS)
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
### 🚀 Solution
diff --git a/backend/nestjs/architecture.md b/backend/nestjs/architecture.md
index 17b0cee..5c54178 100644
--- a/backend/nestjs/architecture.md
+++ b/backend/nestjs/architecture.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for NestJS within the backend domain.
technology: NestJS
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: NestJS Architecture
-vibe_coding_ready: true
version: "11+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, cursor-rules, typescript, software-architecture, system-design, solid-principles, production-ready, programming-standards, react-best-practices, node-js, design-patterns, scalable-code, windsurf-rules, ai-coding, fsd, ddd, enterprise-patterns]
ai_role: Senior NestJS Architecture Expert
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🏗️ NestJS 11+ Architecture Best Practices
diff --git a/backend/nestjs/readme.md b/backend/nestjs/readme.md
index c16b589..b4c238b 100644
--- a/backend/nestjs/readme.md
+++ b/backend/nestjs/readme.md
@@ -1,5 +1,4 @@
---
-description: Vibe coding guidelines and architectural constraints for NestJS within the backend domain.
technology: NestJS
domain: backend
level: Senior/Architect
@@ -7,10 +6,7 @@ version: "11+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, cursor-rules, typescript, software-architecture, system-design, solid-principles, production-ready, programming-standards, react-best-practices, node-js, design-patterns, scalable-code, windsurf-rules, ai-coding, fsd, ddd, enterprise-patterns]
ai_role: Senior NestJS Architecture Expert
last_updated: 2026-03-23
-topic: NestJS
-complexity: Architect
-last_evolution: 2026-03-29
-vibe_coding_ready: true---
+---
@@ -498,7 +494,7 @@ app.enableShutdownHooks();
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
---
[⬆️ Back to Top](#)
diff --git a/backend/nestjs/security-best-practices.md b/backend/nestjs/security-best-practices.md
index 07add05..7417209 100644
--- a/backend/nestjs/security-best-practices.md
+++ b/backend/nestjs/security-best-practices.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for NestJS Security within the backend domain.
technology: NestJS
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: NestJS Security
-vibe_coding_ready: true
version: "11+"
tags: [best-practices, clean-code, security-patterns, vibe-coding, cursor-rules, typescript, software-architecture, system-design, solid-principles, production-ready, programming-standards, node-js, security, scalable-code, windsurf-rules, ai-coding, enterprise-patterns]
ai_role: Senior NestJS Security Expert
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🔒 NestJS 11+ Security Best Practices
diff --git a/backend/nodejs/readme.md b/backend/nodejs/readme.md
index ddf2742..0462fdb 100644
--- a/backend/nodejs/readme.md
+++ b/backend/nodejs/readme.md
@@ -1,5 +1,4 @@
---
-description: Vibe coding guidelines and architectural constraints for Node.js within the backend domain.
technology: Node.js
domain: backend
level: Senior/Architect
@@ -7,10 +6,7 @@ version: "24+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, cursor-rules, javascript, typescript, software-architecture, system-design, solid-principles, production-ready, programming-standards, node-js, design-patterns, scalable-code, windsurf-rules, ai-coding, fsd, ddd, enterprise-patterns]
ai_role: Senior Node.js Architecture Expert
last_updated: 2026-03-23
-topic: Node.js
-complexity: Architect
-last_evolution: 2026-03-29
-vibe_coding_ready: true---
+---
@@ -76,7 +72,7 @@ Never use synchronous methods (`*Sync`) on the main thread for crypto, I/O, or h
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 2. 🗂️ Project Structure & Module Separation
### ❌ Bad Practice
```text
@@ -96,7 +92,7 @@ Implement a multi-layered folder architecture. Strictly separate the HTTP transp
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 3. 🛡️ Strict Environment Configuration
### ❌ Bad Practice
```javascript
@@ -118,7 +114,7 @@ Fail fast. Validate all necessary environment variables upon application startup
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 4. 🛑 Error Handling with Custom Classes
### ❌ Bad Practice
```javascript
@@ -140,7 +136,7 @@ Extend the built-in `Error` object to create custom operational errors. This all
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 5. 🎛️ Handling Uncaught Exceptions & Rejections
### ❌ Bad Practice
// Ignoring process-level events, allowing the app to run in an unpredictable state after an error.
@@ -161,7 +157,7 @@ Always capture `uncaughtException` and `unhandledRejection`. Log the fatal error
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 6. 🔒 Hiding Sensitive Headers
### ❌ Bad Practice
// Sending default headers that expose the framework, like `X-Powered-By: Express`.
@@ -176,7 +172,7 @@ Sanitize outgoing HTTP headers to prevent information leakage about the server i
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 7. ⏱️ Implementing Graceful Shutdown
### ❌ Bad Practice
// Application crashes abruptly during deployments, interrupting active user requests and corrupting database transactions.
@@ -198,7 +194,7 @@ Listen for termination signals (`SIGTERM`, `SIGINT`). Finish processing ongoing
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 8. 🔍 Input Validation and Sanitization
### ❌ Bad Practice
```javascript
@@ -219,7 +215,7 @@ Never trust external data. Validate input strictly using schema definitions and
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 9. 🚀 Utilizing Worker Threads for Heavy Tasks
### ❌ Bad Practice
```javascript
@@ -245,7 +241,7 @@ Offload CPU-intensive operations (image processing, video encoding, heavy crypto
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
## 10. 📝 Centralized and Structured Logging
### ❌ Bad Practice
```javascript
@@ -273,4 +269,4 @@ Avoid `console.log`. Use a sophisticated logging library (like Pino or Winston)
### ⚠️ Problem
-[Analysis of the risks]
+Insecure or unoptimized implementation that can cause performance bottlenecks, maintainability issues, or security vulnerabilities. It deviates from modern deterministic standards, making the code harder for AI Agents and Senior Developers to parse and safely extend.
diff --git a/backend/postgresql/architecture.md b/backend/postgresql/architecture.md
index f997010..1124310 100644
--- a/backend/postgresql/architecture.md
+++ b/backend/postgresql/architecture.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for PostgreSQL Architecture within the backend domain.
technology: PostgreSQL
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: PostgreSQL Architecture
-vibe_coding_ready: true
version: "16+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, postgresql, database, sql, rdbms, system-design, production-ready, scalable-code]
ai_role: Senior PostgreSQL Database Architect
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🐘 PostgreSQL Architecture
diff --git a/backend/postgresql/database-optimization.md b/backend/postgresql/database-optimization.md
index 9801005..8a57776 100644
--- a/backend/postgresql/database-optimization.md
+++ b/backend/postgresql/database-optimization.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for PostgreSQL Optimization within the backend domain.
technology: PostgreSQL
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: PostgreSQL Optimization
-vibe_coding_ready: true
version: "16+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, postgresql, database, sql, rdbms, system-design, production-ready, scalable-code]
ai_role: Senior PostgreSQL Database Architect
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🐘 PostgreSQL Database Optimization
diff --git a/backend/postgresql/readme.md b/backend/postgresql/readme.md
index d2b6e49..87937b2 100644
--- a/backend/postgresql/readme.md
+++ b/backend/postgresql/readme.md
@@ -1,16 +1,12 @@
---
-description: Vibe coding guidelines and architectural constraints for PostgreSQL within the backend domain.
technology: PostgreSQL
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: PostgreSQL
-vibe_coding_ready: true
version: "16+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, postgresql, database, sql, rdbms, system-design, production-ready, scalable-code]
ai_role: Senior PostgreSQL Database Architect
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
diff --git a/backend/postgresql/security-best-practices.md b/backend/postgresql/security-best-practices.md
index 70d2800..eee01d0 100644
--- a/backend/postgresql/security-best-practices.md
+++ b/backend/postgresql/security-best-practices.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for PostgreSQL Security within the backend domain.
technology: PostgreSQL
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: PostgreSQL Security
-vibe_coding_ready: true
version: "16+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, postgresql, database, sql, rdbms, system-design, production-ready, scalable-code]
ai_role: Senior PostgreSQL Database Architect
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🐘 PostgreSQL Security Best Practices
diff --git a/backend/readme.md b/backend/readme.md
index 19b2aa7..c2c1ba2 100644
--- a/backend/readme.md
+++ b/backend/readme.md
@@ -1,5 +1,4 @@
---
-description: Vibe coding guidelines and architectural constraints for Backend Architecture within the backend domain.
technology: Backend Architecture
domain: backend
level: Senior/Architect
@@ -7,10 +6,7 @@ version: Agnostic
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, cursor-rules, typescript, software-architecture, system-design, solid-principles, production-ready, programming-standards, react-best-practices, node-js, design-patterns, scalable-code, windsurf-rules, ai-coding, fsd, ddd, enterprise-patterns]
ai_role: Senior Backend Architect
last_updated: 2026-03-22
-topic: TypeScript
-complexity: Architect
-last_evolution: 2026-03-29
-vibe_coding_ready: true---
+---
# Backend Best Practices & Production-Ready Patterns
# Context & Scope
diff --git a/backend/redis/api-design.md b/backend/redis/api-design.md
index 226b538..241604e 100644
--- a/backend/redis/api-design.md
+++ b/backend/redis/api-design.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for Redis API Design within the backend domain.
technology: Redis
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: Redis API Design
-vibe_coding_ready: true
version: "7+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, redis, in-memory, nosql, system-design, production-ready, scalable-code]
ai_role: Senior Redis Architecture Expert
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🟥 Redis API Design
diff --git a/backend/redis/architecture.md b/backend/redis/architecture.md
index be57a04..0f54152 100644
--- a/backend/redis/architecture.md
+++ b/backend/redis/architecture.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for Redis Architecture within the backend domain.
technology: Redis
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: Redis Architecture
-vibe_coding_ready: true
version: "7+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, redis, in-memory, nosql, system-design, production-ready, scalable-code]
ai_role: Senior Redis Architecture Expert
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🟥 Redis Architecture
diff --git a/backend/redis/readme.md b/backend/redis/readme.md
index 8c48902..ba7ba27 100644
--- a/backend/redis/readme.md
+++ b/backend/redis/readme.md
@@ -1,16 +1,12 @@
---
-description: Vibe coding guidelines and architectural constraints for Redis within the backend domain.
technology: Redis
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: Redis
-vibe_coding_ready: true
version: "7+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, redis, in-memory, nosql, system-design, production-ready, scalable-code]
ai_role: Senior Redis Architecture Expert
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
diff --git a/backend/redis/security-best-practices.md b/backend/redis/security-best-practices.md
index 4ee3d86..5798891 100644
--- a/backend/redis/security-best-practices.md
+++ b/backend/redis/security-best-practices.md
@@ -1,15 +1,11 @@
---
-description: Vibe coding guidelines and architectural constraints for Redis Security within the backend domain.
technology: Redis
domain: backend
level: Senior/Architect
-complexity: Advanced
-topic: Redis Security
-vibe_coding_ready: true
version: "7+"
tags: [best-practices, clean-code, architecture-patterns, vibe-coding, redis, in-memory, nosql, system-design, production-ready, scalable-code]
ai_role: Senior Redis Architecture Expert
last_updated: 2026-03-27
-last_evolution: 2026-03-27---
+---
# 🟥 Redis Security Best Practices