# Technical Documentation: mehdihadeli/awesome-software-architecture > ℹ️ **Provenance:** Hybrid Fusion: `mehdihadeli/awesome-software-architecture` (README + 3 In-Tree Chapters) · [CodeWiki Reference](https://codewiki.google/github.com/mehdihadeli/awesome-software-architecture) · Recency: Active (< 180 days) ## 1. Project Overview & Quickstart (mehdihadeli/awesome-software-architecture) ## Explore Awesome Architecture The repository is the source catalog. The web app turns it into a reader-friendly experience with searchable collections, clickable subcollections, topic pages, resource-type filters, and direct links to every reference. Use the [Awesome Architecture web app](https://awesome-architecture.com/) for fast browsing. Use the table below for a lightweight map of the catalog. ## Catalog Tree The web app uses the same hierarchy shown below: **collection → subcollection → topic area**. Each link opens the matching Markdown folder or topic. | Collection | Subcollections | Topics | | --- | --- | --- | | **[AI](docs/ai/)** | - | [A2A](docs/ai/a2a.md) · [ACP](docs/ai/acp.md) · [Agent](docs/ai/agent.md) · [Agents Coding](docs/ai/agents-coding.md) · [AI Design](docs/ai/ai-design.md) · [AI Gateway](docs/ai/ai-gateway.md) · [AI Infrastructure](docs/ai/ai-infrastructure.md) · [AI Security](docs/ai/ai-security.md) · [AI Tools](docs/ai/ai-tools.md) · [AI](docs/ai/ai.md) · [Context](docs/ai/context.md) · [.NET AI Tools](docs/ai/dotnet-ai-tools.md) · [Embedding Vector](docs/ai/embedding-vector.md) · [Evaluation Test](docs/ai/evaluation-test.md) · [Graph Database](docs/ai/graph-database.md) · [Harness Engineering](docs/ai/harness-engineering.md) · [Lamma.cpp](docs/ai/lamma.cpp.md) · [Langchain](docs/ai/langchain.md) · [Loop Engineering](docs/ai/loop-engineering.md) · [MCP](docs/ai/mcp.md) · [MEAI](docs/ai/meai.md) · [Memory](docs/ai/memory.md) · [Microsoft Agent Framework](docs/ai/microsoft-agent-framework.md) · [ML.NET](docs/ai/ml.net.md) · [Models](docs/ai/models.md) · [Ollama](docs/ai/ollama.md) · [Prompt Engineering](docs/ai/prompt-engineering.md) · [Python AI Tools](docs/ai/python-ai-tools.md) · [RAG](docs/ai/rag.md) · [Semantic Kernel](docs/ai/semantic-kernel.md) · [Skills Subagents Plugins](docs/ai/skills-subagents-plugins.md) · [vLLM](docs/ai/vllm.md) | | **[Cloud Platforms](docs/cloud-platforms/)** | [Azure](docs/cloud-platforms/azure/) · [Cloud Patterns](docs/cloud-platforms/cloud-patterns/) · [IaaS](docs/cloud-platforms/iaas/) · [Networking](docs/cloud-platforms/networking/) · [PaaS](docs/cloud-platforms/paas/) | [AKS](docs/cloud-platforms/azure/aks.md) · [API Management](docs/cloud-platforms/azure/azure-api-management.md) · [App Service Plan](docs/cloud-platforms/azure/azure-app-service-plan.md) · [App Service](docs/cloud-platforms/azure/azure-app-service.md) · [Arc](docs/cloud-platforms/azure/azure-arc.md) · [Cloud](docs/cloud-platforms/azure/azure-cloud.md) · [Configuration](docs/cloud-platforms/azure/azure-configuration.md) · [Functions](docs/cloud-platforms/azure/azure-functions.md) · [Load Balancing](docs/cloud-platforms/azure/azure-load-balancing.md) · [Logic App](docs/cloud-platforms/azure/azure-logic-app.md) · [Resource Manager](docs/cloud-platforms/azure/azure-resource-manager.md) · [Resource](docs/cloud-platforms/azure/azure-resource.md) · [Active Directory](docs/cloud-platforms/azure/azure-security/azure-active-directory.md) · [Key Vault](docs/cloud-platforms/azure/azure-security/azure-key-vault.md) · [SQL](docs/cloud-platforms/azure/azure-sql.md) · [Event Grid](docs/cloud-platforms/azure/messaging/azure-event-grid.md) · [Event Hub](docs/cloud-platforms/azure/messaging/azure-event-hub.md) · [Queue](docs/cloud-platforms/azure/messaging/azure-queue.md) · [Service Bus](docs/cloud-platforms/azure/messaging/azure-service-bus.md) · [Web Pub Sub](docs/cloud-platforms/azure/messaging/azure-web-pub-sub.md) · [Messaging](docs/cloud-platforms/azure/messaging/messaging.md) · [NoSQL](docs/cloud-platforms/azure/nosql/azure-nosql.md) · [Cosmos DB](docs/cloud-platforms/azure/nosql/cosmosdb.md) · [Service Fabric](docs/cloud-platforms/azure/service-fabric.md) · [Blob](docs/cloud-platforms/azure/storage/blob.md) · [File](docs/cloud-platforms/azure/storage/file.md) · [Queue](docs/cloud-platforms/azure/storage/queue.md) · [Storage](docs/cloud-platforms/azure/storage/storage.md) · [Table](docs/cloud-platforms/azure/storage/table.md) · [Cloud Best Practices](docs/cloud-platforms/cloud-best-practices.md) · [Cloud Native](docs/cloud-platforms/cloud-native.md) · [Ambassador Pattern](docs/cloud-platforms/cloud-patterns/ambassador-pattern.md) · [Anti Corruption Layer Pattern](docs/cloud-platforms/cloud-patterns/anti-corruption-layer-pattern.md) · [BFF](docs/cloud-platforms/cloud-patterns/bff.md) · [Bulkhead Pattern](docs/cloud-platforms/cloud-patterns/bulkhead-pattern.md) · [Circuit Breaker](docs/cloud-platforms/cloud-patterns/circuit-breaker.md) · [Cloud Design Patterns](docs/cloud-platforms/cloud-patterns/cloud-design-patterns.md) · [Exactly One Delivery](docs/cloud-platforms/cloud-patterns/exactly-one-delivery.md) · [Gateway Aggregation](docs/cloud-platforms/cloud-patterns/gateway-aggregation.md) · [Gateway Pattern](docs/cloud-platforms/cloud-patterns/gateway-pattern.md) · [Inbox Pattern](docs/cloud-platforms/cloud-patterns/inbox-pattern.md) · [Outbox Pattern](docs/cloud-platforms/cloud-patterns/outbox-pattern.md) · [Sidecar](docs/cloud-platforms/cloud-patterns/sidecar.md) · [Strangler Fig Pattern](docs/cloud-platforms/cloud-patterns/strangler-fig-pattern.md) · [Ansible](docs/cloud-platforms/iaas/ansible.md) · [IaaS](docs/cloud-platforms/iaas/iaas.md) · [Nomad](docs/cloud-platforms/iaas/nomad.md) · [Pulumi](docs/cloud-platforms/iaas/pulumi.md) · [Terraform](docs/cloud-platforms/iaas/terraform.md) · [Envoy](docs/cloud-platforms/networking/envoy.md) · [Fabio](docs/cloud-platforms/networking/fabio.md) · [Haproxy](docs/cloud-platforms/networking/haproxy.md) · [Load Balancing](docs/cloud-platforms/networking/load-balancing.md) · [Metallb](docs/cloud-platforms/networking/metallb.md) · [Nginx](docs/cloud-platforms/networking/nginx.md) · [Reverse Proxy](docs/cloud-platforms/networking/reverse-proxy.md) · [Traefik](docs/cloud-platforms/networking/traefik.md) · [Yarp](docs/cloud-platforms/networking/yarp.md) · [Heroku](docs/cloud-platforms/paas/heroku.md) · [Netlify](docs/cloud-platforms/paas/netlify.md) · [Openshift](docs/cloud-platforms/paas/openshift.md) · [Rancher](docs/cloud-platforms/paas/rancher.md) · [Serverless](docs/cloud-platforms/serverless.md) | | **[Data](docs/data/)** | [Databases](docs/data/databases/) | [Caching](docs/data/caching.md) · [Data Driven Design](docs/data/data-driven-design.md) · [Cosmos DB](docs/data/databases/nosql/cosmosdb.md) · [Documentdb](docs/data/databases/nosql/documentdb.md) · [MongoDB](docs/data/databases/nosql/mongodb.md) · [NoSQL](docs/data/databases/nosql/nosql.md) · [Ravendb](docs/data/databases/nosql/ravendb.md) · [Postgres](docs/data/databases/relational/postgres.md) · [Relational Database](docs/data/databases/relational/relational-database.md) · [SQL](docs/data/databases/relational/sql.md) · [Replication](docs/data/databases/replication.md) · [Sharding](docs/data/databases/sharding.md) · [IDs](docs/data/ids.md) | | **[Devops](docs/devops/)** | [CI/CD](docs/devops/ci-cd/) · [Docker](docs/devops/docker/) · [Kubernetes](docs/devops/kubernetes/) · [Terminal](docs/devops/terminal/) | [Azure Devops](docs/devops/ci-cd/azure-devops.md) · [GitHub Actions](docs/devops/ci-cd/github-actions.md) · [Jenkins](docs/devops/ci-cd/jenkins.md) · [Containerd](docs/devops/containerd.md) · [Docker Compose](docs/devops/docker/docker-compose.md) · [Docker](docs/devops/docker/docker.md) · [GitOps](docs/devops/gitops.md) · [Debuging Development](docs/devops/kubernetes/debuging-development.md) · [Deployment Strategies](docs/devops/kubernetes/deployment-strategies.md) · [Argo Cd](docs/devops/kubernetes/deployment-tools/argo-cd.md) · [Flux](docs/devops/kubernetes/deployment-tools/flux.md) · [Helm](docs/devops/kubernetes/deployment-tools/helm.md) · [Jenkins](docs/devops/kubernetes/deployment-tools/jenkins.md) · [Kubernetes Operator](docs/devops/kubernetes/deployment-tools/kubernetes-operator.md) · [Kustomize](docs/devops/kubernetes/deployment-tools/kustomize.md) · [Ingress Controller](docs/devops/kubernetes/ingress-controller/ingress-controller.md) · [Nginx Ingress](docs/devops/kubernetes/ingress-controller/nginx-ingress.md) · [Traefik Ingress](docs/devops/kubernetes/ingress-controller/traefik-ingress.md) · [Kubernetes](docs/devops/kubernetes/kubernetes.md) · [Garden](docs/devops/kubernetes/other-tools/garden.md) · [K3s](docs/devops/kubernetes/other-tools/k3s.md) · [Mirrord](docs/devops/kubernetes/other-tools/mirrord.md) · [Okteto](docs/devops/kubernetes/other-tools/okteto.md) · [Skaffold](docs/devops/kubernetes/other-tools/skaffold.md) · [Telepresence](docs/devops/kubernetes/other-tools/telepresence.md) · [Tilt](docs/devops/kubernetes/other-tools/tilt.md) · [Services](docs/devops/kubernetes/services.md) · [Linux Bash](docs/devops/linux-bash.md) · [Bash](docs/devops/terminal/bash.md) · [Powershell](docs/devops/terminal/powershell.md) | | **[Distributed Systems](docs/distributed-systems/)** | [Messaging](docs/distributed-systems/messaging/) · [Microservices](docs/distributed-systems/microservices/) · [Reliability](docs/distributed-systems/reliability/) · [Service Discovery](docs/distributed-systems/service-discovery/) · [Service Mesh](docs/distributed-systems/service-mesh/) · [Systems Design](docs/distributed-systems/systems-design/) | [Back Pressure](docs/distributed-systems/back-pressure.md) · [Concurrency](docs/distributed-systems/concurrency.md) · [Distributed Locking](docs/distributed-systems/distributed-locking.md) · [Distributed Transactions](docs/distributed-systems/distributed-transactions.md) · [Event Driven Architecture](docs/distributed-systems/event-driven-architecture.md) · [Eventual Consistency](docs/distributed-systems/eventual-consistency.md) · [gRPC](docs/distributed-systems/grpc.md) · [Async API Documentation](docs/distributed-systems/messaging/async-api-documentation.md) · [Change Data Capture](docs/distributed-systems/messaging/change-data-capture.md) · [Kafka](docs/distributed-systems/messaging/kafka.md) · [Messaging Patterns](docs/distributed-systems/messaging/messaging-patterns.md) · [Messaging](docs/distributed-systems/messaging/messaging.md) · [NATS](docs/distributed-systems/messaging/nats.md) · [Rabbitmq](docs/distributed-systems/messaging/rabbitmq.md) · [Zeromq](docs/distributed-systems/messaging/zeromq.md) · [Ambassador](docs/distributed-systems/microservices/api-gateway/ambassador.md) · [API Gateway](docs/distributed-systems/microservices/api-gateway/api-gateway.md) · [Kong](docs/distributed-systems/microservices/api-gateway/kong.md) · [Ocelot](docs/distributed-systems/microservices/api-gateway/ocelot.md) · [Communication](docs/distributed-systems/microservices/communication.md) · [Composite Ui](docs/distributed-systems/microservices/composite-ui.md) · [Microservices](docs/distributed-systems/microservices/microservices.md) · [CorrelationId](docs/distributed-systems/microservices/observability/correlationId.md) · [Diagnostics](docs/distributed-systems/microservices/observability/diagnostics.md) · [Distributed Tracing](docs/distributed-systems/microservices/observability/distributed-tracing.md) · [Logging](docs/distributed-systems/microservices/observability/logging.md) · [Monitoring](docs/distributed-systems/microservices/observability/monitoring.md) · [Observability](docs/distributed-systems/microservices/observability/observability.md) · [EFK](docs/distributed-systems/microservices/observability/tools/efk.md) · [ELK](docs/distributed-systems/microservices/observability/tools/elk.md) · [Fluent Bit](docs/distributed-systems/microservices/observability/tools/fluent-bit.md) · [Fluentd](docs/distributed-systems/microservices/observability/tools/fluentd.md) · [Loki](docs/distributed-systems/microservices/observability/tools/loki.md) · [High Availibility](docs/distributed-systems/microservices/resiliency/high-availibility.md) · [Idempotency](docs/distributed-systems/microservices/resiliency/idempotency.md) · [Resiliency](docs/distributed-systems/microservices/resiliency/resiliency.md) · [SBOM](docs/distributed-systems/microservices/security/sbom.md) · [Security Scan](docs/distributed-systems/microservices/security/security-scan.md) · [Security](docs/distributed-systems/microservices/security/security.md) · [Vault](docs/distributed-systems/microservices/security/vault.md) · [Services Boundries](docs/distributed-systems/microservices/services-boundries.md) · [Testing](docs/distributed-systems/microservices/testing.md) · [Aspire](docs/distributed-systems/microservices/tools/aspire.md) · [CAP](docs/distributed-systems/microservices/tools/cap.md) · [Dapr](docs/distributed-systems/microservices/tools/dapr.md) · [Mass Transit](docs/distributed-systems/microservices/tools/mass-transit.md) · [Nservicebus](docs/distributed-systems/microservices/tools/nservicebus.md) · [Steeltoe](docs/distributed-systems/microservices/tools/steeltoe.md) · [Tye](docs/distributed-systems/microservices/tools/tye.md) · [Wolverine](docs/distributed-systems/microservices/tools/wolverine.md) · [Scaling](docs/distributed-systems/scaling.md) · [Consul](docs/distributed-systems/service-discovery/consul.md) · [Eureka](docs/distributed-systems/service-discovery/eureka.md) · [Service Discovery](docs/distributed-systems/service-discovery/service-discovery.md) · [Istio](docs/distributed-systems/service-mesh/istio.md) · [Linkerd](docs/distributed-systems/service-mesh/linkerd.md) · [Maesh](docs/distributed-systems/service-mesh/maesh.md) · [Service Mesh](docs/distributed-systems/service-mesh/service-mesh.md) · [Consistent Hash](docs/distributed-systems/systems-design/consistent-hash.md) · [Systems Design](docs/distributed-systems/systems-design/systems-design.md) | | **[Foundations](docs/foundations/)** | [Modeling](docs/foundations/modeling/) | [Abstraction](docs/foundations/abstraction.md) · [Algorithm](docs/foundations/algorithm.md) · [Architecture Documententation](docs/foundations/architecture-documententation.md) · [Clean Code](docs/foundations/clean-code.md) · [Code Review](docs/foundations/code-review.md) · [Functional](docs/foundations/functional.md) · [Architecture Diagram](docs/foundations/modeling/architecture-diagram.md) · [Class Diagram](docs/foundations/modeling/class-diagram.md) · [Component Diagram](docs/foundations/modeling/component-diagram.md) · [Conceptual Modeling](docs/foundations/modeling/conceptual-modeling.md) · [Data Model Notations](docs/foundations/modeling/data-model-notations.md) · [Domain Stroytelling](docs/foundations/modeling/domain-stroytelling.md) · [Er Diagrams](docs/foundations/modeling/er-diagrams.md) · [Event Modeling](docs/foundations/modeling/event-modeling.md) · [Event Storming](docs/foundations/modeling/event-storming.md) · [Logical Modeling](docs/foundations/modeling/logical-modeling.md) · [Modeling](docs/foundations/modeling/modeling.md) · [Physical Modeling](docs/foundations/modeling/physical-modeling.md) · [Relationship](docs/foundations/modeling/relationship.md) · [Tools](docs/foundations/modeling/tools.md) · [Use Case Diagram](docs/foundations/modeling/use-case-diagram.md) · [Object Oriented Design](docs/foundations/object-oriented-design.md) · [Open Source](docs/foundations/open-source.md) · [Others](docs/foundations/others.md) · [Refactoring](docs/foundations/refactoring.md) · [Software Architecture](docs/foundations/software-architecture.md) · [Type Driven Design](docs/foundations/type-driven-design.md) | | **[Software Architecture](docs/software-architecture/)** | [Anti Patterns](docs/software-architecture/anti-patterns/) · [Architecture Patterns](docs/software-architecture/architecture-patterns/) · [Design Practices](docs/software-architecture/design-practices/) · [Principles](docs/software-architecture/principles/) | [Anti Patterns](docs/software-architecture/anti-patterns/anti-patterns.md) · [Big Ball Of Mud](docs/software-architecture/anti-patterns/big-ball-of-mud.md) · [Code Smells](docs/software-architecture/anti-patterns/code-smells.md) · [God Object](docs/software-architecture/anti-patterns/god-object.md) · [Leaky Abstractions](docs/software-architecture/anti-patterns/leaky-abstractions.md) · [Partial Object](docs/software-architecture/anti-patterns/partial-object.md) · [Static Cling](docs/software-architecture/anti-patterns/static-cling.md) · [Actor Model Architecture](docs/software-architecture/architecture-patterns/actor-model/actor-model-architecture.md) · [Akka .NET](docs/software-architecture/architecture-patterns/actor-model/akka-net.md) · [Orleans](docs/software-architecture/architecture-patterns/actor-model/orleans.md) · [Protoactor](docs/software-architecture/architecture-patterns/actor-model/protoactor.md) · [Clean Architecture](docs/software-architecture/architecture-patterns/clean-architecture.md) · [CQRS](docs/software-architecture/architecture-patterns/cqrs.md) · [Adapter Pattern](docs/software-architecture/architecture-patterns/design-patterns/adapter-pattern.md) · [Builder](docs/software-architecture/architecture-patterns/design-patterns/builder.md) · [Chain Of Responsibility](docs/software-architecture/architecture-patterns/design-patterns/chain-of-responsibility.md) · [Command Message Pattern](docs/software-architecture/architecture-patterns/design-patterns/command-message-pattern.md) · [Command Pattern](docs/software-architecture/architecture-patterns/design-patterns/command-pattern.md) · [Decorator Pattern](docs/software-architecture/architecture-patterns/design-patterns/decorator-pattern.md) · [Design Patterns](docs/software-architecture/architecture-patterns/design-patterns/design-patterns.md) · [Factory Pattern](docs/software-architecture/architecture-patterns/design-patterns/factory-pattern.md) · [Mediator Pattern](docs/software-architecture/architecture-patterns/design-patterns/mediator-pattern.md) · [Observer](docs/software-architecture/architecture-patterns/design-patterns/observer.md) · [Query Object Pattern](docs/software-architecture/architecture-patterns/design-patterns/query-object-pattern.md) · [Repository Pattern](docs/software-architecture/architecture-patterns/design-patterns/repository-pattern.md) · [REPR](docs/software-architecture/architecture-patterns/design-patterns/repr.md) · [Service Locator](docs/software-architecture/architecture-patterns/design-patterns/service-locator.md) · [Singleton](docs/software-architecture/architecture-patterns/design-patterns/singleton.md) · [Specification Pattern](docs/software-architecture/architecture-patterns/design-patterns/specification-pattern.md) · [State Pattern](docs/software-architecture/architecture-patterns/design-patterns/state-pattern.md) · [Strategy Pattern](docs/software-architecture/architecture-patterns/design-patterns/strategy-pattern.md) · [Transaction Script Pattern](docs/software-architecture/architecture-patterns/design-patterns/transaction-script-pattern.md) · [Aggregation](docs/software-architecture/architecture-patterns/domain-driven-design/aggregation.md) · [Anemic Domain Model](docs/software-architecture/architecture-patterns/domain-driven-design/anemic-domain-model.md) · [Application Service](docs/software-architecture/architecture-patterns/domain-driven-design/application-service.md) · [Bounded Context](docs/software-architecture/architecture-patterns/domain-driven-design/bounded-context.md) · [Domain Driven Design](docs/software-architecture/architecture-patterns/domain-driven-design/domain-driven-design.md) · [Domain Events](docs/software-architecture/architecture-patterns/domain-driven-design/domain-events.md) · [Domain Primitives](docs/software-architecture/architecture-patterns/domain-driven-design/domain-primitives.md) · [Domain Service](docs/software-architecture/architecture-patterns/domain-driven-design/domain-service.md) · [Domain](docs/software-architecture/architecture-patterns/domain-driven-design/domain.md) · [Enums](docs/software-architecture/architecture-patterns/domain-driven-design/enums.md) · [Exception And Validation](docs/software-architecture/architecture-patterns/domain-driven-design/exception-and-validation.md) · [Infrastructure](docs/software-architecture/architecture-patterns/domain-driven-design/infrastructure.md) · [Integration Event](docs/software-architecture/architecture-patterns/domain-driven-design/integration-event.md) · [Mapping](docs/software-architecture/architecture-patterns/domain-driven-design/mapping.md) · [EF](docs/software-architecture/architecture-patterns/domain-driven-design/orm/ef.md) · [Rich Domain Model](docs/software-architecture/architecture-patterns/domain-driven-design/rich-domain-model.md) · [Strategic Design Patterns](docs/software-architecture/architecture-patterns/domain-driven-design/strategic-design-patterns.md) · [Tactical Design Patterns](docs/software-architecture/architecture-patterns/domain-driven-design/tactical-design-patterns.md) · [Value Objects](docs/software-architecture/architecture-patterns/domain-driven-design/value-objects.md) · [Event Sourcing](docs/software-architecture/architecture-patterns/event-sourcing.md) · [Hexagonal Architecture](docs/software-architecture/architecture-patterns/hexagonal-architecture.md) · [Micro Frontend](docs/software-architecture/architecture-patterns/micro-frontend.md) · [Modular Monolith](docs/software-architecture/architecture-patterns/modular-monolith.md) · [Onion Architecture](docs/software-architecture/architecture-patterns/onion-architecture.md) · [Rest](docs/software-architecture/architecture-patterns/rest.md) · [Service Oriented Architecture](docs/software-architecture/architecture-patterns/service-oriented-architecture.md) · [Vertical Slice Architecture](docs/software-architecture/architecture-patterns/vertical-slice-architecture.md) · [12 Factor](docs/software-architecture/design-practices/12-factor.md) · [Design Best Practices](docs/software-architecture/design-practices/design-best-practices.md) · [Thin Controllers](docs/software-architecture/design-practices/thin-controllers.md) · [Architectural Design Principles](docs/software-architecture/principles/architectural-design-principles.md) · [CAP](docs/software-architecture/principles/cap.md) · [Cohesion](docs/software-architecture/principles/cohesion.md) · [Coupling](docs/software-architecture/principles/coupling.md) · [CQS](docs/software-architecture/principles/cqs.md) · [Cross Cutting Concerns](docs/software-architecture/principles/cross-cutting-concerns.md) · [Dependency Inversion](docs/software-architecture/principles/dependency-inversion.md) · [DRY](docs/software-architecture/principles/dry.md) · [Encapsulation](docs/software-architecture/principles/encapsulation.md) · [Fail Fast](docs/software-architecture/principles/fail-fast.md) · [Favor Composition Over Inheritance](docs/software-architecture/principles/favor-composition-over-inheritance.md) · [Grasp](docs/software-architecture/principles/grasp.md) · [Interface Segregation](docs/software-architecture/principles/interface-segregation.md) · [Inversion Control](docs/software-architecture/principles/inversion-control.md) · [Kiss](docs/software-architecture/principles/kiss.md) · [Open Closed Principles](docs/software-architecture/principles/open-closed-principles.md) · [Persistence Ignorance](docs/software-architecture/principles/persistence-ignorance.md) · [Single Responsibility](docs/software-architecture/principles/single-responsibility.md) · [SOLID](docs/software-architecture/principles/solid.md) · [YAGNI](docs/software-architecture/principles/yagni.md) | Topic pages are discovered from folders automatically, so new topics do not require manual navigation updates. ## Browse Resources The catalog includes articles, videos, courses, books, libraries, samples, tools, and other references. Search the [web app](https://awesome-architecture.com/) by collection, topic, section, name or source domain, or browse the full source tree in [`docs/`](docs/). ## 🙏 Special Thanks Thanks to the authors of the links for their valuable content. This project gathers them in one place so architecture topics are easier to find and study. ## ⭐ Support If you like the project, feel free to star the repository. It helps the collection reach more builders. ## 🤝 Contribution Contributions are always welcome. Please read the [contribution guidelines](contributing.md) first. Thanks to all [contributors](https://github.com/mehdihadeli/awesome-software-architecture/graphs/contributors). The goal is to build a categorized, community-driven collection of practical architecture resources. ## 2. In-Tree Documentation Chapters (mehdihadeli/awesome-software-architecture) ## File: docs/ai/a2a.md # A2A ## Resources - [Agent2Agent (A2A) Protocol Specification](https://a2a-protocol.org/v0.2.5/specification/) ## Articles - [Building AI Agents with the A2A .NET SDK](https://devblogs.microsoft.com/foundry/building-ai-agents-a2a-dotnet-sdk/) - [Agent Discovery, Naming, and Resolution - the Missing Pieces to A2A](https://blog.christianposta.com/dynamic-agent-discovery-with-a2a-and-ans/) - [Configuring A2A OAuth User Delegation](https://blog.christianposta.com/setting-up-a2a-oauth-user-delegation/) - [Understanding Sessions in Agent to Agent Communication](https://blog.christianposta.com/understanding-sessions-in-agent-to-agent-communication/) - [Mitigate Prompt Injection Attacks With A2AS and Agentgateway](https://blog.christianposta.com/mitigate-prompt-injection-attacks-with-a2as-and-agentgateway/) - [Deep Dive MCP and A2A Attack Vectors for AI Agents](https://blog.christianposta.com/understanding-mcp-and-a2a-attack-vectors-for-ai-agents/) ## Libraries & Tools - [agentgateway/agentgateway](https://github.com/agentgateway/agentgateway) - Next Generation Agentic Proxy for AI Agents and MCP servers ## Samples - [christian-posta/oauth-agent-flows](https://github.com/christian-posta/oauth-agent-flows) - OAuth Agent Token Exchange --- ## File: docs/ai/acp.md # Agent Client Protocol (ACP) ## Resources - [agentclientprotocol/agent-client-protocol](https://github.com/agentclientprotocol/agent-client-protocol) - [Agent Client Protocol (ACP) - agentclientprotocol.com](https://agentclientprotocol.com/) ## Articles - [Agent Client Protocol (ACP) - Jetbrains](https://www.jetbrains.com/help/ai-assistant/acp.html) ## Tools - [RAIT-09/obsidian-agent-client](https://github.com/RAIT-09/obsidian-agent-client) - Bring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI. --- ## File: docs/ai/agent.md # Agents ## Resources - [microsoft/ai-agents-for-beginners](https://github.com/microsoft/ai-agents-for-beginners) - 12 Lessons to Get Started Building AI Agents - [huggingface/agents-course](https://github.com/huggingface/agents-course) - This repository contains the Hugging Face Agents Course. ## Samples - [NirDiamant/GenAI_Agents](https://github.com/NirDiamant/GenAI_Agents) - This repository provides tutorials and implementations for various Generative AI Agent techniques, from basic to advanced. It serves as a comprehensive guide for building intelligent, interactive AI systems. - [NirDiamant/agents-towards-production](https://github.com/NirDiamant/agents-towards-production) - This repository delivers end-to-end, code-first tutorials covering every layer of production-grade GenAI agents, guiding you from spark to scale with proven patterns and reusable blueprints for real-world launches. - [luisquintanilla/maf-ghcpsdk-sample](https://github.com/luisquintanilla/maf-ghcpsdk-sample) ## Tools & Libraries - [microsoft/agent-framework](https://github.com/microsoft/agent-framework) - A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Python and .NET. - [kagent-dev/kagent](https://github.com/kagent-dev/kagent) - Cloud Native Agentic AI - [ag-ui-protocol/ag-ui](https://github.com/ag-ui-protocol/ag-ui) - AG-UI: the Agent-User Interaction Protocol. Bring Agents into Frontend Applications - [pydantic/pydantic-ai](https://github.com/pydantic/pydantic-ai) - GenAI Agent Framework, the Pydantic way --- METRICS --- - Files Extracted: 4 - Estimated Token Budget: ~7059 tokens - Recency Window: Active (< 180 days) - Canonical Reference: https://codewiki.google/github.com/mehdihadeli/awesome-software-architecture