# designpattern.fyi — The Blueprint for Modern Software Architecture

> A curated catalog of clean, reusable, and interactive design patterns for modern software engineering, distributed systems, and Agentic AI.

- **Total Patterns**: 723+
- **Categories**: 13
- **Primary Focus**: Agentic AI, Cloud Architecture, Microservices, Security Guardrails, and Distributed Systems Trade-offs.
- **Canonical URL**: https://www.designpattern.fyi/
- **Machine Catalog Feed**: https://www.designpattern.fyi/api/patterns.json
- **OpenAPI 3.1 Spec**: https://www.designpattern.fyi/api/openapi.json
- **llms.txt Index**: https://www.designpattern.fyi/llms.txt

---

## Architectural Primitives for Non-Deterministic Software

1. **Semantic Routing**: Inbound payloads are evaluated by low-latency embedding routers to dynamically select the cheapest, correct execution path, separating simple extraction from deep reasoning workflows.
2. **Validator-Corrector Loops**: Closed-loop deterministic validation (e.g. Pydantic schema validation) intercepts exceptions, constructs structured error feedback, and re-prompts the model before state mutations reach downstream systems.

---

## Pattern Categories & Deep Dives

### 1. Agentic AI & Cognitive Architecture
- **Agentic AI Patterns** (`/agentic_ai/`): 329 patterns for reasoning, memory tiers (Working, Episodic, Semantic, Procedural), tool orchestration, planning, and multi-agent coordination.
- **The Agent Loop** (`/agent-loop/`): The continuous Perceive-Plan-Act-Observe-Iterate cycle.
- **Agent Memory Architecture** (`/agent-memory/`): Hierarchical memory structures for autonomous agents.
- **Agent Skills Specification** (`/agent-skills/`): Modular, version-controlled domain skill units.
- **Open Knowledge Format (OKF)** (`/okf/`): Interoperable knowledge representation standard for agent reasoning.
- **Agentic Resource Discovery (ARD)** (`/ard/`): Federated capability discovery protocol for agent ecosystems.

### 2. Distributed Systems & Infrastructure
- **Cloud Architecture Patterns** (`/cloud/`): 79 patterns for AWS, Azure, GCP, and Kubernetes resilience.
- **Microservices Patterns** (`/microservices/`): 35 patterns for service decomposition, API gateways, sagas, outbox, and circuit breakers.
- **Event-Driven Architecture** (`/event_driven_architecture/`): 15 patterns for CQRS, event sourcing, and event streaming.
- **Enterprise Integration Patterns** (`/integration/`): 59 patterns for message routing, channels, and transformation.

### 3. Software Engineering Foundations
- **SOLID Principles** (`/solid/`): SRP, OCP, LSP, ISP, and DIP with practical implementations.
- **OOP Concepts** (`/oop_concepts/`): Encapsulation, inheritance, polymorphism, abstraction.
- **Algorithms & Data Structures** (`/algorithms/`, `/data_structures/`): Sorting, graph traversals, trees, and hash structures.
- **Big-O Complexity** (`/big_o/`): Time & space trade-off analysis.
- **Code Smells & Refactoring** (`/code_smells/`): Bloaters, couplers, dispensables, and clean refactorings.

### 4. AI Security & Guardrails
- **OWASP Agentic AI Top 10** (`/owasp_agentic_ai/`): Goal hijacking, tool misuse, privilege escalation, and memory poisoning defense.
- **OWASP LLM Top 10** (`/owasp_llm/`): Prompt injection, insecure output handling, model theft.
- **Securing AI Agents** (`/securing-ai-agents/`): Defense-in-depth security architectures for production agent deployments.

---

## Machine-Readable Resources
- **JSON Pattern Feed**: `https://www.designpattern.fyi/api/patterns.json`
- **JSON Categories Feed**: `https://www.designpattern.fyi/api/categories.json`
- **OpenAPI 3.1 Spec**: `https://www.designpattern.fyi/api/openapi.json`
- **MCP Server Definition**: `https://www.designpattern.fyi/api/mcp-schema.json`
- **Agent Instructions**: `https://www.designpattern.fyi/agent-instructions.txt`
- **Full LLM Context**: `https://www.designpattern.fyi/llms-full.txt`