Skip to content
Back to search

agentic-ai-systems

Agentic AI explained with chickens πŸ” every pattern a runnable, CI-checked file.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/thibautmelen--agentic-ai-systems/badge.svg)](/listings/thibautmelen--agentic-ai-systems)

HTML

<a href="/listings/thibautmelen--agentic-ai-systems"><img src="/api/listings/thibautmelen--agentic-ai-systems/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 321 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # Agentic AI Systems πŸ”
  3. **Agentic systems explained with chickens β€” because AI orchestration doesn't have to be scary**
  4. *Main Agent spawns Subagents like a hen with her chicks πŸ”πŸͺΊπŸ¦*
  5. [![patterns proven](https://github.com/ThibautMelen/agentic-ai-systems/actions/workflows/check.yml/badge.svg)](https://github.com/ThibautMelen/agentic-ai-systems/actions/workflows/check.yml)
  6. [![Claude Code](https://img.shields.io/badge/Claude_Code-CLI-8b5cf6?style=flat-square&logo=anthropic&logoColor=white)](https://docs.anthropic.com/en/docs/claude-code)
  7. [![Anthropic Research](https://img.shields.io/badge/Anthropic-Research-ec4899?style=flat-square&logo=anthropic&logoColor=white)](https://www.anthropic.com/research/building-effective-agents)
  8. [![SuperNovae](https://img.shields.io/badge/SuperNovae-Studio-ff6b35?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyTDkgOUwyIDEyTDkgMTVMMTIgMjJMMTUgMTVMMjIgMTJMMTUgOVoiLz48L3N2Zz4=)](https://github.com/SuperNovae-studio)
  9. [![Awesome](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/hesreallyhim/awesome-claude-code)
  10. [![License](https://img.shields.io/badge/License-MIT-10b981?style=flat-square)](LICENSE)
  11. [![PRs Welcome](https://img.shields.io/badge/PRs-Welcome-06b6d4?style=flat-square)](CONTRIBUTING.md)
  12. [![Mermaid](https://img.shields.io/badge/Mermaid-Diagrams-f59e0b?style=flat-square&logo=mermaid&logoColor=white)](https://mermaid.js.org/)
  13. [πŸ¦„ Foundations](foundations/) β€’ [βš™οΈ Workflows](workflows/) β€’ [πŸ” Autonomous](agents/) β€’ [πŸ“œ As Code](patterns-as-code/) β€’ [πŸ› οΈ Implementation](implementation/) β€’ [πŸ—ΊοΈ Guides](guides/)
  14. </div>
  15. ---
  16. ## Overview
  17. ```mermaid
  18. %%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#8b5cf6', 'primaryTextColor': '#fff', 'primaryBorderColor': '#7c3aed', 'lineColor': '#a78bfa', 'secondaryColor': '#ec4899', 'tertiaryColor': '#6366f1', 'noteTextColor': '#fff', 'noteBkgColor': '#8b5cf6', 'textColor': '#fff' }}}%%
  19. mindmap
  20. root((πŸ” Agentic Systems))
  21. πŸ¦„ Foundations
  22. Augmented LLM
  23. What Changed 2026
  24. βš™οΈ Workflows
  25. 🏎️ Baseline
  26. ⛓️ Chaining
  27. 🚦 Routing
  28. πŸ›€οΈ Parallel
  29. πŸ¦‘ Orchestrator
  30. 🩻 Evaluator
  31. πŸ” Autonomous Agent
  32. The Alternative
  33. Multi-Window
  34. πŸ› οΈ Implementation
  35. 🐦 Subagent
  36. 🦴 Command
  37. πŸ“š Skill
  38. πŸͺ Hook
  39. πŸ“œ Patterns as Code
  40. Check before
  41. Trace after
  42. ```
  43. ---
  44. > [!TIP]
  45. > **New in the 2026 edition** β€” [πŸ—žοΈ What Changed 2025-2026](foundations/what-changed-2026.md) (the dated map: context engineering, the multi-agent debate, the AGENTS.md Β· SKILL.md Β· MCP stack, harness engineering) and [πŸ“œ Patterns as Code](patterns-as-code/) (every pattern as a runnable file β€” checked in CI on every push, no API key needed).
  46. <p align="center">
  47. <a href="patterns-as-code/"><img src="https://raw.githubusercontent.com/supernovae-st/nika/main/media/gifs/chat-to-workflow.optimized.gif" alt="A repeated chat prompt becomes a workflow file; checked before a token is spent, then a real local run β€” the patterns in this repo, as runnable files" width="850"></a>
  48. </p>
  49. <p align="center"><sub>⬆️ real capture: a repeated prompt graduates into a checked, runnable file β€” <a href="patterns-as-code/">every pattern in this repo works this way</a> Β· and <a href="patterns-as-code/real-world/">three of them run a real campaign daily</a> πŸ›°οΈ</sub></p>
  50. ## πŸ—ΊοΈ Navigation
  51. <table>
  52. <tr>
  53. <td width="50%" valign="top">
  54. ### πŸ¦„ [Foundations](foundations/)
  55. *The building block for everything*
  56. | | |
  57. |---|---|
  58. | [πŸ¦„ Augmented LLM](foundations/augmented-llm.md) | LLM + Retrieval + Tools + Memory |
  59. | [πŸ—žοΈ What Changed 2025-2026](foundations/what-changed-2026.md) | Context engineering Β· skills/MCP stack Β· harness era |
  60. ---
  61. ### βš™οΈ [Workflows](workflows/)
  62. *Predefined orchestration β€” code controls the flow*
  63. | # | Workflow | Use When |
  64. |:-:|----------|----------|
  65. | 0 | [🏎️ Baseline](workflows/00-baseline.md) | Simple, 1-step task |
  66. | 1 | [⛓️ Prompt Chaining](workflows/01-prompt-chaining.md) | Sequential steps |
  67. | 2 | [🚦 Routing](workflows/02-routing.md) | Classify & dispatch |
  68. | 3 | [πŸ›€οΈ Parallelization](workflows/03-parallelization.md) | Independent tasks |
  69. | 4 | [πŸ¦‘ Orchestrator](workflows/04-orchestrator-workers.md) | Expert delegation |
  70. | 5 | [🩻 Evaluator](workflows/05-evaluator-optimizer.md) | Quality iteration |
  71. </td>
  72. <td width="50%" valign="top">
  73. ### πŸ” [Autonomous Agent](agents/)
  74. *Dynamic autonomy β€” LLM controls the flow*
  75. | Pattern | Use When |
  76. |---------|----------|
  77. | [πŸ” Autonomous Agent](agents/autonomous.md) | Open-ended problems |
  78. | [πŸ–₯️ Multi-Window](agents/multi-window.md) | Cross-session state (variant) |
  79. ---
  80. ### πŸ› οΈ [Implementation](implementation/)
  81. *Claude Code components & architecture*
  82. | Component | Location |
  83. |-----------|----------|
  84. | [🐦 Subagent](implementation/components/subagent.md) | `.claude/agents/*.md` |
  85. | [🦴 Command](implementation/components/slash-command.md) | `.claude/commands/*.md` |
  86. | [πŸ“š Skill](implementation/components/skill.md) | `.claude/skills/*/SKILL.md` |
  87. | [πŸͺ Hook](implementation/components/hook.md) | `.claude/settings.json` |
  88. ---
  89. ### πŸ—ΊοΈ [Guides](guides/) & [πŸ“– Reference](reference/)
  90. | Resource | Description |
  91. |----------|-------------|
  92. | [Selection Guide](guides/README.md) | Choose the right pattern |
  93. | [πŸ“œ Patterns as Code](patterns-as-code/) | Every pattern as a runnable, checkable file |
  94. | [Use Cases](guides/use-cases/) | 6 validated examples |
  95. | [Glossary](reference/glossary.md) | A-Z definitions |
  96. | [Visual Standards](reference/visual-standards.md) | Colors & emojis |
  97. </td>
  98. </tr>
  99. </table>
  100. ---
  101. ## Quick Decision
  102. ```mermaid
  103. %%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
  104. flowchart LR
  105. START((🎯 Task)) --> DEST{Destructive?}
  106. DEST -->|Yes| WIZ[πŸ§™ Wizard]
  107. DEST -->|No| COMP{Complex?}
  108. COMP -->|No| BASE[🏎️ Baseline]
  109. COMP -->|Yes| PRED{Predictable<br/>steps?}
  110. PRED -->|Yes| WORK{Need<br/>specialists?}
  111. PRED -->|No| AGENT[πŸ” Autonomous]
  112. WORK -->|No| CHAIN[⛓️ Chain]
  113. WORK -->|Yes| ORCH[πŸ¦‘ Orchestrator]
  114. classDef default fill:#f8fafc,stroke:#64748b,stroke-width:1px,color:#1e293b
  115. classDef decision fill:#fef3c7,stroke:#f59e0b,stroke-width:2px,color:#92400e
  116. classDef baseline fill:#64748b,stroke:#475569,stroke-width:2px,color:#ffffff
  117. classDef wizard fill:#14b8a6,stroke:#0d9488,stroke-width:2px,color:#ffffff
  118. classDef workflow fill:#8b5cf6,stroke:#7c3aed,stroke-width:2px,color:#ffffff
  119. classDef agent fill:#ec4899,stroke:#db2777,stroke-width:2px,color:#ffffff
  120. START:::decision
  121. DEST:::decision
  122. COMP:::decision
  123. PRED:::decision
  124. WORK:::decision
  125. BASE:::baseline
  126. WIZ:::wizard
  127. CHAIN:::workflow
  128. ORCH:::workflow
  129. AGENT:::agent
  130. ```
  131. | Situation | β†’ Use |
  132. |-----------|-------|
  133. | Simple task (1 step) | [🏎️ Baseline](workflows/00-baseline.md) |
  134. | Sequential (2-4 steps) | [⛓️ Prompt Chaining](workflows/01-prompt-chaining.md) |
  135. | Categorize inputs | [🚦 Routing](workflows/02-routing.md) |
  136. | Independent subtasks | [πŸ›€οΈ Parallelization](workflows/03-parallelization.md) |
  137. | Multiple specialists | [πŸ¦‘ Orchestrator-Workers](workflows/04-orchestrator-workers.md) |
  138. | Quality iteration | [🩻 Evaluator-Optimizer](workflows/05-evaluator-optimizer.md) |
  139. | Open-ended / unknown steps | [πŸ” Autonomous Agent](agents/autonomous.md) |
  140. | Destructive operations | [πŸ§™ Wizard](workflows/01-prompt-chaining.md#advanced-wizard-pattern) |
  141. | Long-running (>10 min) | [πŸ–₯️ Multi-Window Context](agents/multi-window.md) |
  142. ---
  143. ## Anthropic Taxonomy
  144. ```mermaid
  145. %%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
  146. flowchart LR
  147. subgraph WORKFLOWS["βš™οΈ WORKFLOWS"]
  148. direction TB
  149. W1[🏎️ Baseline]
  150. W2[⛓️ Prompt Chaining]
  151. W3[🚦 Routing]
  152. W4[πŸ›€οΈ Parallelization]
  153. W5[πŸ¦‘ Orchestrator]
  154. W6[🩻 Evaluator]
  155. end
  156. subgraph AGENTS["πŸ” AUTONOMOUS AGENT"]
  157. direction TB
  158. A1[πŸ” The Alternative]
  159. A2[πŸ–₯️ Multi-Window variant]
  160. end
  161. CODE[πŸ“ Code controls] --> WORKFLOWS
  162. WORKFLOWS --> LLM[🧠 LLM controls]
  163. LLM --> AGENTS
  164. classDef workflowBox fill:#ede9fe,stroke:#8b5cf6,stroke-width:2px,color:#5b21b6
  165. classDef agentBox fill:#fce7f3,stroke:#ec4899,stroke-width:2px,color:#9d174d
  166. classDef control fill:#f1f5f9,stroke:#64748b,stroke-width:1px,color:#475569
  167. WORKFLOWS:::workflowBox
  168. AGENTS:::agentBox
  169. CODE:::control
  170. LLM:::control
  171. ```
  172. > **Key distinction:** Workflows have predefined paths (code controls). Agents decide their own path (LLM controls).
  173. ---
  174. ## Critical Rule
  175. ```mermaid
  176. %%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
  177. flowchart LR
  178. U1[πŸ™‹β€β™€οΈ User] -->|request| MA[πŸ” Main Agent]
  179. MA -->|πŸͺΊ spawn| SA1[🐦 Subagent]
  180. MA -->|πŸͺΊ spawn| SA2[🐦 Subagent]
  181. SA1 -->|result| MA
  182. SA2 -->|result| MA
  183. MA -->|response| U2[πŸ’β€β™€οΈ User]
  184. SA1 x--x|"❌ CANNOT spawn"| SA3[🐦]
  185. classDef user fill:#6366f1,stroke:#4f46e5,stroke-width:2px,color:#ffffff
  186. classDef main fill:#f59e0b,stroke:#d97706,stroke-width:2px,color:#ffffff
  187. classDef sub fill:#ec4899,stroke:#db2777,stroke-width:2px,color:#ffffff
  188. classDef blocked fill:#ef4444,stroke:#dc2626,stroke-width:2px,color:#ffffff,stroke-dasharray: 5 5
  189. U1:::user
  190. U2:::user
  191. MA:::main
  192. SA1:::sub
  193. SA2:::sub
  194. SA3:::blocked
  195. ```
  196. > **🐦 Subagents cannot spawn other 🐦 subagents.** All delegation flows through πŸ” Main Agent.
  197. ---
  198. ## Repository Structure
  199. ```
  200. .
  201. β”œβ”€β”€ README.md # 🏠 You are here
  202. β”‚
  203. β”œβ”€β”€ foundations/ # πŸ¦„ Core concepts
  204. β”‚ └── augmented-llm.md
  205. β”‚
  206. β”œβ”€β”€ workflows/ # βš™οΈ Predefined orchestration
  207. β”‚ β”œβ”€β”€ 00-baseline.md
  208. β”‚ β”œβ”€β”€ 01-prompt-chaining.md
  209. β”‚ β”œβ”€β”€ 02-routing.md
  210. β”‚ β”œβ”€β”€ 03-parallelization.md
  211. β”‚ β”œβ”€β”€ 04-orchestrator-workers.md
  212. β”‚ └── 05-evaluator-optimizer.md
  213. β”‚
  214. β”œβ”€β”€ agents/ # πŸ” Autonomous Agent (the alternative)
  215. β”‚ β”œβ”€β”€ autonomous.md # The pattern
  216. β”‚ └── multi-window.md # Variant
  217. β”‚
  218. β”œβ”€β”€ implementation/ # πŸ› οΈ Claude Code specifics
  219. β”‚ β”œβ”€β”€ components/ # πŸ¦πŸ¦΄πŸ“šπŸͺ
  220. β”‚ └── architecture/ # 5-layer system
  221. β”‚
  222. β”œβ”€β”€ guides/ # πŸ—ΊοΈ Selection & use cases
  223. β”‚ └── use-cases/ # 6 validated examples
  224. β”‚
  225. └── reference/ # πŸ“– Glossary, standards
  226. ```
  227. ---
  228. ## References
  229. | Resource | Link |
  230. |----------|------|
  231. | Building Effective Agents | [anthropic.com/engineering](https://www.anthropic.com/engineering/building-effective-agents) |
  232. | Claude Code Docs | [docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code) |
  233. | Agent SDK | [docs.anthropic.com/agent-sdk](https://docs.anthropic.com/docs/en/agent-sdk) |
  234. | Anthropic Cookbook | [github.com/anthropics](https://github.com/anthropics/anthropic-cookbook) |
  235. | Agent Skills spec | [agentskills.io](https://agentskills.io/specification) |
  236. | Agentic AI Foundation (MCP Β· AGENTS.md Β· goose) | [aaif.io](https://aaif.io/) |
  237. | Patterns as runnable files (this repo) | [patterns-as-code/](patterns-as-code/) |
  238. ---
  239. ## Contributing
  240. Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
  241. **Requirements:** Official sources β€’ Code examples β€’ Mermaid diagrams β€’ Established format
  242. ---
  243. <div align="center">
  244. <sub>Built with Claude Code | Based on Anthropic documentation | 2025-2026</sub><br/>
  245. <sub>Independent community resource β€” not affiliated with Anthropic</sub>
  246. <br/>
  247. <a href="https://github.com/ThibautMelen">
  248. <img src="https://avatars.githubusercontent.com/u/20891897?s=200&v=4" alt="ThibautMelen" width="32"/>
  249. </a>
  250. &nbsp;❀️&nbsp;
  251. <a href="https://github.com/SuperNovae-studio">
  252. <img src="https://avatars.githubusercontent.com/u/33066282?s=200&v=4" alt="SuperNovae Studio" width="32"/>
  253. </a>
  254. &nbsp;πŸ΄β€β˜ οΈ
  255. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.