oxbshw/llm-agents-ecosystem-handbook

현대 LLM 에이전트 시스템 구축, 평가, 보안 및 배송을 위한 실용적인 운영 매뉴얼.

---

현대 에이전트는 '프롬프트 + 도구’가 아닙니다. 그들은 시스템 — 신원, 메모리, 기술, 도구, MCP 통합, 가드레일, 관측 가능성, 평가, 그리고 제공자 전략을 갖추고 있습니다. 이 핸드북은 전체 스택을 가르치며, 템플릿, 청사진, 실행 가능한 어댑터, 그리고 오늘 바로 채택할 수 있는 엄선된 예제들을 제공합니다.

이 리포에 뭐가 들어 있을까

7부작으로 구성된 엄선되고 의견이 뚜렷하며 제작 지향적 핸드북:

1. 개념 — 에이전트 운영체제, 신원, 메모리, 기술, MCP, 안전, 관찰 가능성 — 현대 에이전트 스택의 모든 계층
2. 제공자 생태계 — 어댑터 + 문서 제공 **24+ LLM 제공자(프런티어 API, 빠른 추론, 마켓플레이스, 엔터프라이즈 클라우드, 특수 서비스, 로컬 런타임), 백업 체인용 라우터 포함
3. 기술 생태계 — 디자인 가이드, 분류, 성숙도 모델, 보안 체크리스트, 그리고 엄선된 기술 카탈로그
4. 프롬프트 엔지니어링 — 에이전트 프롬프트 패턴, 명령어 계층, 컨텍스트 엔지니어링, 프롬프트-인젝션 방어

---

Modern agents are not “a prompt + a tool.” They are systems — with identity, memory, skills, tools, MCP integrations, guardrails, observability, evals, and a provider strategy. This handbook teaches the whole stack and ships templates, blueprints, runnable adapters, and curated examples you can adopt today.

What’s in this repo

A curated, opinionated, production-oriented handbook in seven parts:

1. Concepts — Agent OS, identity, memory, skills, MCP, safety, observability — every layer of the modern agent stack
2. Provider ecosystem — adapters + docs for 24+ LLM providers (frontier APIs, fast inference, marketplaces, enterprise clouds, specialty, local runtimes), with a router for fallback chains
3. Skills ecosystem — design guide, taxonomy, maturity model, security checklist, and a curated skill catalog
4. Prompt engineering — agent prompt patterns, instruction hierarchy, context engineering, prompt-injection defense
5. Coding-agent workflows — for Claude Code, Cursor, Codex, Aider, Cline, and custom runtimes — repo instructions, prompts, review checklist, safe refactoring
6. Design docs — agent / technical design docs, ADR guide, design reviews, rollout plans, the DESIGN.md machine-readable spec
7. Curated catalog — 100+ existing agent skeletons, framework comparisons, evaluation tools, tutorials — preserved and improved

Who this is for