대부분의 에이전트 프로젝트는 첫 번째 모델 호출이 어렵기 때문에 실패하는 것이 아닙니다. 프로토타입에 메모리(Memory), 도구(Tools), 평가(Evaluation), 사용자 인터페이스(User Interface), 코딩 에이전트가 탐색할 수 있는 문서(Documentation), 그리고 반복 가능한 리뷰 프로세스(Repeatable review process)가 필요해질 때 어려워집니다.

이것이 바로 오픈 소스 AgentsKit 생태계가 JavaScript 팀들을 위해 해결하고자 하는 문제입니다. 이는 전체 스택을 모두 소유해야 하는 하나의 애플리케이션이라기보다, 공유된 계약(Shared contracts)을 가진 독립적인 프로젝트들의 집합입니다.

6개의 공개 구성 요소

1. AgentsKit: 조합 가능한 기반

AgentsKit는 런타임(Runtimes), 어댑터(Adapters), 도구(Tools), 기술(Skills), 메모리(Memory), RAG, 평가(Evaluation), 관측 가능성(Observability), 샌드박싱(Sandboxing), 그리고 UI 바인딩(UI bindings)을 위한 집중적인 JavaScript 및 TypeScript 패키지를 제공합니다.

핵심 코어는 런타임 의존성(Runtime dependencies)이 전혀 없으며, CI(지속적 통합)를 통해 10 KB gzipped 예산이 강제됩니다. 6개의 공식 계약(Formal contracts)은 어댑터, 도구, 메모리, 리트리버(Retrievers), 기술, 런타임을 교체 가능하게 유지합니다.

API 키 없이 첫 번째 로컬 에이전트를 실행할 수 있습니다:

npm install @agentskit/core @agentskit/runtime tsx

그 다음, 나머지 런타임 구성을 변경하지 않고도 OpenAI, Anthropic, Gemini, Ollama 또는 다른 어댑터를 연결할 수 있습니다.

2. AgentsKit Chat: 하나의 상호작용 모델, 7개의 렌더러

AgentsKit Chat은 대화형 에이전트 경험을 한 번 정의하면 React, React Native, Ink, Vue, Svelte, Solid 또는 Angular를 통해 렌더링합니다.

또한 선택적인 백엔드 호출 전에 결정론적인(Deterministic) 로컬 답변을 지원합니다. 이는 정확한 프로젝트 사실 관계를 위해 LLM(대규모 언어 모델)이 필요하지 않아야 하는 문서 및 지원 인터페이스에서 중요합니다.

pnpm dlx @agentskit/chat-cli@0.4.0 init my-chat --renderer react --yes

3. Registry: 또 다른 의존성이 아닌 재사용 가능한 소스

AgentsKit Registry는 shadcn 스타일 모델로 즉시 사용 가능한 에이전트를 배포합니다. CLI가 소스를 귀하의 프로젝트로 복사하므로, 직접 검사하고 수정할 수 있습니다.

npx agentskit add research
npx agentskit add code-review

현재 공개 카탈로그에는 research, code-review, knowledge-promotion 에이전트가 포함되어 있으며, 기여(contribution)에 열려 있습니다.

4. Agents Playbook: 실행 가능한 엔지니어링 규칙

Agents Playbook은 코딩 에이전트를 위한 엔지니어링 관행을 검사 가능한 패턴(patterns), 프롬프트(prompts), 템플릿(templates), 그리고 의존성 없는 게이트(zero-dependency gates)로 변환합니다.

팀이 에이전트에게 단순히 "프로덕션 품질의 코드를 작성하라"고 말하는 대신, 패키지 경계(package boundaries), 필수 증거(required evidence), 리뷰 규칙(review rules), 그리고 실행 가능한 체크(executable checks)를 정의할 수 있습니다. 이 저장소는 현재 자체 소스로부터 87개의 프로덕션 패턴(production patterns), 6개의 엔지니어링 기둥(engineering pillars), 6개의 SDLC 단계, 그리고 13개의 게이트 스크립트(gate scripts)를 검증합니다.

5. Doc Bridge: 에이전트에게 작업 위치를 알려주기

Doc Bridge는 저장소 문서(repository documentation)와 소유권 맵(ownership maps)을 결정론적인 핸드오프(deterministic handoffs)로 변환합니다:

{
  "startHere": "docs/for-agents/packages/auth.md",
  "editRoots": ["packages/auth"],
...

동일한 핸드오프는 CLI, MCP, 그리고 CI를 통해 사용할 수 있습니다. 핵심 경로는 LLM이나 API 키를 필요로 하지 않습니다.

번들로 제공되는 데모를 실행해 보세요:

npx -y @agentskit/doc-bridge demo --text

6. Code Review CLI: 이미 사용 중인 모델 가져오기

AgentsKit Code Review는 로컬에서 실행하거나 GitHub Action으로 실행할 수 있습니다. 이는 기존의 Codex 및 Claude CLI 로그인, 호스팅된 제공업체(hosted providers), 게이트웨이(gateways), 그리고 로컬 Ollama 모델을 지원합니다.

7개의 리뷰 렌즈(review lenses)가 후보 발견 사항(candidate findings)을 생성합니다. 그 후 독립적인 검증 투표(independent verification votes)를 통해 결과가 개발자에게 도달하기 전 취약한 발견 사항을 제거합니다.

npx --yes github:AgentsKit-io/code-review-cli --provider codex-cli

출력은 Markdown, GitHub 리뷰 댓글(review comments), 또는 SARIF 형식으로 제공될 수 있습니다.

구성 요소의 결합 방식

모든 것을 도입할 필요는 없습니다:

• 조립 가능한 런타임 기능 (runtime capabilities)이 필요할 때는 AgentsKit을 사용하세요.
• 동일한 에이전트 경험을 웹, 네이티브, 터미널 인터페이스 전반에서 실행해야 한다면 Chat을 추가하세요.
• 빈 파일에서 시작하는 것보다 준비된 에이전트가 더 나은 시작점이라면 Registry에서 복사해 오세요.
• 기여 및 품질 규칙을 수립하려면 Playbook을 사용하세요.
• 에이전트에게 결정론적 소유권 (deterministic ownership), 문서화, 검증 경로가 필요할 때는 Doc Bridge를 추가하세요.
• 에이전트가 작성한 변경 사항에 노이즈가 적은 검증 계층 (low-noise verification layer)이 필요할 때는 Code Review를 실행하세요.

각 저장소 (repository)는 독립적으로 사용 가능하며 오픈 소스 라이선스를 따릅니다. 공유된 목표는 상호 운용성 (interoperability)입니다. 즉, 팀은 하나의 패키지로 시작하여 기존 아키텍처를 교체하지 않고도 다른 패키지를 추가할 수 있어야 합니다.

기여가 가장 도움이 되는 부분

이 생태계는 단순한 구현 코드 이상의 것을 찾고 있습니다. 유용한 기여에는 프로바이더 어댑터 (provider adapters), 프레임워크 예시, 재사용 가능한 에이전트, 오탐 (false-positive) 감소, 문서 어댑터 (documentation adapters), 실행 가능한 게이트 (executable gates), 피스처 (fixtures), 그리고 더 명확한 온보딩 (onboarding) 등이 포함됩니다.

만약 이러한 문제 중 하나가 여러분이 이미 하고 있는 작업과 일치한다면, 가장 관련성이 높은 작은 프로젝트부터 시도해 보세요. 무엇이 깔끔하게 결합되지 않았는지 보고하고, 다른 JavaScript 개발자들이 발견하기를 원하는 저장소에 스타 (star)를 누르는 것을 고려해 보세요.

• AgentsKit 탐색하기
• 조직 둘러보기
• Discord 참여하기