Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 31 additions & 2 deletions .ref-cache.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,9 @@
"http://www.omg.org/spec/BPMN/2.0/": 200,
"https://12factor.net/config": 200,
"https://aclanthology.org/2023.acl-long.99/": 200,
"https://ai-sdk.dev/docs/ai-sdk-core/tools-and-tool-calling": 200,
"https://ai.google.dev/gemini-api/docs/function-calling": 200,
"https://ai.google.dev/gemini-api/docs/structured-output": 200,
"https://algoritmos-iii.github.io/assets/bibliografia/simple-technique-for-handling-multiple-polymorphism.pdf": 200,
"https://alistair.cockburn.us/hexagonal-architecture/": 200,
"https://americanexpress.io/cell-based-architecture-for-resilient-payment-systems/": 200,
Expand Down Expand Up @@ -43,6 +45,7 @@
"https://arxiv.org/abs/2305.18323": 200,
"https://arxiv.org/abs/2306.05685": 200,
"https://arxiv.org/abs/2307.03172": 200,
"https://arxiv.org/abs/2307.09702": 200,
"https://arxiv.org/abs/2309.15217": 200,
"https://arxiv.org/abs/2310.03714": 200,
"https://arxiv.org/abs/2310.04406": 200,
Expand Down Expand Up @@ -74,6 +77,7 @@
"https://clang.llvm.org/docs/RAVFrontendAction.html": 200,
"https://code.claude.com/docs/en/sub-agents": 200,
"https://code.visualstudio.com/api/extension-guides/command": 200,
"https://code.visualstudio.com/docs/copilot/chat/mcp-servers": 200,
"https://condor.depaul.edu/dmumaugh/OOT/Design-Principles/acv.pdf": 200,
"https://cqrs.files.wordpress.com/2010/11/cqrs_documents.pdf": 200,
"https://cqrs.wordpress.com/wp-content/uploads/2010/11/cqrs_documents.pdf": 200,
Expand Down Expand Up @@ -117,11 +121,13 @@
"https://developers.llamaindex.ai/python/framework/use_cases/agents/": 200,
"https://developers.openai.com/api/docs/guides/embeddings": 200,
"https://developers.openai.com/api/docs/guides/function-calling": 200,
"https://developers.openai.com/api/docs/guides/structured-outputs": 200,
"https://developers.openai.com/cookbook/articles/techniques_to_improve_reliability": 200,
"https://developers.openai.com/cookbook/examples/structured_outputs_intro": 200,
"https://discord.com/blog/how-discord-stores-trillions-of-messages": 200,
"https://dl.acm.org/doi/10.1145/16894.16861": "403 then HTTPError",
"https://dl.acm.org/doi/10.1145/16894.16861": 200,
"https://dl.acm.org/doi/10.1145/359763.359789": "403 then HTTPError",
"https://dl.acm.org/doi/10.1145/44483.44488": "403 then HTTPError",
"https://dl.acm.org/doi/10.1145/44483.44488": 200,
"https://dl.acm.org/doi/10.1145/582318.582339": "403 then HTTPError",
"https://dl.acm.org/doi/10.14778/2757807.2757813": "403 then HTTPError",
"https://doc.akka.io/libraries/akka-core/current/typed/fsm.html": 200,
Expand Down Expand Up @@ -213,6 +219,8 @@
"https://docs.kurrent.io/server/v25.0/features/streams.html": 200,
"https://docs.langchain.com/oss/python/integrations/splitters/recursive_text_splitter": 200,
"https://docs.langchain.com/oss/python/langchain/rag": 200,
"https://docs.langchain.com/oss/python/langchain/structured-output": 200,
"https://docs.langchain.com/oss/python/langgraph/graph-api": 200,
"https://docs.langchain.com/oss/python/langgraph/workflows-agents": 200,
"https://docs.nginx.com/nginx/admin-guide/security-controls/terminating-ssl-http/": 200,
"https://docs.opensearch.org/latest/query-dsl/compound/hybrid/": 200,
Expand Down Expand Up @@ -298,6 +306,7 @@
"https://docs.temporal.io/evaluate/use-cases-design-patterns": 200,
"https://docs.temporal.io/workflows": 200,
"https://docs.unity3d.com/6000.0/Documentation/Manual/Prefabs.html": 200,
"https://docs.vllm.ai/en/latest/features/structured_outputs.html": 200,
"https://docs.weaviate.io/weaviate/search/hybrid": 200,
"https://dom.spec.whatwg.org/": 200,
"https://download.eclipse.org/microprofile/microprofile-lra-2.0/microprofile-lra-spec-2.0.html": 200,
Expand Down Expand Up @@ -325,6 +334,7 @@
"https://en.wikipedia.org/wiki/Little%27s_law": 200,
"https://en.wikipedia.org/wiki/Mediator_pattern": 200,
"https://en.wikipedia.org/wiki/Memento_pattern": 200,
"https://en.wikipedia.org/wiki/Memoization": 200,
"https://en.wikipedia.org/wiki/Observer_pattern": 200,
"https://en.wikipedia.org/wiki/OpenAI_o1": 200,
"https://en.wikipedia.org/wiki/Pipeline_(Unix)": 200,
Expand Down Expand Up @@ -373,13 +383,16 @@
"https://github.com/ben-manes/caffeine/wiki/Refresh": 200,
"https://github.com/brandur/redis-cell": 200,
"https://github.com/david-sauvage/effective-java-summary/blob/master/README.md": 200,
"https://github.com/dottxt-ai/outlines": 200,
"https://github.com/eventuate-tram/eventuate-tram-sagas": 200,
"https://github.com/grpc/proposal/blob/master/A6-client-retries.md": 200,
"https://github.com/infiniflow/ragflow": 200,
"https://github.com/infiniflow/ragflow/blob/main/web/src/locales/en.ts": 200,
"https://github.com/instructor-ai/instructor": 200,
"https://github.com/jbogard/MediatR": 200,
"https://github.com/jina-ai/late-chunking": 200,
"https://github.com/koajs/koa/blob/master/docs/guide.md": 200,
"https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/caches.py": 200,
"https://github.com/langchain-ai/langchain/blob/master/libs/langchain/langchain_classic/chains/hyde/base.py": 200,
"https://github.com/langchain-ai/langgraph": 200,
"https://github.com/langchain-ai/langgraph-supervisor-py": 200,
Expand All @@ -388,6 +401,7 @@
"https://github.com/langchain-ai/langgraph/blob/main/examples/rag/langgraph_crag.ipynb": 200,
"https://github.com/lapisrocks/LanguageAgentTreeSearch": 200,
"https://github.com/microsoft/graphrag": 200,
"https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/schema/2025-06-18/schema.ts": 200,
"https://github.com/noahshinn/reflexion": 200,
"https://github.com/npryce/make-it-easy": 200,
"https://github.com/orgs/community/discussions/142971": 200,
Expand All @@ -400,6 +414,7 @@
"https://github.com/tc39/proposal-decorators": 200,
"https://github.com/tc39/proposal-signals": 200,
"https://github.com/yoheinakajima/babyagi": 200,
"https://github.com/zilliztech/GPTCache": 200,
"https://go.dev/blog/range-functions": 200,
"https://go.dev/doc/effective_go": 200,
"https://go.dev/doc/faq": 200,
Expand All @@ -413,6 +428,7 @@
"https://html.spec.whatwg.org/multipage/structured-data.html#structuredclone": 200,
"https://huggingface.co/papers/2310.11511": 200,
"https://huggingface.co/selfrag/selfrag_llama2_7b": 200,
"https://invariantlabs.ai/blog/mcp-security-notification-tool-poisoning-attacks": 200,
"https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines": 200,
"https://istio.io/latest/docs/ops/deployment/architecture/": 200,
"https://jakarta.ee/learn/docs/jakartaee-tutorial/current/web/servlets/servlets.html": 200,
Expand Down Expand Up @@ -552,6 +568,11 @@
"https://microsoft.github.io/autogen/stable/user-guide/core-user-guide/design-patterns/reflection.html": 200,
"https://microsoft.github.io/graphrag/": 200,
"https://modelcontextprotocol.io/docs/concepts/tools": 200,
"https://modelcontextprotocol.io/docs/learn/architecture": 200,
"https://modelcontextprotocol.io/specification/2025-06-18": 200,
"https://modelcontextprotocol.io/specification/2025-06-18/basic/lifecycle": 200,
"https://modelcontextprotocol.io/specification/2025-06-18/basic/transports": 200,
"https://modelcontextprotocol.io/specification/2025-06-18/server/tools": 200,
"https://mosquitto.org/man/mosquitto-conf-5.html": 200,
"https://netflixtechblog.com/active-active-for-multi-regional-resiliency-c47719f6685b": 200,
"https://netty.io/4.1/api/io/netty/channel/ChannelPipeline.html": 200,
Expand All @@ -564,6 +585,7 @@
"https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-88r1.pdf": 200,
"https://open-policy-agent.github.io/gatekeeper/website/docs/": 200,
"https://openai.com/index/introducing-gpt-5/": 200,
"https://openai.github.io/openai-agents-python/mcp/": 200,
"https://openrouter.ai/openrouter/auto": 200,
"https://opentelemetry.io/docs/concepts/signals/traces/": 200,
"https://peps.python.org/pep-0008/": 200,
Expand All @@ -580,7 +602,11 @@
"https://pkg.go.dev/sync": 200,
"https://pkg.go.dev/sync#Map.Range": 200,
"https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview": 200,
"https://platform.claude.com/docs/en/agents-and-tools/tool-use/strict-tool-use": 200,
"https://platform.claude.com/docs/en/build-with-claude/extended-thinking": 200,
"https://platform.claude.com/docs/en/build-with-claude/structured-outputs": 200,
"https://platform.claude.com/docs/en/build-with-claude/tool-use/overview": 200,
"https://platform.claude.com/docs/en/docs/build-with-claude/prompt-caching": 200,
"https://pragprog.com/titles/mnee2/release-it-second-edition/": 200,
"https://proceedings.neurips.cc/paper_files/paper/2023/hash/271db9922b8d1f4dd7aaef84ed5ac703-Abstract-Conference.html": 200,
"https://projectlombok.org/features/Data": 200,
Expand All @@ -601,6 +627,7 @@
"https://redis.io/docs/latest/develop/programmability/eval-intro/": 200,
"https://redis.io/docs/latest/develop/pubsub/": 200,
"https://redis.io/docs/latest/operate/oss_and_stack/management/persistence/": 200,
"https://redis.io/langcache/": 200,
"https://redux.js.org/api/store": 200,
"https://refactoring-assistant.github.io/object-oriented-abusers/alternative-classes-with-different-interfaces": 200,
"https://refactoring.com/catalog/": 200,
Expand All @@ -617,6 +644,7 @@
"https://selfrag.github.io/": 200,
"https://shopify.dev/docs/api/usage/rate-limits": 200,
"https://shopify.engineering/a-pods-architecture-to-allow-shopify-to-scale": 200,
"https://simonwillison.net/2024/Aug/6/openai-structured-outputs/": 200,
"https://simonwillison.net/2025/Jun/16/the-lethal-trifecta/": 200,
"https://slack.engineering/slacks-migration-to-a-cellular-architecture/": 200,
"https://sourcemaking.com/design_patterns/template_method": 200,
Expand Down Expand Up @@ -648,6 +676,7 @@
"https://www.anthropic.com/engineering/building-effective-agents": 200,
"https://www.anthropic.com/engineering/multi-agent-research-system": 200,
"https://www.anthropic.com/news/contextual-retrieval": 200,
"https://www.anthropic.com/news/model-context-protocol": 200,
"https://www.anthropic.com/research/building-effective-agents": 200,
"https://www.boost.org/doc/libs/release/libs/statechart/doc/index.html": 200,
"https://www.brooker.co.za/blog/2020/02/17/physalia.html": 200,
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ primary sources, carries eighteen mandatory dimensions, and cites every claim.

![License](https://img.shields.io/badge/license-CC%20BY%204.0-blue)
![Families](https://img.shields.io/badge/families-29-informational)
![Entries](https://img.shields.io/badge/entries-92%20published%20%2F%20887%20planned-yellow)
![Entries](https://img.shields.io/badge/entries-95%20published%20%2F%20887%20planned-yellow)
![Dimensions per entry](https://img.shields.io/badge/dimensions%20per%20entry-18-green)
![Citations](https://img.shields.io/badge/citations-verified%20in%20CI-brightgreen)
![Original prose](https://img.shields.io/badge/prose-100%25%20original-brightgreen)
Expand Down Expand Up @@ -90,7 +90,7 @@ README does not claim they are implemented.
| 14 | [Testing](patterns/14-testing/) | Meszaros, xUnit Test Patterns | 0 | 30 | 30 |
| 15 | [Security](patterns/15-security/) | OWASP ASVS | 0 | 38 | 38 |
| 16 | [Functional Programming](patterns/16-functional/) | Category theory in practice | 0 | 40 | 40 |
| 17 | [AI and Agentic](patterns/17-ai-agentic/) | Papers and vendor engineering, 2023 to 2026 | 24 | 31 | 55 |
| 17 | [AI and Agentic](patterns/17-ai-agentic/) | Papers and vendor engineering, 2023 to 2026 | 27 | 28 | 55 |
| 18 | [Anti-Patterns](patterns/18-anti-patterns/) | Brown et al, AntiPatterns | 0 | 53 | 53 |
| 19 | [API and Interface Design](patterns/19-api-design/) | REST, GraphQL, gRPC specifications | 0 | 10 | 10 |
| 20 | [Release and Deployment](patterns/20-release-deployment/) | Humble and Farley | 0 | 10 | 10 |
Expand Down
2 changes: 1 addition & 1 deletion dist/catalogue-status.csv
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ family,name,published,planned,target,percent
14-testing,Testing,0,30,30,0.0
15-security,Security,0,38,38,0.0
16-functional,Functional Programming,0,40,40,0.0
17-ai-agentic,AI and Agentic,24,31,55,43.6
17-ai-agentic,AI and Agentic,27,28,55,49.1
18-anti-patterns,Anti-Patterns,0,53,53,0.0
19-api-design,API and Interface Design,0,10,10,0.0
20-release-deployment,Release and Deployment,0,10,10,0.0
Expand Down
12 changes: 6 additions & 6 deletions dist/catalogue-status.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"generated_by": "tools/gen-catalogue-status.py",
"published_total": 92,
"published_total": 95,
"target_total": 887,
"families_total": 29,
"families_complete": 2,
Expand Down Expand Up @@ -177,14 +177,14 @@
"family": "17-ai-agentic",
"name": "AI and Agentic",
"origin": "Papers and vendor engineering, 2023 to 2026",
"published": 24,
"planned": 31,
"published": 27,
"planned": 28,
"target": 55,
"percent": 43.6,
"percent": 49.1,
"maturity": {
"established": 12,
"established": 13,
"emerging": 5,
"canonical": 7
"canonical": 9
}
},
{
Expand Down
6 changes: 3 additions & 3 deletions docs/PROGRESS.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@
Generated by `tools/gen-catalogue-status.py`. Never hand-edit; CI
checks this file stays current with real repository state.

Published: 92
Published: 95
Target (published plus planned): 887
Completion: 10.4%
Completion: 10.7%
Families: 29
Families complete: 2

Expand All @@ -27,7 +27,7 @@ Families complete: 2
| 14 | Testing | 0 | 30 | 30 | 0.0% |
| 15 | Security | 0 | 38 | 38 | 0.0% |
| 16 | Functional Programming | 0 | 40 | 40 | 0.0% |
| 17 | AI and Agentic | 24 | 31 | 55 | 43.6% |
| 17 | AI and Agentic | 27 | 28 | 55 | 49.1% |
| 18 | Anti-Patterns | 0 | 53 | 53 | 0.0% |
| 19 | API and Interface Design | 0 | 10 | 10 | 0.0% |
| 20 | Release and Deployment | 0 | 10 | 10 | 0.0% |
Expand Down
5 changes: 4 additions & 1 deletion patterns/17-ai-agentic/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Origin. Papers and vendor engineering, 2023 to 2026

24 entries, 204,944 words. Every entry carries all 18
27 entries, 233,147 words. Every entry carries all 18
dimensions from [the entry contract](../../docs/ENTRY-TEMPLATE.md).

## AI Agentic
Expand All @@ -20,6 +20,7 @@ dimensions from [the entry contract](../../docs/ENTRY-TEMPLATE.md).
| [Reranking](reranking.md) | canonical | 7,225 | A reader who has never heard the word reranking has still hit the problem it solves. |
| [Retrieval Augmented Generation](retrieval-augmented-generation.md) | canonical | 8,731 | A large language model's knowledge is frozen at the moment its training data was collected, and its parameters have a fixed, finite capacity that cannot hold every fact a user ... |
| [Self-Consistency](self-consistency.md) | established | 6,441 | A large language model generating a chain-of-thought answer with standard greedy decoding commits to one path through the reasoning space, token by token, and never reconsiders. |
| [Tool Result Caching](tool-result-caching.md) | established | 9,391 | An agent built on a tool-calling loop, the mechanism the Function Calling entry in this family describes, asks a model to decide, turn by turn, whether to answer directly or ... |

## AI and Agentic

Expand All @@ -32,10 +33,12 @@ dimensions from [the entry contract](../../docs/ENTRY-TEMPLATE.md).
| Pattern | Maturity | Words | Intent |
|---|---|---|---|
| [Function Calling](function-calling.md) | canonical | 10,322 | A language model generates text by predicting the next token from everything that came before it in its context window. |
| [Model Context Protocol](model-context-protocol.md) | canonical | 8,173 | Before MCP, every combination of an AI application and an external system needed its own custom integration. |
| [Plan and Execute](plan-execute.md) | canonical | 7,815 | A language model asked to solve a task that takes many steps, and that must call external tools along the way, faces a tension between two failure modes. |
| [ReAct](react.md) | canonical | 7,775 | A language model asked to answer a multi-hop factual question, or to complete a task that spans several tool calls, has two failure modes when it is prompted with only one of the ... |
| [Reflexion](reflexion.md) | emerging | 8,450 | An LLM agent that tries a task once and stops inherits every mistake in that one attempt permanently. |
| [Self-RAG](self-rag.md) | established | 10,532 | A retrieval-augmented language model that always retrieves, for every query, pays the same fixed cost whether the query needs an external source or not. |
| [Structured Output](structured-output.md) | canonical | 10,639 | A program that calls a large language model eventually has to do something with the words that come back. |

## Agentic Workflow

Expand Down
Loading
Loading