nrslib/takt

TAKT Agent Koordination Topology - Define how AI agents coordinate, where humans intervene, and what gets recorded — in YAML

해결하고자 하는 문제

TAKT는 AI 코딩 에이전트를 "베이비시팅"하는 상황을 중단하기 위해 설계되었습니다. 에이전트가 지시를 잊어버리거나, 자체 컨텍스트를 오염시키거나, 장기 개발 작업에서 중요한 리뷰 단계를 건너뛰는 일반적인 문제들을 해결합니다. 복잡한 프로세스를 단일 에이전트에 맡기는 대신, 외부에서 구조화되고 반복 가능한 개발 워크플로우를 강제합니다.

작동 방식

TAKT는 YAML로 정의된 워크플로우를 사용해 여러 AI 에이전트를 오케스트레이션하는 CLI 도구입니다. 개발 과정을 명확한 단계(예: 계획, 구현, 리뷰, 수정)로 분리하고, 각 단계에 특정 페르소나, 권한 및 전환 규칙을 할당합니다.

주요 기술 메커니즘은 다음과 같습니다:

Isolated Worktrees: 작업은 격리된 Git worktree에서 실행되어 메인 작업 디렉터리를 오염시키지 않습니다.
Workflow Engine: YAML 기반 시스템으로 단계 간 전환을 관리합니다(예: 실패한 리뷰를 구현 단계로 되돌림).
Provider Agnostic: Claude Code, Cursor, GitHub Copilot CLI, Codex, OpenCode 등 다양한 AI 공급자를 조정합니다.
Auto-routing: 비용, 성능 또는 추론 요구 사항에 따라 가장 적합한 모델로 특정 워크플로우 단계를 자동 라우팅하는 선택적 기능입니다.

대상 사용자

TAKT는 AI 코딩 에이전트를 사용해 대규모 작업을 수행하고, 즉석 프롬프트에서 전문적이고 재현 가능한 소프트웨어 엔지니어링 프로세스로 전환하고자 하는 개발자를 위한 도구입니다. 또한 GitHub Actions를 통해 CI/CD 파이프라인에 AI 에이전트를 통합하려는 팀에도 적합합니다.

주요 특징

Declarative Workflows: YAML에서 전체 개발 루프(Plan $\rightarrow$ Implement $\rightarrow$ Review $\rightarrow$ Fix)를 정의합니다.
Context Management: 각 에이전트에게 해당 역할에 필요한 정보만 제공하여 컨텍스트 팽창을 방지합니다.
Multi-Agent Coordination: CLI 및 SDK 기반의 다양한 AI 에이전트를 교체 가능한 공급자로 지원합니다.
Traceability: 모든 단계에 대한 로그와 보고서를 유지하여 작업에서 Pull Request까지의 경로를 감사 가능하게 합니다.
Integration: GitHub 및 GitLab 이슈에 대한 내장 지원을 통해 프로젝트 관리 도구에서 직접 작업을 큐에 넣을 수 있습니다.