iii-hq/iii

소프트웨어 엔지니어링은 서비스 카테고리들을 조립하는 과정입니다. 각 서비스는 고유의 내부 구조, 생명주기 (lifecycle), 통합 방식, 그리고 고유의 장애 모드 (failure modes)를 가집 most니다. 새로운 서비스가 추가될 때마다 발생하는 비용은 이차 함수적으로 증가합니다. 모든 새로운 서비스는 다른 모든 서비스와 잠재적인 통합 지점 (integration points)을 가집니다.

iii는 모든 새로운 추가 사항의 통합 노력을 제로(zero)로 줄임으로써 이러한 통합 수고를 제거합니다. 4개의 워커 (workers)를 설치하든 20개의 워커를 설치하든 정확히 동일합니다. 각 워커는 iii에 등록되는 즉시 다른 모든 워커와 상호작용할 수 있습니다. 그 결과, 시간이 지나며 얼마나 성장하거나 변화하더라도 마치 하나의 애플리케이션처럼 동작하고 손쉽게 구성되는 인프라를 구축할 수 있습니다.

iii는 모든 언어와 모든 런타임 (runtime)을 지원합니다. 엔지니어의 멘탈 모델 (mental model)이 기능마다 변하지 않기 때문에, 신입 엔지니어가 첫날부터 생산성을 낼 수 있게 합니다. 마찬가지로 AI 에이전트 (AI Agents)도 학습해야 할 기본 요소 (primitives)가 하나뿐이고 무엇이 존재하는지에 대한 항상 정확한 단일 진실 공급원 (source of truth)이 있기 때문에, 단일 컨텍스트 윈도우 (context window) 내에서 전체 시스템에 대해 신뢰할 수 있게 추론할 수 있습니다. 에이전트가 소프트웨어를 구축하고 운영하는 작업을 더 많이 수행함에 따라, 작은 기본 요소들이 복리로 작용합니다: 온보딩 (onboard)이 쉬워지고, 프롬프트 (prompt) 비용이 저렴해지며, 확장이 빨라지고, 유지보수가 단순해집니다.

iii의 설계는 분산 소프트웨어를 세 가지 개념으로 압축합니다: 워커 (Worker), 트리거 (Trigger), 함수 (Function). 무언가가 작업을 호스팅하고, 무언가가 작업을 유발하며, 무언가가 작업을 수행합니다.

**워커 (Workers)**는 iii 엔진에 등록한 후 트리거와 함수를 등록하는 프로세스입니다. TypeScript API 서비스는 워커입니다. Python 데이터 파이프라인은 워커입니다. Rust 마이크로서비스 (microservice)는 워커입니다. 어떤 기능이든 몇 줄의 코드만 있으면 워커로 변환될 수 있습니다.

**Triggers (트리거)**는 함수를 실행시키는 모든 것을 의미합니다. 트리거는 함수에 대한 직접적인 호출, HTTP 엔드포인트 (endpoint), cron 스케줄 (cron schedule), 큐 구독 (queue subscription), 상태 변경 (state change), 스트림 이벤트 (stream event) 또는 그 외 무엇이든 될 수 있습니다. 트리거는 선언적 (declarative)입니다. 즉, 워커 (Worker)가 "이 일이 발생하면 이 함수를 실행한다"라고 정의하면, iii가 라우팅 (routing), 직렬화 (serialization) 및 전달 (delivery)을 처리합니다.

**Functions (함수)**는 안정적인 식별자(예: content::classify, orders::validate)를 가진 작업 단위입니다. 함수는 입력을 받고, 작업을 수행하며, 선택적으로 출력을 반환합니다. 함수는 워커 내에 존재합니다.

서비스가 할 수 있는 모든 것을 이 세 가지 프리미티브 (primitives)로 매핑함으로써, iii는 힘들이지 않고도 조합 가능 (composable)하며 완전히 관찰 가능 (observable)한 개발 프로세스를 생성합니다.

iii project init myapp # 프로젝트 스캐폴딩 (scaffold)
cd myapp
iii # 엔진 시작

먼저 iii를 설치해야 하나요? Quickstart 가이드에서 전체 과정을 확인하세요.

언어	패키지	설치
Node.js	iii-sdk	pnpm add iii-sdk 또는 npm install iii-sdk
Python	iii-sdk	pip install iii-sdk
Rust	iii-sdk	Cargo.toml에 추가

당신의 AI 코딩 에이전트 (coding agent)에게 iii에 대한 전체 컨텍스트 (context)를 제공하세요:

npx skillkit add iii-hq/iii/skills

HTTP 엔드포인트, 큐 (queues), cron, 상태 (state), 스트림 (streams), 커스텀 트리거 (custom triggers) 등 모든 iii 프리미티브를 다루는 스킬 (skills)을 제공합니다. Claude Code, Cursor, Gemini CLI, Codex 및 30개 이상의 다른 에이전트와 함께 작동합니다. 전체 목록은 skills/를 참조하세요.

iii-console은 워커, 함수, 트리거, 큐, 트레이스 (traces), 로그 (logs) 및 실시간 상태를 검사하기 위한 개발자 및 운영 콘솔입니다. 설정 및 사용법은 Console 문서를 참조하세요.

디렉토리 (Directory)	설명	README
engine/	iii Engine (Rust) - 핵심 런타임 (core runtime), 모듈 (modules) 및 프로토콜 (protocol)	engine/README.md
sdk/	Node.js, Python 및 Rust용 SDKs	sdk/README.md
console/	개발자 콘솔 (Developer console) (React + Rust)	console/README.md
skills/	AI 코딩 에이전트를 위한 에이전트 스킬 (Agent skills)	skills/README.md
website/	iii 웹사이트	website/
docs/	문서 사이트 (Documentation site) (Mintlify/MDX)	docs/README.md

전체 모노레포 (monorepo) 레이아웃, 의존성 체인 (dependency chain) 및 CI/CD 상세 정보는 STRUCTURE.md를 참조하세요.

단계별 튜토리얼은 Quickstart 가이드를 참조하세요.

iii의 라이선스는 다음과 같습니다:

디렉토리 (Directory)	라이선스 (License)
engine/	Elastic License 2.0
sdk/	Apache License 2.0
console/	Apache License 2.0
docs/	Apache License 2.0
website/	Apache License 2.0

엔진 런타임 (engine runtime)은 Elastic License 2.0 (ELv2)에 따라 라이선스가 부여됩니다. 모든 SDKs, CLI, 콘솔 (console), 문서 (documentation) 및 웹사이트는 Apache License 2.0에 따라 라이선스가 부여됩니다.

추가적인 상세 정보는 CONTRIBUTING.md를 참조하세요.