Update all documentation: README, INDEX files, CHANGELOG, QUICK-START, CONTRIBUTING, CLAUDE.md

Co-authored-by: Rtur2003 <111705644+Rtur2003@users.noreply.github.com>

Author: Copilot

CHANGELOG.md

@@ -7,33 +7,53 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 ## [Unreleased]
 
 ### Added
-- **Accessibility Audit prompt** — ACCESS protocol for WCAG 2.2 compliance testing
-- **Migration & Upgrade prompt** — MIGRATE protocol for framework, database, and dependency migrations
-- **Monitoring & Observability prompt** — OBSERVE protocol for logs, metrics, traces, and alerting
-- **AI & LLM Integration prompt** — AUGMENT protocol for RAG, vector DBs, AI agents, and safety
-- **Game Development prompt** — Unity, Unreal, Godot, ECS, multiplayer patterns
-- **Embedded Systems & IoT prompt** — C, C++, Rust, FreeRTOS, MQTT, TinyML, safety-critical
-- **Full-Stack App example** — Next.js + tRPC + Prisma end-to-end walkthrough
-- **Security Audit example** — Node.js/Express vulnerability assessment walkthrough
-- **Refactoring example** — Legacy code improvement with before/after metrics
-- **Prompt Selector Guide** — Interactive decision tree for choosing the right prompt combination
-- **CLAUDE.md** — AI agent configuration for working on this repository
+- **API Design & GraphQL prompt** — SCHEMA protocol for schema-first design, DataLoader, caching, contract testing
+- **Cloud & Infrastructure prompt** — CLOUD protocol for IaC, multi-region, K8s, cost optimization
+- **Data Engineering prompt** — PIPELINE protocol for dbt, streaming, data quality, Apache Airflow
+- **Compliance & Governance prompt** — GOVERN protocol for GDPR, HIPAA, SOC 2, PCI DSS, STRIDE threat modeling
+- **Debugging & Troubleshooting prompt** — DEBUG protocol for production debugging, profiling, incident response
+- **Blockchain & Web3 project-type prompt** — Solidity, Rust, Foundry, smart contract security, gas optimization
+- **Desktop Application project-type prompt** — Tauri, Electron, Qt, native integration, auto-update
+- **Cloud Infrastructure example** — Terraform + K8s on AWS real-world deployment walkthrough
+- **AI Agent example** — Building an AI-powered code review agent with Claude API
+- **Troubleshooting Guide** — Systematic issue diagnosis decision flowchart with common patterns
+- Accessibility Audit prompt — ACCESS protocol for WCAG 2.2 compliance testing
+- Migration & Upgrade prompt — MIGRATE protocol for framework, database, and dependency migrations
+- Monitoring & Observability prompt — OBSERVE protocol for logs, metrics, traces, and alerting
+- AI & LLM Integration prompt — AUGMENT protocol for RAG, vector DBs, AI agents, and safety
+- Game Development prompt — Unity, Unreal, Godot, ECS, multiplayer patterns
+- Embedded Systems & IoT prompt — C, C++, Rust, FreeRTOS, MQTT, TinyML, safety-critical
+- Full-Stack App example — Next.js + tRPC + Prisma end-to-end walkthrough
+- Security Audit example — Node.js/Express vulnerability assessment walkthrough
+- Refactoring example — Legacy code improvement with before/after metrics
+- Prompt Selector Guide — Interactive decision tree for choosing the right prompt combination
+- CLAUDE.md — AI agent configuration for working on this repository
 - LICENSE file (MIT)
 - CHANGELOG.md for version tracking
-- Improved .gitignore with comprehensive patterns from Git & VCS prompt best practices
+
+### Enhanced
+- **Security Audit prompt** — Added cloud security assessment, supply chain security, zero trust architecture
+- **Architecture Patterns prompt** — Added serverless architecture, event sourcing deep dive, saga pattern, data consistency patterns
+- **Testing Strategies prompt** — Added contract testing (Pact), property-based testing (Hypothesis, fast-check), chaos testing, anti-patterns table
+- **Performance Optimization prompt** — Added GraphQL N+1 prevention, memory profiling (Node.js + Python), CDN/edge optimization, Cloudflare Workers
+- **Full-Stack Development prompt** — Added WebSocket/SSE real-time patterns, Socket.io integration, BullMQ background jobs
+- **API Development prompt** — Added idempotency keys, cursor-based pagination, webhook delivery with retries
+- **Data Science & ML prompt** — Added MLOps section with model monitoring (drift detection), SHAP/LIME explainability, MLflow experiment tracking, model registry
+- **Web Development prompt** — Added SEO/meta tags (Open Graph, JSON-LD), font optimization (preload, swap), image optimization (WebP, lazy loading), accessibility quick wins
 
 ### Changed
-- Updated README.md with 4 new agent prompts, 2 new project types, expanded combinations table
+- Updated README.md with all new prompts, expanded combinations table (36 combinations), updated architecture section
 - Updated QUICK-START.md with all new prompts and resources
 - Updated USAGE.md with new scenarios for all new prompts
 - Updated CONTRIBUTING.md with new file counts and contribution types
-- Updated all INDEX.md files with new prompt entries and feature matrix
-- Made repository fully English-only and global (removed language-specific content)
-- Expanded feature matrix to include Game and IoT columns
-- Agent prompt count: 19 → 23
-- Project type prompt count: 7 → 9
-- Example count: 2 → 5
-- Total prompt files: 26 → 32
+- Updated all INDEX.md files with new prompt entries and expanded feature matrix
+- Made repository fully English-only and global
+- Expanded feature matrix to include Blockchain and Desktop columns
+- Agent prompt count: 23 → 28
+- Project type prompt count: 9 → 11
+- Example count: 5 → 7
+- Workflow guide count: 2 → 3
+- Total prompt files: 32 → 39
 
 ### Removed
 - Turkish translations directory (repository is now English-only for global accessibility)

CLAUDE.md

@@ -20,12 +20,12 @@
 └── prompts/
     └── english/
         ├── INDEX.md           # All prompts organized by category
-        ├── agents/            # Agent-optimized prompts (autonomous AI)
+        ├── agents/            # Agent-optimized prompts (28 files)
         │   └── INDEX.md
         ├── base/              # Foundation prompt (universal best practices)
-        ├── project-types/     # Domain-specific prompts (web, API, ML, mobile, etc.)
-        ├── examples/          # Real-world usage examples
-        └── workflows/         # APEI methodology guide
+        ├── project-types/     # Domain-specific prompts (11 files: web, API, ML, mobile, blockchain, desktop, etc.)
+        ├── examples/          # Real-world usage examples (7 files)
+        └── workflows/         # APEI methodology, prompt selection & troubleshooting guides
 ```
 
 ## File Naming Conventions

CONTRIBUTING.md

@@ -4,8 +4,8 @@
 
 | Type | Description |
 |------|-------------|
-| **New Project Types** | Game dev, blockchain, embedded systems, etc. |
-| **New Agent Types** | Architecture review, accessibility audit, etc. |
+| **New Project Types** | Desktop apps, data engineering, etc. |
+| **New Agent Types** | Specialized agent prompts with protocol acronyms |
 | **New Examples** | Real-world walkthroughs demonstrating APEI cycle |
 | **Improvements** | Better practices, clearer instructions, examples |
 | **Bug Fixes** | Typos, broken links, formatting issues |
@@ -23,11 +23,11 @@ git checkout -b feature/your-feature-name
 ```
 prompts/
 └── english/
-    ├── agents/           # Agent-optimized prompts (23 files)
+    ├── agents/           # Agent-optimized prompts (28 files)
     ├── base/             # Foundation prompts
-    ├── project-types/    # Domain-specific prompts (9 files)
-    ├── examples/         # Usage examples (5 files)
-    └── workflows/        # Process guides (2 files)
+    ├── project-types/    # Domain-specific prompts (11 files)
+    ├── examples/         # Usage examples (7 files)
+    └── workflows/        # Process guides (3 files)
 ```
 
 ## Naming Convention

QUICK-START.md

@@ -20,6 +20,7 @@
 | Accessibility check | Agent System + **Accessibility Audit** | [View](prompts/english/agents/accessibility-audit-prompt.md) |
 | Migration/upgrade | Agent System + **Migration & Upgrade** | [View](prompts/english/agents/migration-upgrade-prompt.md) |
 | Set up monitoring | Agent System + **Monitoring & Observability** | [View](prompts/english/agents/monitoring-observability-prompt.md) |
+| Production debugging | Agent System + **Debugging & Troubleshooting** | [View](prompts/english/agents/debugging-troubleshooting-prompt.md) |
 | Minimal context | **Quick Reference** only | [View](prompts/english/agents/agent-quick-reference.md) |
 
 ### Claude Code-Specific
@@ -39,6 +40,10 @@
 | Modern full-stack app | **Full-Stack Development** | [View](prompts/english/agents/fullstack-development-prompt.md) |
 | Complex multi-step tasks | **Prompt Chaining** | [View](prompts/english/agents/prompt-chaining-prompt.md) |
 | Add AI/LLM features | **AI & LLM Integration** | [View](prompts/english/agents/ai-llm-integration-prompt.md) |
+| API design / GraphQL | **API Design & GraphQL** | [View](prompts/english/agents/api-design-graphql-prompt.md) |
+| Cloud deployment | **Cloud & Infrastructure** | [View](prompts/english/agents/cloud-infrastructure-prompt.md) |
+| Data pipelines | **Data Engineering** | [View](prompts/english/agents/data-engineering-prompt.md) |
+| Compliance audit | **Compliance & Governance** | [View](prompts/english/agents/compliance-governance-prompt.md) |
 
 ### Interactive Sessions
 
@@ -54,6 +59,8 @@
 | General software | Foundation + **General Software** | [View](prompts/english/project-types/general-software-development-prompt.md) |
 | Game development | Foundation + **Game Dev** | [View](prompts/english/project-types/game-development-prompt.md) |
 | Embedded / IoT | Foundation + **Embedded & IoT** | [View](prompts/english/project-types/embedded-iot-prompt.md) |
+| Smart contracts | Foundation + **Blockchain & Web3** | [View](prompts/english/project-types/blockchain-web3-prompt.md) |
+| Desktop app | Foundation + **Desktop Apps** | [View](prompts/english/project-types/desktop-development-prompt.md) |
 | Full-stack app | Foundation + Web + API | — |
 
 ---
@@ -98,3 +105,4 @@ All prompts follow this cycle automatically.
 - [Prompt Index](prompts/english/INDEX.md) — All prompts by category
 - [Prompt Selector](prompts/english/workflows/prompt-selector-guide.md) — Decision tree for choosing prompts
 - [Workflow Guide](prompts/english/workflows/iterative-development-guide.md) — APEI deep-dive
+- [Troubleshooting Guide](prompts/english/workflows/troubleshooting-guide.md) — Issue diagnosis flowchart

README.md

@@ -13,16 +13,17 @@ Production-ready system prompts for Claude AI and coding agents. Built on the **
 | **Project Workflow** | Full lifecycle management | ~2.5K | [View](prompts/english/agents/project-workflow-prompt.md) |
 | **Quick Reference** | Cheat sheet (minimal) | ~0.8K | [View](prompts/english/agents/agent-quick-reference.md) |
 | **Code Review** | Systematic PR review | ~2K | [View](prompts/english/agents/code-review-prompt.md) |
-| **Security Audit** | Vulnerability detection | ~2.5K | [View](prompts/english/agents/security-audit-prompt.md) |
+| **Security Audit** | Vulnerability detection + cloud security | ~3.5K | [View](prompts/english/agents/security-audit-prompt.md) |
 | **Refactoring** | Code improvement | ~2.5K | [View](prompts/english/agents/refactoring-prompt.md) |
-| **Testing** | Test design & TDD | ~3K | [View](prompts/english/agents/testing-strategies-prompt.md) |
+| **Testing** | Test design, TDD, chaos & contract testing | ~4K | [View](prompts/english/agents/testing-strategies-prompt.md) |
 | **Documentation** | Technical writing | ~2.5K | [View](prompts/english/agents/documentation-prompt.md) |
-| **Performance** | Optimization & profiling | ~3K | [View](prompts/english/agents/performance-optimization-prompt.md) |
+| **Performance** | Optimization, profiling, CDN & edge | ~3.5K | [View](prompts/english/agents/performance-optimization-prompt.md) |
 | **Git & VCS** | Branching & commits | ~2.5K | [View](prompts/english/agents/git-version-control-prompt.md) |
 | **Integration Guardian** | System integrity | ~3.5K | [View](prompts/english/agents/integration-guardian-prompt.md) |
 | **Accessibility Audit** | WCAG 2.2 compliance | ~3K | [View](prompts/english/agents/accessibility-audit-prompt.md) |
 | **Migration & Upgrade** | Framework & DB migrations | ~2.5K | [View](prompts/english/agents/migration-upgrade-prompt.md) |
 | **Monitoring & Observability** | Logs, metrics, traces | ~3K | [View](prompts/english/agents/monitoring-observability-prompt.md) |
+| **Debugging & Troubleshooting** | Production debugging & incident response | ~3.5K | [View](prompts/english/agents/debugging-troubleshooting-prompt.md) |
 
 ### 🎯 Claude Code-Specific Prompts
 
@@ -37,25 +38,31 @@ Production-ready system prompts for Claude AI and coding agents. Built on the **
 | Prompt | Purpose | Tokens | File |
 |--------|---------|--------|------|
 | **Technology Stack** ⭐ | Library discovery, modern tools, hidden gems | ~4K | [View](prompts/english/agents/technology-stack-prompt.md) |
-| **Architecture Patterns** | System design, microservices, DDD, CQRS | ~3.5K | [View](prompts/english/agents/architecture-patterns-prompt.md) |
-| **Full-Stack Development** | Next.js/Nuxt/SvelteKit, end-to-end type safety | ~3.5K | [View](prompts/english/agents/fullstack-development-prompt.md) |
+| **Architecture Patterns** | System design, event sourcing, saga, serverless | ~4.5K | [View](prompts/english/agents/architecture-patterns-prompt.md) |
+| **Full-Stack Development** | Next.js/Nuxt/SvelteKit, WebSocket, background jobs | ~4.5K | [View](prompts/english/agents/fullstack-development-prompt.md) |
 | **Prompt Chaining** | Multi-step workflows, context management | ~3K | [View](prompts/english/agents/prompt-chaining-prompt.md) |
 | **AI & LLM Integration** | RAG, vector DBs, AI agents, safety | ~3.5K | [View](prompts/english/agents/ai-llm-integration-prompt.md) |
+| **API Design & GraphQL** | Schema-first, DataLoader, caching, contracts | ~4K | [View](prompts/english/agents/api-design-graphql-prompt.md) |
+| **Cloud & Infrastructure** | IaC, multi-region, K8s, cost optimization | ~4K | [View](prompts/english/agents/cloud-infrastructure-prompt.md) |
+| **Data Engineering** | Pipelines, dbt, streaming, data quality | ~4K | [View](prompts/english/agents/data-engineering-prompt.md) |
+| **Compliance & Governance** | GDPR, HIPAA, SOC 2, threat modeling | ~3.5K | [View](prompts/english/agents/compliance-governance-prompt.md) |
 
 ### 📋 Foundation & Project Prompts (Interactive Sessions)
 
 | Prompt | Purpose | Technologies | File |
 |--------|---------|-------------|------|
 | **Foundation** ⭐ | Universal best practices | Any | [View](prompts/english/base/claude-foundation-prompt.md) |
-| **Web Development** | Frontend apps | React, Vue, Angular, CSS | [View](prompts/english/project-types/web-development-prompt.md) |
-| **API Development** | Backend services | REST, GraphQL, Node, Go | [View](prompts/english/project-types/api-development-prompt.md) |
-| **Data Science & ML** | ML pipelines | Python, pandas, PyTorch | [View](prompts/english/project-types/data-science-ml-prompt.md) |
+| **Web Development** | Frontend apps + SEO + a11y | React, Vue, Angular, CSS | [View](prompts/english/project-types/web-development-prompt.md) |
+| **API Development** | Backend services + idempotency | REST, GraphQL, Node, Go | [View](prompts/english/project-types/api-development-prompt.md) |
+| **Data Science & ML** | ML pipelines + MLOps | Python, pandas, PyTorch | [View](prompts/english/project-types/data-science-ml-prompt.md) |
 | **Mobile** | Mobile apps | iOS, Android, Flutter, RN | [View](prompts/english/project-types/mobile-development-prompt.md) |
 | **DevOps & CI/CD** | Infrastructure | K8s, Docker, Terraform | [View](prompts/english/project-types/devops-cicd-prompt.md) |
 | **Database & SQL** | Data layer | PostgreSQL, MySQL, Redis | [View](prompts/english/project-types/database-sql-prompt.md) |
 | **General Software** | Cross-language | Python, JS, Go, Java, C# | [View](prompts/english/project-types/general-software-development-prompt.md) |
 | **Game Development** | Game engines | Unity, Unreal, Godot | [View](prompts/english/project-types/game-development-prompt.md) |
 | **Embedded & IoT** | Hardware/firmware | C, C++, Rust, FreeRTOS | [View](prompts/english/project-types/embedded-iot-prompt.md) |
+| **Blockchain & Web3** | Smart contracts & dApps | Solidity, Rust, Foundry | [View](prompts/english/project-types/blockchain-web3-prompt.md) |
+| **Desktop Apps** | Cross-platform desktop | Tauri, Electron, Qt | [View](prompts/english/project-types/desktop-development-prompt.md) |
 
 ---
 
@@ -95,21 +102,26 @@ Production-ready system prompts for Claude AI and coding agents. Built on the **
 | Claude Code Setup | Agent System + Workflow & Config |
 | Claude Code Planning | Agent System + Mode Transitions |
 | Token-Efficient Session | Agent System + Token Optimization |
-| Debug / Fix Bugs | Agent System + Error Analysis |
+| Debug / Fix Bugs | Agent System + Debugging & Troubleshooting |
+| Production Incident | Agent System + Debugging + Monitoring |
 | New Project | Agent System + Project Workflow |
 | Choose Best Tools | Agent System + Technology Stack |
 | System Architecture | Agent System + Architecture Patterns |
 | Full-Stack App (modern) | Agent System + Full-Stack Development |
+| API Design (GraphQL) | Agent System + API Design & GraphQL |
 | Complex Multi-Step Task | Agent System + Prompt Chaining |
 | Add AI/LLM Features | Agent System + AI & LLM Integration |
 | Code Review | Agent System + Code Review |
 | Security Check | Agent System + Security Audit |
+| Compliance Audit | Agent System + Compliance & Governance |
 | Accessibility Check | Agent System + Accessibility Audit |
 | Reduce Tech Debt | Agent System + Refactoring |
 | Framework/DB Migration | Agent System + Migration & Upgrade |
 | Write Tests | Agent System + Testing |
 | Write Docs | Agent System + Documentation |
 | Optimize Speed | Agent System + Performance |
+| Cloud Deployment | Agent System + Cloud & Infrastructure |
+| Data Pipelines | Agent System + Data Engineering |
 | Set Up Monitoring | Agent System + Monitoring & Observability |
 | Git Workflow | Agent System + Git & VCS |
 | Cross-Cutting Integrity | Agent System + Integration Guardian |
@@ -122,6 +134,8 @@ Production-ready system prompts for Claude AI and coding agents. Built on the **
 | General Software | Foundation + General Software |
 | Game Development | Foundation + Game Development |
 | Embedded / IoT | Foundation + Embedded & IoT |
+| Smart Contracts | Foundation + Blockchain & Web3 |
+| Desktop App | Foundation + Desktop Apps |
 
 ---
 
@@ -130,11 +144,11 @@ Production-ready system prompts for Claude AI and coding agents. Built on the **
 ```
 prompts/
 └── english/
-    ├── agents/          # Agent-optimized prompts (23 files)
+    ├── agents/          # Agent-optimized prompts (28 files)
     ├── base/            # Foundation prompt
-    ├── project-types/   # Domain-specific prompts (9 files)
-    ├── examples/        # Real-world usage examples (5 files)
-    └── workflows/       # APEI methodology & prompt selection guides
+    ├── project-types/   # Domain-specific prompts (11 files)
+    ├── examples/        # Real-world usage examples (7 files)
+    └── workflows/       # APEI methodology, prompt selection & troubleshooting guides
 ```
 
 ## Resources
@@ -150,6 +164,7 @@ prompts/
 | [Prompt Index](prompts/english/INDEX.md) | All prompts organized by category |
 | [Prompt Selector](prompts/english/workflows/prompt-selector-guide.md) | Decision tree for choosing prompts |
 | [Workflow Guide](prompts/english/workflows/iterative-development-guide.md) | APEI methodology deep-dive |
+| [Troubleshooting Guide](prompts/english/workflows/troubleshooting-guide.md) | Issue diagnosis & resolution flowchart |
 
 ## Customization