Agentic Infra Skill

Quick Start

Design use case: "Help me design a customer support agent" → Consult taxonomy.yaml to identify relevant concerns → load the relevant patterns/*.md cards → use templates/adr.md

Review use case: "Review this agentic architecture ADR" → Run scripts/lint_agentic_arch.py <adr.md> → cross-reference findings against checklists/review.md → produce templates/review-report.md

Taxonomy

See taxonomy.yaml for the full concern → patterns mapping across 11 concern areas: reliability , safety , memory , tool-use , orchestration , observability , eval , cost , ux-collaboration , feedback , context-management

Pattern Library — Level 1: PDF-Grounded (21 patterns)

All 21 patterns have full pattern cards in patterns/ . Each card specifies:

• Intent, context, forces/tradeoffs

• Solution with code evidence

• Failure modes and instrumentation

• Related patterns and PDF page citations (p. N)

Pattern File

1 Prompt Chaining patterns/01-prompt-chaining.md

2 Routing patterns/02-routing.md

3 Parallelization patterns/03-parallelization.md

4 Reflection patterns/04-reflection.md

5 Tool Use / Function Calling patterns/05-tool-use.md

6 Planning patterns/06-planning.md

7 Multi-Agent Collaboration patterns/07-multi-agent-collaboration.md

8 Memory Management patterns/08-memory-management.md

9 Learning & Adaptation patterns/09-learning-adaptation.md

10 Model Context Protocol (MCP) patterns/10-mcp.md

11 Goal Setting & Monitoring patterns/11-goal-setting-monitoring.md

12 Exception Handling & Recovery patterns/12-exception-handling-recovery.md

13 Human-in-the-Loop (HITL) patterns/13-hitl.md

14 RAG patterns/14-rag.md

15 A2A Inter-Agent Communication patterns/15-a2a-communication.md

16 Resource-Aware Optimization patterns/16-resource-aware-optimization.md

17 Reasoning Techniques patterns/17-reasoning-techniques.md

18 Guardrails / Safety patterns/18-guardrails-safety.md

19 Evaluation & Monitoring patterns/19-evaluation-monitoring.md

20 Prioritization patterns/20-prioritization.md

21 Exploration & Discovery patterns/21-exploration-discovery.md

Pattern Library — Level 2: Community Pattern Cards (10 patterns)

Individual deep-dive cards for the most unique community patterns not covered by Level 1. Each card follows the same structure as Level 1 cards; citations use Source: awesome-agentic-patterns .

Pattern Category File

22 Context Window Auto-Compaction Context & Memory patterns/22-context-compaction.md

23 Plan-Then-Execute (Security Variant) Orchestration & Control patterns/23-plan-then-execute-secure.md

24 Sub-Agent Spawning Orchestration & Control patterns/24-sub-agent-spawning.md

25 Dual LLM Pattern Orchestration & Control patterns/25-dual-llm.md

26 Spectrum of Control / Blended Initiative UX & Collaboration patterns/26-spectrum-of-control.md

27 Agentic Search Over Tools Tool Use & Environment patterns/27-agentic-search.md

28 RLAIF (RL from AI Feedback) Learning & Adaptation patterns/28-rlaif.md

29 Sandboxed Tool Authorization Security & Safety patterns/29-sandboxed-authorization.md

30 LLM Observability Reliability & Eval patterns/30-llm-observability.md

31 Reflection Loop / Self-Critique Feedback Loops patterns/31-reflection-feedback-loop.md

Community Category Summaries (139 patterns across 8 categories)

Comprehensive summaries of the full awesome-agentic-patterns community library, organized by category. Each summary file covers all patterns in its category with problem/solution descriptions.

Category Patterns File

Context & Memory 17 patterns/community/context-memory.md

Feedback Loops 13 patterns/community/feedback-loops.md

Learning & Adaptation 7 patterns/community/learning-adaptation.md

Orchestration & Control ~40 patterns/community/orchestration-control.md

Reliability & Eval 16 patterns/community/reliability-eval.md

Security & Safety 5 patterns/community/security-safety.md

Tool Use & Environment 24 patterns/community/tool-use-environment.md

UX & Collaboration 15 patterns/community/ux-collaboration.md

Pattern Selection

When choosing patterns, load references/pattern-selection-guide.md for:

• Symptom → pattern lookup (e.g., "agent loops forever" → Pattern 11 + 31)

• Use-case bundles (customer support, coding agent, research, long-horizon, etc.)

• Quick-reference table of all 31 patterns with when-to-use and key constraints

Review Workflow

• Run lint script: python3 scripts/lint_agentic_arch.py <path/to/adr.md>

• Inspect JSON findings (each finding includes: severity , rule , pattern_ref , evidence_page )

• Walk checklists/review.md for any gaps not caught by lint — now covers 76 items across 10 areas including context management, sandboxed execution, and UX/autonomy

• Fill in templates/review-report.md with findings

Design Workflow

• Identify system concerns from taxonomy.yaml

• Load references/pattern-selection-guide.md to select patterns by symptom or use case

• Load the specific pattern cards for those concerns

• Choose patterns considering forces/tradeoffs in each card

• Record decisions in templates/adr.md

• Self-check against checklists/review.md before finalizing

Examples

• Design (PDF patterns): examples/design-example.md — customer support agent using patterns 1–21

• Design (community patterns): examples/community-design-example.md — autonomous coding agent using patterns 22–31

• Review: examples/review-example.md — research pipeline with architectural gaps identified and remediated

Evidence Policy

PDF-grounded patterns (1–21): Every rule cites a PDF page. Format: (p. N) . Never state a rule without citation.

Community patterns (22–31 and community/ summaries): Citations use Source: awesome-agentic-patterns with the category name. These patterns are grounded in community case studies, blog posts, and engineering references rather than the PDF.