Skip to content

Commit 4314cd3

Browse files
committed
Add 21 multilingual agent patterns (214 -> 235)
Crawled 10 language sources (English, Mandarin, German, French, Japanese, Arabic, Spanish, Russian, Korean, Portuguese) for AI agent design patterns published mid-2025 through May 2026 that were not yet in the catalog. New patterns by primary source language: EN (7) — planner-generator-evaluator-harness, initializer-agent, blind-grader-with-isolated-context, mcp-as-code-api, agentic-context-engineering-playbook, world-model-as-tool, sleep-time-compute (Anthropic harness work, ICLR 2026 ACE, arXiv 2504.13171, arXiv 2510.04618, Dyna-Think, Outcomes Cookbook). ZH (3) — chain-of-agents-distillation (OPPO PersonalAI AFM), rumination-agent (Kimi K2 Thinking, GLM-Z1-Rumination, AutoGLM 沉思), clone-fan-out-research (Manus Wide Research). JP (3) — adaptive-branching-tree-search (Sakana TreeQuest), rl-conductor-orchestrator (Sakana Fugu), darwin-godel-self-rewrite (Sakana DGM). AR (2) — madhhab-branching-agent, cultural-alignment-guard (QCRI Fanar 2.0 / Fanar-Sadiq / FanarGuard). FR (3) — policy-localizer-validator (H Company Surfer-H + Holo1), delayed-streams-modeling (Kyutai Moshi/Hibiki), synthetic-filesystem-overlay (Dust.tt). ES (1) — hierarchical-option-pruning (BBVA AI Factory). DE (1) — kritis-auditable-decision-artifact (heise/BSI KRITIS). Cross-lingual (1) — policy-as-code-gate (EN arXiv:2509.23994 + Giskard FR + Microsoft Agent Governance Toolkit + heise/BSI DE). Process: 10 parallel scout agents per language, ~60 raw candidates triaged against existing 214 IDs/aliases/intents; jaccard nearest-neighbour check showed no semantic duplicates; 4 parallel URL-verifier agents fetched all new references and known-uses; replaced 4 generic URLs with specific article slugs (Dust deep-dive, Sakana DGM English, VentureBeat ACE coverage, EU AI Act English variant) and dropped one 404'd CSDN URL. Lint: 0 violations against .github/scripts/lint.py (A1 schema, A3 constraint-first, A4 graph symmetry incl. 96 mirror edges added, A7 prose shape, A8 vocabulary, A9 tone, A15 verification-todo).
1 parent 00fc059 commit 4314cd3

36 files changed

Lines changed: 5394 additions & 2 deletions

INDEX.md

Lines changed: 22 additions & 2 deletions
Large diffs are not rendered by default.

patterns-src/anti-patterns.json

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -614,6 +614,10 @@
614614
{
615615
"pattern": "tool-use",
616616
"relation": "alternative-to"
617+
},
618+
{
619+
"pattern": "synthetic-filesystem-overlay",
620+
"relation": "alternative-to"
617621
}
618622
],
619623
"references": [
@@ -858,6 +862,10 @@
858862
{
859863
"pattern": "degenerate-output-detection",
860864
"relation": "alternative-to"
865+
},
866+
{
867+
"pattern": "blind-grader-with-isolated-context",
868+
"relation": "alternative-to"
861869
}
862870
],
863871
"references": [
@@ -1018,6 +1026,10 @@
10181026
"pattern": "hero-agent",
10191027
"relation": "complements",
10201028
"note": "Two flavours of the same problem: too much in one prompt."
1029+
},
1030+
{
1031+
"pattern": "mcp-as-code-api",
1032+
"relation": "alternative-to"
10211033
}
10221034
],
10231035
"references": [
@@ -1182,6 +1194,10 @@
11821194
{
11831195
"pattern": "stop-hook",
11841196
"relation": "alternative-to"
1197+
},
1198+
{
1199+
"pattern": "rumination-agent",
1200+
"relation": "conflicts-with"
11851201
}
11861202
],
11871203
"references": [
@@ -1266,6 +1282,10 @@
12661282
{
12671283
"pattern": "subagent-isolation",
12681284
"relation": "complements"
1285+
},
1286+
{
1287+
"pattern": "clone-fan-out-research",
1288+
"relation": "conflicts-with"
12691289
}
12701290
],
12711291
"references": [

patterns-src/cognition-introspection.json

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,10 @@
252252
{
253253
"pattern": "episodic-summaries",
254254
"relation": "alternative-to"
255+
},
256+
{
257+
"pattern": "agentic-context-engineering-playbook",
258+
"relation": "complements"
255259
}
256260
],
257261
"references": [
@@ -454,6 +458,10 @@
454458
{
455459
"pattern": "meditation-mode",
456460
"relation": "alternative-to"
461+
},
462+
{
463+
"pattern": "sleep-time-compute",
464+
"relation": "alternative-to"
457465
}
458466
],
459467
"references": [
@@ -1723,6 +1731,10 @@
17231731
{
17241732
"pattern": "vector-memory",
17251733
"relation": "uses"
1734+
},
1735+
{
1736+
"pattern": "chain-of-agents-distillation",
1737+
"relation": "complements"
17261738
}
17271739
],
17281740
"references": [
@@ -1929,6 +1941,10 @@
19291941
{
19301942
"pattern": "quorum-on-mutation",
19311943
"relation": "uses"
1944+
},
1945+
{
1946+
"pattern": "world-model-as-tool",
1947+
"relation": "complements"
19321948
}
19331949
],
19341950
"references": [

patterns-src/governance-observability.json

Lines changed: 153 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,10 @@
5454
{
5555
"pattern": "decision-log",
5656
"relation": "uses"
57+
},
58+
{
59+
"pattern": "blind-grader-with-isolated-context",
60+
"relation": "alternative-to"
5761
}
5862
],
5963
"references": [
@@ -184,6 +188,10 @@
184188
{
185189
"pattern": "partial-output-salvage",
186190
"relation": "complements"
191+
},
192+
{
193+
"pattern": "initializer-agent",
194+
"relation": "complements"
187195
}
188196
],
189197
"references": [
@@ -492,6 +500,10 @@
492500
{
493501
"pattern": "echo-recognition",
494502
"relation": "complements"
503+
},
504+
{
505+
"pattern": "kritis-auditable-decision-artifact",
506+
"relation": "complements"
495507
}
496508
],
497509
"references": [
@@ -602,6 +614,10 @@
602614
{
603615
"pattern": "automatic-workflow-search",
604616
"relation": "complements"
617+
},
618+
{
619+
"pattern": "kritis-auditable-decision-artifact",
620+
"relation": "complements"
605621
}
606622
],
607623
"references": [
@@ -843,6 +859,127 @@
843859
"mermaid": "flowchart TD\n Alert[Alert: kill-switch / sandbox-escape / cost spike] --> Sev{Severity}\n Sev --> OnCall[Page on-call]\n OnCall --> Cont[Containment: kill-switch / reroute]\n Cont --> Pres[Pin traces beyond retention]\n Pres --> Comp[Compensating actions]\n Comp --> Comm[Customer + regulator comms]\n Comm --> PM[Post-mortem]"
844860
}
845861
},
862+
{
863+
"id": "kritis-auditable-decision-artifact",
864+
"name": "KRITIS Auditable Decision Artifact",
865+
"aliases": [
866+
"Run-ID + Modell-Digest + Policy-Hash Triple",
867+
"KRITIS Audit Triple",
868+
"Re-Executable Decision Record",
869+
"AI-Act Article-12 Triple"
870+
],
871+
"category": "governance-observability",
872+
"intent": "For every agent action in regulated or critical-infrastructure contexts, emit a WORM-stored triple of run-id, model-digest, and policy-hash so each decision is independently re-verifiable against the exact code, weights, and policy version that produced it.",
873+
"context": "Agents operating in domains subject to EU AI Act, NIS2, BSI KRITIS, AIC4, or sectoral equivalents, where regulators or internal auditors must be able to replay any individual decision and prove it was produced by a specific, declared version of the model and the policy stack. Generic action logs and reasoning traces do not satisfy this bar because they do not pin the executable artifacts.",
874+
"problem": "An action log says what the agent did. A reasoning trace says what it claimed to be thinking. Neither lets an auditor re-execute the decision against the exact weights and rules that produced it months earlier, by which time the model has been updated and the policy has been revised many times. Regulators of critical infrastructure and other high-risk regimes increasingly require not just observability but re-verifiability: a decision is auditable only if the artifacts that produced it can be reconstructed from the log.",
875+
"forces": [
876+
"Auditors need re-executability, not just observability.",
877+
"Models, policies, and agent code drift on independent release cadences; a decision must pin all three.",
878+
"Storage must be tamper-evident; a mutable log is not an audit artifact.",
879+
"Cryptographic digests must be stable across re-execution; non-deterministic build inputs break replay.",
880+
"Hot-path logging cost must remain bounded; the triple must be compact and computable cheaply.",
881+
"Regulatory references (AI Act Art. 12, NIS2, BSI AIC4) explicitly tie obligations to artifact identity, not narrative summaries."
882+
],
883+
"therefore": "Therefore: for each agent decision, emit and store an immutable triple of (run-id, model-digest, policy-hash) — together with the input fingerprint and the verdict — in a WORM medium, so that the decision can be re-executed against the exact pinned artifacts and an auditor can verify the result.",
884+
"solution": "Establish a build pipeline that computes a content digest over the model weights (and tokenizer, system prompt, scaffolding) and a content hash over the policy bundle. Both digests are published, signed, and retained. At runtime, every agent decision is wrapped to emit a record containing run-id, model-digest, policy-hash, input fingerprint, decision verdict, and timestamp. Records are written to WORM storage (object-lock S3, immutable ledger, append-only DB) under a retention horizon set by the governing regulation. The model and policy artifacts themselves are retained for the same horizon, addressable by their digests, so any record can be replayed against its pinned versions. The triple is cited in user-facing audit responses and in regulator submissions.",
885+
"structure": "Agent decision --> Wrapper --> {run-id, model-digest, policy-hash, input-fingerprint, verdict, ts} --> WORM ledger. Model registry: model-digest --> weights+tokenizer+prompt blob. Policy registry: policy-hash --> rules bundle. Auditor: pick a record --> fetch pinned artifacts by digest --> re-execute --> compare verdict.",
886+
"consequences": {
887+
"benefits": [
888+
"Every decision is re-executable against its pinned artifacts.",
889+
"Tamper-evident storage gives the log evidentiary weight.",
890+
"Maps cleanly onto AI Act Article 12 (record-keeping) and Article 14 (human oversight) obligations and onto BSI AIC4 audit criteria.",
891+
"Cross-version regression analysis becomes possible: compare decisions on the same inputs across model-digest changes."
892+
],
893+
"liabilities": [
894+
"Retaining old weights and policy bundles for the full regulatory horizon is a real storage and security cost.",
895+
"Model non-determinism (sampling, hardware, kernel versions) can break replay unless seeds and inference environments are also pinned.",
896+
"Hot-path emission of the triple adds latency and a hard dependency on the WORM medium.",
897+
"Pinning is necessary but not sufficient: a decision can be 'auditable' and still wrong.",
898+
"Privacy obligations on the input fingerprint require careful design; raw inputs may not be retainable."
899+
]
900+
},
901+
"constrains": "The LLM-driven decision path must not emit an action without producing the (run-id, model-digest, policy-hash) triple, must not write decision records to mutable storage, and must not allow model or policy updates to overwrite the artifacts referenced by retained records.",
902+
"known_uses": [
903+
{
904+
"system": "German KRITIS / regulated-enterprise agent deployments",
905+
"note": "Emerging reference architectures described in heise's Agentic AIOps coverage couple agent action logs with model and policy version pins under BSI/NIS2 obligations.",
906+
"status": "planned",
907+
"url": "https://www.heise.de/hintergrund/Agentic-AIOps-KI-Agenten-in-kritischen-Infrastrukturen-11267508.html"
908+
}
909+
],
910+
"related": [
911+
{
912+
"pattern": "provenance-ledger",
913+
"relation": "specialises",
914+
"note": "Specialises a generic action/audit log by adding the cryptographic pinning of model and policy versions and the WORM retention requirement."
915+
},
916+
{
917+
"pattern": "decision-log",
918+
"relation": "complements",
919+
"note": "A decision log captures reasoning; the KRITIS triple captures the executable identity of model and policy at decision time. Both are needed in regulated contexts."
920+
},
921+
{
922+
"pattern": "model-card",
923+
"relation": "complements",
924+
"note": "A model card documents the model in the abstract; model-digest in the triple identifies the specific deployed instance."
925+
},
926+
{
927+
"pattern": "eval-as-contract",
928+
"relation": "complements",
929+
"note": "Eval-as-contract validates the model against a contract before release; the audit triple proves which validated version actually produced a given decision."
930+
},
931+
{
932+
"pattern": "policy-as-code-gate",
933+
"relation": "uses",
934+
"note": "Policy-as-code naturally produces the policy-hash component of the triple."
935+
}
936+
],
937+
"references": [
938+
{
939+
"type": "blog",
940+
"title": "Agentic AIOps: KI-Agenten in kritischen Infrastrukturen",
941+
"url": "https://www.heise.de/hintergrund/Agentic-AIOps-KI-Agenten-in-kritischen-Infrastrukturen-11267508.html"
942+
},
943+
{
944+
"type": "spec",
945+
"title": "Regulation (EU) 2024/1689 (Artificial Intelligence Act), Articles 12 and 14",
946+
"year": 2024,
947+
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689/oj/eng"
948+
},
949+
{
950+
"type": "spec",
951+
"title": "BSI AIC4 — AI Cloud Service Compliance Criteria Catalogue",
952+
"authors": "Bundesamt für Sicherheit in der Informationstechnik",
953+
"url": "https://www.bsi.bund.de/EN/Themen/Unternehmen-und-Organisationen/Informationen-und-Empfehlungen/Kuenstliche-Intelligenz/AIC4/aic4_node.html"
954+
}
955+
],
956+
"status_in_practice": "emerging",
957+
"tags": [
958+
"governance",
959+
"audit",
960+
"ai-act",
961+
"kritis",
962+
"nis2",
963+
"bsi",
964+
"worm",
965+
"observability",
966+
"re-executability"
967+
],
968+
"applicability": {
969+
"use_when": [
970+
"The deployment is in scope of EU AI Act high-risk, NIS2, BSI KRITIS, AIC4, or analogous regimes.",
971+
"Auditors or regulators have or may acquire the right to replay individual decisions.",
972+
"Model and policy artifacts can be content-addressed and retained for the regulatory horizon.",
973+
"Decisions have material consequences (financial, safety, legal) and a narrative log alone is not enough."
974+
],
975+
"do_not_use_when": [
976+
"The deployment is non-regulated and a standard action log meets the bar.",
977+
"Model artifacts cannot be retained (e.g. third-party API with no version-pinning guarantee) and no equivalent pinning is achievable.",
978+
"Inference is intrinsically non-deterministic and replay cannot be approximated, removing the value of pinning."
979+
]
980+
},
981+
"example_scenario": "A German energy operator runs an agent that helps dispatch grid-balancing actions. Each decision the agent makes is wrapped: the wrapper writes a record with the run-id, the digest of the deployed model weights, the hash of the active policy bundle, a fingerprint of the input situation, and the chosen action, into an immutable object-lock store retained for the regulatory horizon. Six months later BSI auditors pick a specific record, fetch the pinned model and policy by digest from the registry, replay the decision, and confirm the agent's verdict matches what was logged."
982+
},
846983
{
847984
"id": "lineage-tracking",
848985
"name": "Lineage Tracking",
@@ -1003,6 +1140,10 @@
10031140
{
10041141
"pattern": "shadow-canary",
10051142
"relation": "used-by"
1143+
},
1144+
{
1145+
"pattern": "blind-grader-with-isolated-context",
1146+
"relation": "generalises"
10061147
}
10071148
],
10081149
"references": [
@@ -1104,6 +1245,10 @@
11041245
{
11051246
"pattern": "attention-manipulation-explainability",
11061247
"relation": "complements"
1248+
},
1249+
{
1250+
"pattern": "kritis-auditable-decision-artifact",
1251+
"relation": "complements"
11071252
}
11081253
],
11091254
"references": [
@@ -1206,6 +1351,10 @@
12061351
{
12071352
"pattern": "prompt-response-optimiser",
12081353
"relation": "complements"
1354+
},
1355+
{
1356+
"pattern": "agentic-context-engineering-playbook",
1357+
"relation": "complements"
12091358
}
12101359
],
12111360
"references": [
@@ -1336,6 +1485,10 @@
13361485
{
13371486
"pattern": "world-model-separation",
13381487
"relation": "complements"
1488+
},
1489+
{
1490+
"pattern": "kritis-auditable-decision-artifact",
1491+
"relation": "generalises"
13391492
}
13401493
],
13411494
"references": [

0 commit comments

Comments
 (0)