Agent Tool

AI 에이전트의 태스크를
체계적으로 오케스트레이션

taskai는 의존성 그래프, 상태 머신, 원자적 claim으로 AI 에이전트가 복잡한 작업을 정확한 순서로 실행하도록 오케스트레이션하는 오픈소스 CLI입니다.

시작하기 GitHub
Problem

AI 에이전트의 태스크 관리 문제

AI 에이전트가 복잡한 작업을 수행할 때, 태스크 간의 의존성과 상태를 체계적으로 관리하지 못하면 전체 작업이 실패하거나 비효율적으로 실행됩니다.

순서 없는 실행 — 의존성을 무시하고 태스크를 실행하여 선행 조건이 충족되지 않은 채 작업이 진행됩니다.
상태 추적 불가 — 태스크의 진행 상태를 알 수 없어 실패 시 복구가 어렵습니다.
병렬 처리 부재 — 독립적인 태스크도 순차적으로 실행하여 전체 처리 시간이 불필요하게 늘어납니다.
문서 부재 — 설계 의도와 컨텍스트가 전달되지 않아 에이전트가 잘못된 방향으로 작업합니다.
blocked
→
ready
→
in_progress
→
done
Dependency Graph
setup-db → create-schema → seed-data
setup-db → build-api
create-schema → write-tests
의존성 그래프 구축
태스크 간 선후 관계를 DAG로 정의하고 사이클을 자동 검증합니다.
$ taskai plan load plan.json
# 5 tasks loaded, 0 cycles detected
# 2 tasks ready to start
상태 머신 관리
blocked → ready → in_progress → done 라이프사이클을 정밀하게 추적합니다.
$ taskai task status setup-db
Status: done
# → create-schema, build-api now ready
원자적 Claim
next --claim으로 에이전트가 다음 태스크를 원자적으로 할당받습니다.
$ taskai task next --claim
Claimed: build-api (id: 4)
# status: ready → in_progress
설계 문서 첨부
Plan/Task 레벨 문서를 첨부하여 에이전트에게 풍부한 컨텍스트를 제공합니다.
plan-doc → task-doc → agent context
Solution

taskai의 접근

taskai는 태스크를 의존성 그래프로 구조화하고, 상태 머신으로 라이프사이클을 관리합니다. 에이전트는 원자적 claim으로 다음 작업을 안전하게 할당받고, 설계 문서를 통해 정확한 컨텍스트를 얻습니다.

JSON 기반 플랜 로드, 사이클 검증, 병렬 실행 가능한 태스크 자동 판별까지 — 복잡한 작업도 체계적으로 완료됩니다.

DAG 의존성 그래프 기반 태스크 오케스트레이션
Demo

실제 동작 모습

Features

주요 기능

의존성 그래프

태스크 간 선후 관계를 DAG로 정의합니다. 병렬 실행 가능한 태스크를 자동으로 판별하여 효율을 극대화합니다.

상태 머신

blocked → ready → in_progress → done. 각 태스크의 라이프사이클을 정밀하게 추적하고 관리합니다.

원자적 Claim

next --claim으로 에이전트가 다음 태스크를 원자적으로 할당받습니다. 중복 실행을 원천 차단합니다.

Plan Load

JSON으로 전체 플랜을 일괄 로드합니다. 로드 시 의존성 사이클을 자동 검증하여 구조적 오류를 방지합니다.

설계 문서

Plan/Task 레벨에 설계 문서를 첨부하여 에이전트에게 풍부한 컨텍스트와 작업 의도를 전달합니다.

멀티 플랜

여러 플랜을 동시에 관리하고 활성 플랜을 자유롭게 전환합니다. 복잡한 프로젝트도 체계적으로 분리합니다.

Quick Start

시작하기

한 줄의 명령으로 설치가 완료됩니다.

$ curl -fsSL https://raw.githubusercontent.com/worktoolai/taskai/main/install.sh | sh