TAKT—TAKT 에이전트 조정 토폴로지 — 버전이 지정된 명시적인 워크플로를 통해 코딩 에이전트를 실행하기 위한 오픈 소스 오케스트레이션 CLI입니다. 하나의 에이전트에게 계획, 구현 및 검토가 완료되는 시점을 결정하도록 요청하는 대신 YAML 워크플로는 단계, 페르소나, 권한, 전환 및 최종 상태를 정의합니다. 현재 공급자 표면에는 Claude, Codex, OpenCode, Cursor, GitHub Copilot CLI 및 Kiro이 포함되며 구성은 SDK/API 키와 외부 CLI 사이에서 다양합니다. 통합.
TAKT의 가치는 추가적인 모델 지능이 아니라 프로세스 반복성입니다. 검토 루프를 표시하고 Git 작업 트리에서 작업을 격리하며 실행 기록을 보존할 수 있지만 에이전트의 상태 판단이 사실인지 또는 통과한 테스트가 소프트웨어가 올바른지 입증할 수는 없습니다. 팀은 여전히 사양, 도구 권한, 독립적 검증, 비밀, 병합 제어 및 여러 모델 호출의 운영 비용을 소유하고 있습니다.
채팅 요청부터 관리되는 변경까지
사용자/문제
|
v
TALK: 범위 개선
|
QUEUE: 불변 작업 레코드
|
격리된 작업 트리에서 실행
|
.----+---------+----------.
v v v
계획 ------> 구현 --> 검토
^ | |
| v +--> 완료
'------------ 루프 수정 +--> 중단
|
v
독립적인 테스트 + 인간 병합
이 프로젝트는 Talk-Queue-Run 패턴을 설명합니다. 대화형 채팅은 작업을 개선합니다. 큐잉은 이를 기록합니다. 실행은 격리된 공유 클론 작업 트리에서 구성된 워크플로를 실행합니다. 직접, 발행 및 파이프라인 모드는 이 경로를 단축합니다. 개선을 건너뛰는 것은 입력에 이미 기계가 확인할 수 있는 허용 기준이 있는 경우에만 합리적입니다.
음악적 은유가 없는 핵심 개념
| TAKT 개념 | 공학적 의미 | 제어 질문 |
|---|---|---|
| 작업 흐름(이전 자료의 "조각") | YAML 상태 머신 | 모든 경로가 안전하게 종료될 수 있습니까? |
| 스텝/이동 | 에이전트 작업의 제한된 단위 | 어떤 파일과 도구를 사용할 수 있나요? |
| 페르소나 | 역할별 프롬프트 패싯 | 권위가 바뀌나요, 아니면 관점만 바뀌나요? |
| 정책/지식/지도 | 구성 가능한 컨텍스트 패싯 | 지침이 충돌하면 어느 소스가 승리합니까? |
| 규칙 | 상태 조건 전환 | 조건을 독립적으로 관찰할 수 있습니까? |
| 제공업체 라우팅 | 단계, 태그 또는 페르소나를 모델/공급자에 매핑 | 비용, 데이터, 역량이 수용 가능한가? |
| 계약 찾기 | 구조화된 검토 결과 수명 주기 | 발견 항목을 자동으로 삭제하거나 자체 종료할 수 있나요? |
문서와 릴리스는 "부분/동작"에서 "작업 흐름/단계" 용어로 발전했습니다. 이전 YAML 예제를 복사하는 대신 설치된 npm 버전을 고정하고 일치하는 문서를 읽으세요. 검토한 바와 같이 npm은 버전 0.52.0과 노드 요구 사항을 다음과 같이 보고했습니다. ^20.20.0 또는 >=22.22.0; 설치하기 전에 라이브 패키지를 확인하십시오.
최소한의 작업 흐름은 체크리스트가 아닌 그래프입니다
이름: 계획-구현-검토
initial_step: 계획
최대_단계: 10
단계:
- 이름 : 계획
페르소나: 기획자
편집 : 거짓
규칙:
- 조건 : 기획완료
다음: 구현
- 이름 : 구현
페르소나: 코더
편집 : 사실
규칙:
- 조건 : 구현 완료
다음: 검토
- 이름 : 리뷰
페르소나: 리뷰어
편집 : 거짓
규칙:
- 조건 : 승인됨
다음: 완료
- 조건: 수정 필요
다음: 구현이 예시 패턴에는 오류 가장자리, 반복 제한 및 결정론적 검사가 필요합니다. "계획 완료" 및 "승인됨"은 스키마, 테스트 또는 인간의 결정에 의해 뒷받침되지 않는 한 모델 해석입니다. 잘못된 상태, 공급자 오류, 예산 소진 및 범위 위반에 대한 명시적인 ABORT 동작을 추가합니다. 설치된 버전에서 지원되는 공식 워크플로 유효성 검사/의사 명령을 실행합니다.
증거를 중심으로 전환 설계
| 전환 | 약한 상태 | 더 강력한 증거 |
|---|---|---|
| 계획 → 실행 | 상담원이 계획이 좋다고 하더군요 | 필수 승인, 파일, 위험 및 테스트 필드 검증 |
| 구현 → 검토 | 상담원이 코딩이 완료되었다고 말함 | 차이점이 존재하고, 변경된 경로가 허용되고, 빌드/테스트 명령이 실행되었습니다. |
| 검토 → 수정 | 자유로운 형식의 비평 | 결과에는 ID, 심각도, 파일/라인, 증거 및 상태가 있습니다. |
| 검토 → 완료 | 언급된 문제 없음 | Ledger에는 공개 차단 결과가 없으며 게이트가 통과되었습니다. |
| 모두 → 중단 | 모델은 포기하기로 결정 | 예산, 안전, 유효하지 않은 상태 또는 반복적인 실패 정책 실행 |
| 완료 → 병합 | 자동 PR 병합 | 보호된 지점 점검 및 책임 있는 사람의 승인 |
권한은 공급자 브랜드가 아닌 단계를 따라야 합니다.
플래너에게는 일반적으로 편집 권한이 아닌 읽기/검색 액세스 권한이 필요합니다. 구현자는 제한된 작업 트리를 편집하고 저장소 검사를 실행할 수 있습니다. 검토자는 읽기 전용이어야 하므로 승인하기 전에 증거를 "수정"할 수 없습니다. 릴리스 단계에는 명시적인 휴먼 게이트와 좁은 저장소 토큰이 필요합니다. 모델의 정교함은 광범위한 권위를 정당화하지 않습니다.
| 능력 | 기본 자세 | 제어 |
|---|---|---|
| 파일 시스템 편집 | 구현/수정 단계만 | 허용된 루트 및 단계 후 diff 검사 |
| 쉘 | 샌드박스/작업 트리만 | 명령 정책, 시간 초과, CPU/디스크 제한 |
| 네트워크 | 거부 또는 허용 목록 | 메타데이터/내부 호스트 및 로그 대상 차단 |
| Git 푸시/홍보 | 태스크 브랜치 및 PR 초안 | 범위가 지정된 앱 토큰 및 보호된 기본 |
| 비밀 | 필요할 때만 주입 | 단계별 단기 자격 증명 및 수정 |
| 패키지 설치 | 잠금 파일 제한 | 승인된 레지스트리, 무결성 및 종속성 검사 |
| 배포 | 처음에는 외부 코딩 작업 흐름 | 독립적인 방출 시스템 및 인간 승인 |
작업 트리 격리: 유용하지만 불완전함
TAKT의 격리된 Git 작업 트리/공유 복제본은 개발자의 활성 파일을 보호하고 작업 분기를 더 쉽게 검사할 수 있도록 해줍니다. 프로세스, 네트워크, 자격 증명, 사용자 홈 파일 또는 외부 계정을 격리하지 않습니다. 쉘 액세스 권한이 있는 에이전트는 여전히 환경 변수를 읽고, 임의의 호스트에 접속하거나, 전역적으로 인증된 CLI를 호출할 수 있습니다.
신뢰할 수 없는 문제나 리포지토리의 경우 깨끗한 홈 디렉터리, 제한된 송신 및 리소스 할당량을 갖춘 일회용 컨테이너 또는 VM에서 전체 작업을 실행하세요. 작업 저장소만 마운트합니다. 전용 GitHub/GitLab 앱 토큰을 사용하세요. diff, 로그 및 필수 증거를 내보낸 후 환경을 파괴합니다.
공급자 라우팅은 비용 및 정책 라우팅을 생성합니다.
기획자를 하나의 모델에 라우팅하고 구현/검토를 다른 모델에 전달하면 전문성을 향상하고 단일 모델 단일 문화를 피할 수 있습니다. 이는 또한 소스 코드와 프롬프트가 다양한 보존, 지역 및 계정 조건에 따라 여러 공급자에게 전달될 수 있음을 의미합니다. 저장소 데이터 클래스별로 허용 목록을 유지하고 모든 단계에 대해 해결된 공급자/모델을 기록합니다.
| 라우팅 목표 | 합리적인 실험 | 난간 |
|---|---|---|
| 계획 비용 절감 | 구조화된 저위험 계획에 대한 소규모 모델 | 모호성/보안 작업 에스컬레이션 |
| 강력한 구현 | 편집 도구를 갖춘 코드 중심 모델 | 토큰, 파일 및 명령 제한 |
| 독립적인 검토 | 다양한 공급자/모델 제품군 | 읽기 전용 및 스키마 찾기 |
| 데이터 상주 | 민감한 저장소에 대해 승인된 제공업체 | 승인되지 않은 공급자로의 대체 차단 |
| 가용성 | 일시적인 중단 시 폴백 모델 | 행동을 재검증하고, 데이터 공유를 자동으로 확대하지 마세요. |
검토 루프에는 엄격한 중지 규칙이 필요합니다.
상담원 검토는 변동될 수 있습니다. 한 단계에서는 API을 변경하고 다른 단계에서는 이를 복원합니다. 한 모델은 테스트를 추가하고 다른 모델은 테스트를 제거합니다. 최대 단계, 재시도, 벽 시간, 모델 지출, 변경된 파일 및 차이 크기를 설정합니다. 반복되는 상태를 감지하기 위해 발견 항목과 패치를 해시합니다. 동일한 결과가 다시 열리거나 테스트가 개선되지 않거나 범위가 확장되지 않으면 담당자에게 에스컬레이션하세요.
- 구현자가 검토자의 증거 없이 해결된 자체 보안 결과를 표시하지 않도록 하십시오.
- 단지 라인이 이동했다는 이유만으로 결과를 닫지 마십시오.
- 개인이나 정책에 따른 심각도 변경 및 면제를 유지합니다.
- 수정된 에이전트 세션 내의 명령뿐만 아니라 최종 클린 체크아웃 유효성 검사도 필요합니다.
즉각적이고 작업 흐름이 빠른 공급망 위험
TAKT은 기본 제공되거나 꺼낸 워크플로/패싯을 사용할 수 있으며 GitHub에서 레퍼토리 패키지를 설치할 수 있습니다. 이러한 파일은 에이전트 동작 및 도구에 영향을 미칩니다. 실행 가능한 종속성처럼 취급합니다. 커밋 고정, 차이점 검토, 플로팅 방지 메인 CI의 참조 및 활성화 전 패키지 스캔.
저장소 파일, 문제, 컴파일러 출력 및 가져온 웹 페이지는 신뢰할 수 없는 프롬프트 콘텐츠입니다. 악의적인 문제로 인해 에이전트에게 키를 인쇄하거나 워크플로를 수정하도록 요청할 수 있습니다. 시스템 정책 및 권한 적용은 해당 텍스트 외부에 있어야 합니다. 별도의 검토 없이 동일한 작업을 판단하는 품질 게이트를 작업이 편집하도록 두지 마세요.
CI/CD 배포
TAKT은 파이프라인 모드 및 GitHub 작업을 문서화합니다. 읽기 전용 분석 또는 초안 PR 생성으로 시작하세요. 포크에 의해 트리거된 GitHub 작업은 비밀 및 쓰기 가능한 토큰을 사용할 수 있는 경우 위험할 수 있습니다. GitHub의 이벤트별 보안 지침을 따르세요. 불변 커밋 SHA로 타사 작업을 고정하고 최소한의 사용 권한.
| CI 요소 | 안전한 초기 설정 | 이유 |
|---|---|---|
| 트리거 | 수동 발송 또는 신뢰할 수 있는 라벨 | 문제 작성자가 지출/작업을 수행하는 것을 방지합니다. |
| 저장소 토큰 | 읽은 내용; 필요한 경우에만 PR 작성 | 타협을 제한합니다 |
| 공급자 비밀 | 환경 범위 및 마스크 | 포크/로그 노출 감소 |
| 출력 | 초안 PR 및 증거 유물 | 병합에 대한 책임을 유지합니다. |
| 동시성 | 저장소별 및 작업별 한도 | 충돌하는 지점 및 지출을 제어합니다. |
| 시간 초과 | 한정된 작업 및 워크플로 예산 | 루프 및 정지된 CLI를 중지합니다. |
파일럿에서 측정할 항목
20개의 대표적이고 제한된 작업과 비교 가능한 인간/단일 에이전트 제어 그룹을 선택합니다. 허용된 작업 속도, 첫 번째 독립 CI 통과, 검토자 시간, 재개된 결함, 보안 조사 결과, 리드 타임, 모델 비용 및 워크플로 오류를 추적합니다. 변경된 라인과 에이전트 단계 수는 가치가 아니라 활동입니다.
또한 YAML 유지 관리, 공급자 설정, 잘못된 검토 결과, 충돌 정리 및 전환 진단 시간 등 오케스트레이션 오버헤드를 측정합니다. 구조화된 워크플로우는 오버헤드를 초과할 만큼 품질이나 예측 가능성을 높일 때 정당화됩니다.
TAKT이 적합한 경우
| 상황 | 핏 | 왜? |
|---|---|---|
| 명확한 테스트를 통한 반복적인 유지보수 | 강력한 조종사 | 재사용 가능한 작업 흐름 및 목표 게이트 |
| 다중 모델 계획/구축/검토 | 좋음 | 공급자 라우팅 및 명시적 역할 |
| 모호한 그린필드 제품 디자인 | 조건부 | 인간의 결정이 초기 작업을 지배합니다 |
| 하나의 작은 결정론적 편집 | 약함 | 직접 스크립트 또는 감독 대상 상담원 1명이 더 간단합니다. |
| 생산사고 대응 | 불쌍한 자율 시작 | 실시간 권한과 시간 압박으로 인해 오류가 확대됩니다. |
| 광범위한 비밀이 포함된 신뢰할 수 없는 저장소 | 샌드박싱 없이는 안전하지 않음 | Worktree만으로는 보안 경계가 아닙니다. |
대안
| 옵션 | 최적의 핏 | TAKT과의 절충 |
|---|---|---|
| TAKT | YAML의 로컬/CI 다중 공급자 코딩 워크플로 | 새로운 오케스트레이션 언어 및 프로젝트 성숙도 |
| 직접 Codex/Claude 코드 | 한 명의 개발자가 하나의 작업을 감독 | 반복성이 덜한 다단계 라우팅 |
| GitHub 에이전트 워크플로 | GitHub 기반 저장소 자동화 | 플랫폼별 실행/거버넌스 |
| Open SWE | 내부 비동기 문제/채팅-PR 플랫폼 | 더 무거운 서비스 및 샌드박스 통합 |
| LangGraph | 사용자 정의 프로그래밍 방식의 상태 저장 에이전트 애플리케이션 | 더 많은 코드와 일반성, 코딩 작업 흐름 패키징 감소 |
| 일반 CI 스크립트 | 알려진 결정론적 변환 | 덜 유연한 추론, 종종 더 안전하고 저렴함 |
자주 묻는 질문
TAKT은 코딩 모델입니까?
아니요. 지원되는 코딩 에이전트 공급자와 워크플로를 조정합니다.
오픈소스인가요?
현재 저장소와 npm 패키지는 MIT 라이선스를 식별합니다. 설치된 버전과 번들 종속성을 확인합니다.
에이전트 실행을 격리합니까?
작업 트리 상태를 보호하는 격리된 Git 작업 작업 트리/클론을 사용합니다. 강력한 프로세스, 네트워크 및 비밀 격리에는 컨테이너 또는 VM이 필요합니다.
CI에서 실행할 수 있나요?
예, 파이프라인 모드와 문서화된 작업 통합을 통해 가능합니다. 최소한의 권한과 PR 초안으로 시작하세요.
YAML은 품질을 보장하나요?
아니요. 프로세스를 명시적으로 만듭니다. 품질에는 증거 기반 전환, 독립적인 게이트 및 책임 있는 검토가 필요합니다.
어떤 제공업체가 지원되나요?
현재 자료 목록 Claude, Codex, OpenCode, Cursor, GitHub Copilot CLI 및 Kiro. 릴리스별로 지원 및 인증이 변경됩니다.
워크플로는 언제 중지되어야 합니까?
필수 게이트, 명시적 중단 또는 단계, 시간, 지출 및 반복 결과에 대한 엄격한 예산을 통해 성공 여부를 결정합니다.
1차 소스
- 공식 TAKT 저장소 및 README
- 공식 npm 패키지 메타데이터
- 공식 CLI 참조
- 공식 구성 가이드
- 공식 워크플로 가이드
- 공식 변경 내역
- 공식 GitHub Action 저장소
- GitHub Actions 보안 강화
- OWASP 프롬프트 주입 지침
2026년 7월 25일에 마지막으로 검토되었습니다. TAKT이 빠르게 출시됩니다. npm 패키지, 워크플로 스키마 및 공급자 버전을 고정한 다음 업그레이드 후 보안 및 동작 테스트를 다시 실행하세요.
