agentic-ai-systems

ไฝœ่€… ThibautMelenโœ“ ๅทฒ้ชŒ่ฏ

๐Ÿ” Agentic systems explained with chickens โ€” the 2024 taxonomy + the 2026 canon (context engineering, skills, MCP, harnesses). Every pattern as a runnable, CI-checked file. Mermaid everywhere.

284
Stars
32
Forks
2026/8/23
ๆทปๅŠ ๆ—ถ้—ด

โš ๏ธ ็ฌฌไธ‰ๆ–น่ฝฏไปถๅฃฐๆ˜Ž

ๆœฌ Skill ไธบ็ฌฌไธ‰ๆ–นๅผ€ๆบ่ฝฏไปถ๏ผŒ็‹ฌ็ซ‹ๆ‰˜็ฎกไบŽ GitHubใ€‚SkillTip ไป…ไธบไฟกๆฏ็›ฎๅฝ•๏ผŒไธๆŽงๅˆถๆˆ–็ปดๆŠคๅบ•ๅฑ‚ไป“ๅบ“ใ€‚ๆ‰€ๆ˜พ็คบ็š„ๅฎ‰ๅ…จๆฃ€ๆŸฅไธบ่‡ชๅŠจๅŒ–ไธ”่Œƒๅ›ดๆœ‰้™๏ผŒๅฎ‰่ฃ…ๅ‰่ฏท่‡ช่กŒๅฎกๆŸฅๆบ็ ใ€‚

้˜…่ฏปๆœๅŠกๆกๆฌพ

ๅฎ‰่ฃ…

ๆทปๅŠ ๅˆฐไฝ ็š„ Claude Code skills ็›ฎๅฝ•๏ผš

# Add to your Claude Code skills
git clone https://github.com/ThibautMelen/agentic-ai-systems

ๅฟซ้€Ÿๅ…ฅ้—จ

ไฝฟ็”จ agentic-ai-systems ็ญ‰ Skills ็š„ๆŒ‡ๅ—ใ€‚

ๅฎ‰ๅ…จๆŠฅๅ‘Š

ๅทฒ้ชŒ่ฏ

ไธŠๆฌกๆ‰ซๆ๏ผšโ€”

{
  "status": "PASSED",
  "issues": []
}

README.md

Agentic AI Systems ๐Ÿ”

Agentic systems explained with chickens โ€” because AI orchestration doesn't have to be scary

Main Agent spawns Subagents like a hen with her chicks ๐Ÿ”๐Ÿชบ๐Ÿฆ

patterns proven Claude Code Anthropic Research SuperNovae Awesome License PRs Welcome Mermaid

๐Ÿฆ„ Foundations โ€ข โš™๏ธ Workflows โ€ข ๐Ÿ” Autonomous โ€ข ๐Ÿ“œ As Code โ€ข ๐Ÿ› ๏ธ Implementation โ€ข ๐Ÿ—บ๏ธ Guides


Overview

%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#8b5cf6', 'primaryTextColor': '#fff', 'primaryBorderColor': '#7c3aed', 'lineColor': '#a78bfa', 'secondaryColor': '#ec4899', 'tertiaryColor': '#6366f1', 'noteTextColor': '#fff', 'noteBkgColor': '#8b5cf6', 'textColor': '#fff' }}}%%
mindmap
  root((๐Ÿ” Agentic Systems))
    ๐Ÿฆ„ Foundations
      Augmented LLM
      What Changed 2026
    โš™๏ธ Workflows
      ๐ŸŽ๏ธ Baseline
      โ›“๏ธ Chaining
      ๐Ÿšฆ Routing
      ๐Ÿ›ค๏ธ Parallel
      ๐Ÿฆ‘ Orchestrator
      ๐Ÿฉป Evaluator
    ๐Ÿ” Autonomous Agent
      The Alternative
      Multi-Window
    ๐Ÿ› ๏ธ Implementation
      ๐Ÿฆ Subagent
      ๐Ÿฆด Command
      ๐Ÿ“š Skill
      ๐Ÿช Hook
    ๐Ÿ“œ Patterns as Code
      Check before
      Trace after

[!TIP] New in the 2026 edition โ€” ๐Ÿ—ž๏ธ What Changed 2025-2026 (the dated map: context engineering, the multi-agent debate, the AGENTS.md ยท SKILL.md ยท MCP stack, harness engineering) and ๐Ÿ“œ Patterns as Code (every pattern as a runnable file โ€” checked in CI on every push, no API key needed).

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

โฌ†๏ธ real capture: a repeated prompt graduates into a checked, runnable file โ€” every pattern in this repo works this way ยท and three of them run a real campaign daily ๐Ÿ›ฐ๏ธ

๐Ÿ—บ๏ธ Navigation

๐Ÿฆ„ Foundations

The building block for everything

๐Ÿฆ„ Augmented LLMLLM + Retrieval + Tools + Memory
๐Ÿ—ž๏ธ What Changed 2025-2026Context engineering ยท skills/MCP stack ยท harness era

โš™๏ธ Workflows

Predefined orchestration โ€” code controls the flow

#WorkflowUse When
0๐ŸŽ๏ธ BaselineSimple, 1-step task
1โ›“๏ธ Prompt ChainingSequential steps
2๐Ÿšฆ RoutingClassify & dispatch
3๐Ÿ›ค๏ธ ParallelizationIndependent tasks
4๐Ÿฆ‘ OrchestratorExpert delegation
5๐Ÿฉป EvaluatorQuality iteration

๐Ÿ” Autonomous Agent

Dynamic autonomy โ€” LLM controls the flow

PatternUse When
๐Ÿ” Autonomous AgentOpen-ended problems
๐Ÿ–ฅ๏ธ Multi-WindowCross-session state (variant)

๐Ÿ› ๏ธ Implementation

Claude Code components & architecture

ComponentLocation
๐Ÿฆ Subagent.claude/agents/*.md
๐Ÿฆด Command.claude/commands/*.md
๐Ÿ“š Skill.claude/skills/*/SKILL.md
๐Ÿช Hook.claude/settings.json

๐Ÿ—บ๏ธ Guides & ๐Ÿ“– Reference

ResourceDescription
Selection GuideChoose the right pattern
๐Ÿ“œ Patterns as CodeEvery pattern as a runnable, checkable file
Use Cases6 validated examples
GlossaryA-Z definitions
Visual StandardsColors & emojis

Quick Decision

%%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
flowchart LR
    START((๐ŸŽฏ Task)) --> DEST{Destructive?}
    DEST -->|Yes| WIZ[๐Ÿง™ Wizard]
    DEST -->|No| COMP{Complex?}
    COMP -->|No| BASE[๐ŸŽ๏ธ Baseline]
    COMP -->|Yes| PRED{Predictable<br/>steps?}
    PRED -->|Yes| WORK{Need<br/>specialists?}
    PRED -->|No| AGENT[๐Ÿ” Autonomous]
    WORK -->|No| CHAIN[โ›“๏ธ Chain]
    WORK -->|Yes| ORCH[๐Ÿฆ‘ Orchestrator]

    classDef default fill:#f8fafc,stroke:#64748b,stroke-width:1px,color:#1e293b
    classDef decision fill:#fef3c7,stroke:#f59e0b,stroke-width:2px,color:#92400e
    classDef baseline fill:#64748b,stroke:#475569,stroke-width:2px,color:#ffffff
    classDef wizard fill:#14b8a6,stroke:#0d9488,stroke-width:2px,color:#ffffff
    classDef workflow fill:#8b5cf6,stroke:#7c3aed,stroke-width:2px,color:#ffffff
    classDef agent fill:#ec4899,stroke:#db2777,stroke-width:2px,color:#ffffff

    START:::decision
    DEST:::decision
    COMP:::decision
    PRED:::decision
    WORK:::decision
    BASE:::baseline
    WIZ:::wizard
    CHAIN:::workflow
    ORCH:::workflow
    AGENT:::agent
Situationโ†’ Use
Simple task (1 step)๐ŸŽ๏ธ Baseline
Sequential (2-4 steps)โ›“๏ธ Prompt Chaining
Categorize inputs๐Ÿšฆ Routing
Independent subtasks๐Ÿ›ค๏ธ Parallelization
Multiple specialists๐Ÿฆ‘ Orchestrator-Workers
Quality iteration๐Ÿฉป Evaluator-Optimizer
Open-ended / unknown steps๐Ÿ” Autonomous Agent
Destructive operations๐Ÿง™ Wizard
Long-running (>10 min)๐Ÿ–ฅ๏ธ Multi-Window Context

Anthropic Taxonomy

%%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
flowchart LR
    subgraph WORKFLOWS["โš™๏ธ WORKFLOWS"]
        direction TB
        W1[๐ŸŽ๏ธ Baseline]
        W2[โ›“๏ธ Prompt Chaining]
        W3[๐Ÿšฆ Routing]
        W4[๐Ÿ›ค๏ธ Parallelization]
        W5[๐Ÿฆ‘ Orchestrator]
        W6[๐Ÿฉป Evaluator]
    end

    subgraph AGENTS["๐Ÿ” AUTONOMOUS AGENT"]
        direction TB
        A1[๐Ÿ” The Alternative]
        A2[๐Ÿ–ฅ๏ธ Multi-Window variant]
    end

    CODE[๐Ÿ“ Code controls] --> WORKFLOWS
    WORKFLOWS --> LLM[๐Ÿง  LLM controls]
    LLM --> AGENTS

    classDef workflowBox fill:#ede9fe,stroke:#8b5cf6,stroke-width:2px,color:#5b21b6
    classDef agentBox fill:#fce7f3,stroke:#ec4899,stroke-width:2px,color:#9d174d
    classDef control fill:#f1f5f9,stroke:#64748b,stroke-width:1px,color:#475569

    WORKFLOWS:::workflowBox
    AGENTS:::agentBox
    CODE:::control
    LLM:::control

Key distinction: Workflows have predefined paths (code controls). Agents decide their own path (LLM controls).


Critical Rule

%%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
flowchart LR
    U1[๐Ÿ™‹โ€โ™€๏ธ User] -->|request| MA[๐Ÿ” Main Agent]
    MA -->|๐Ÿชบ spawn| SA1[๐Ÿฆ Subagent]
    MA -->|๐Ÿชบ spawn| SA2[๐Ÿฆ Subagent]
    SA1 -->|result| MA
    SA2 -->|result| MA
    MA -->|response| U2[๐Ÿ’โ€โ™€๏ธ User]

    SA1 x--x|"โŒ CANNOT spawn"| SA3[๐Ÿฆ]

    classDef user fill:#6366f1,stroke:#4f46e5,stroke-width:2px,color:#ffffff
    classDef main fill:#f59e0b,stroke:#d97706,stroke-width:2px,color:#ffffff
    classDef sub fill:#ec4899,stroke:#db2777,stroke-width:2px,color:#ffffff
    classDef blocked fill:#ef4444,stroke:#dc2626,stroke-width:2px,color:#ffffff,stroke-dasharray: 5 5

    U1:::user
    U2:::user
    MA:::main
    SA1:::sub
    SA2:::sub
    SA3:::blocked

๐Ÿฆ Subagents cannot spawn other ๐Ÿฆ subagents. All delegation flows through ๐Ÿ” Main Agent.


Repository Structure

.
โ”œโ”€โ”€ README.md                      # ๐Ÿ  You are here
โ”‚
โ”œโ”€โ”€ foundations/                   # ๐Ÿฆ„ Core concepts
โ”‚   โ””โ”€โ”€ augmented-llm.md
โ”‚
โ”œโ”€โ”€ workflows/                     # โš™๏ธ Predefined orchestration
โ”‚   โ”œโ”€โ”€ 00-baseline.md
โ”‚   โ”œโ”€โ”€ 01-prompt-chaining.md
โ”‚   โ”œโ”€โ”€ 02-routing.md
โ”‚   โ”œโ”€โ”€ 03-parallelization.md
โ”‚   โ”œโ”€โ”€ 04-orchestrator-workers.md
โ”‚   โ””โ”€โ”€ 05-evaluator-optimizer.md
โ”‚
โ”œโ”€โ”€ agents/                        # ๐Ÿ” Autonomous Agent (the alternative)
โ”‚   โ”œโ”€โ”€ autonomous.md              # The pattern
โ”‚   โ””โ”€โ”€ multi-window.md            # Variant
โ”‚
โ”œโ”€โ”€ implementation/                # ๐Ÿ› ๏ธ Claude Code specifics
โ”‚   โ”œโ”€โ”€ components/                # ๐Ÿฆ๐Ÿฆด๐Ÿ“š๐Ÿช
โ”‚   โ””โ”€โ”€ architecture/              # 5-layer system
โ”‚
โ”œโ”€โ”€ guides/                        # ๐Ÿ—บ๏ธ Selection & use cases
โ”‚   โ””โ”€โ”€ use-cases/                 # 6 validated examples
โ”‚
โ””โ”€โ”€ reference/                     # ๐Ÿ“– Glossary, standards

References

ResourceLink
Building Effective Agentsanthropic.com/engineering
Claude Code Docsdocs.anthropic.com
Agent SDKdocs.anthropic.com/agent-sdk
Anthropic Cookbookgithub.com/anthropics
Agent Skills specagentskills.io
Agentic AI Foundation (MCP ยท AGENTS.md ยท goose)aaif.io
Patterns as runnable files (this repo)patterns-as-code/

Contributing

Contributions welcome! See CONTRIBUTING.md.

Requirements: Official sources โ€ข Code examples โ€ข Mermaid diagrams โ€ข Established format


Built with Claude Code | Based on Anthropic documentation | 2025-2026
Independent community resource โ€” not affiliated with Anthropic


ThibautMelen ย โค๏ธย  SuperNovae Studio ย ๐Ÿดโ€โ˜ ๏ธ

ๅธธ่ง้—ฎ้ข˜

What is agentic-ai-systems?โŒ„

agentic-ai-systems is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ThibautMelen. ๐Ÿ” Agentic systems explained with chickens โ€” the 2024 taxonomy + the 2026 canon (context engineering, skills, MCP, harnesses). Every pattern as a runnable, CI-checked file. Mermaid everywhere. It has 284 GitHub stars.

Is agentic-ai-systems safe to use?โŒ„

Yes. agentic-ai-systems passed SkillsLLM's automated security scan โ€” a dependency vulnerability audit plus prompt-injection heuristics โ€” with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install agentic-ai-systems?โŒ„

Clone the repository with "git clone https://github.com/ThibautMelen/agentic-ai-systems" and add it to your Claude Code skills directory (see the Installation section above).

Are there alternatives to agentic-ai-systems?โŒ„

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh agentic-ai-systems against similar tools.

่ฏ„่ฎบ (0)

ๆš‚ๆ— ่ฏ„่ฎบ๏ผŒๆˆไธบ็ฌฌไธ€ไธชๅˆ†ไบซๆƒณๆณ•็š„ไบบ๏ผ

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

โญ 242,219โ‘‚ 36,702JavaScript
AI ๆ™บ่ƒฝไฝ“ai-agentsanthropicclaude-code
ๆŸฅ็œ‹่ฏฆๆƒ… โ†’

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

โญ 185,940โ‘‚ 28,768JavaScript
AI ๆ™บ่ƒฝไฝ“ai-agentsanthropicclaude-code
ๆŸฅ็œ‹่ฏฆๆƒ… โ†’

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

โญ 128,868โ‘‚ 8,826Rust
AI ๆ™บ่ƒฝไฝ“claude-codeai-tools
ๆŸฅ็œ‹่ฏฆๆƒ… โ†’

claude-code

by anthropics

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

โญ 120,031โ‘‚ 19,897Shell
AI ๆ™บ่ƒฝไฝ“
ๆŸฅ็œ‹่ฏฆๆƒ… โ†’

ๅผ€ๅ‘่€…่ฟ˜ๅ–œๆฌข

ๅŸบไบŽๅ–œๆฌขๆญค Skill ็š„ๅผ€ๅ‘่€…ๆŠ•็ฅจๅ’Œๆ”ถ่—

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

โญ 242,219โ‘‚ 36,702JavaScript
AI ๆ™บ่ƒฝไฝ“ai-agentsanthropicclaude-code
ๆŸฅ็œ‹่ฏฆๆƒ… โ†’

n8n

by n8n-io

12

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

โญ 201,881โ‘‚ 60,308TypeScript
MCP ๆœๅŠกๅ™จapisai-tools
ๆŸฅ็œ‹่ฏฆๆƒ… โ†’

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

โญ 185,940โ‘‚ 28,768JavaScript
AI ๆ™บ่ƒฝไฝ“ai-agentsanthropicclaude-code
ๆŸฅ็œ‹่ฏฆๆƒ… โ†’

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

โญ 128,868โ‘‚ 8,826Rust
AI ๆ™บ่ƒฝไฝ“claude-codeai-tools
ๆŸฅ็œ‹่ฏฆๆƒ… โ†’