프로젝트 소개

T3X는 코드가 아니라 구조화된 상태를 위한 버전 관리 시스템입니다. 사람과 AI 에이전트가 구조화된 아티팩트(일반적으로 YAML)에 대한 변경을 제안, 검증, 검토, 커밋할 수 있게 하는 컨트롤 플레인으로 작동하며, 완전한 출처와 되돌릴 수 있는 이력을 유지합니다. 심 아이디어는 각 상태 전환이 이전 상태, 제안된 diff, 검사, 근거, 행위자, 증거를 기록하여 감사 가능한 추적을 생성한다는 것입니다. T3X는 구조화된 상태를 사람이 읽을 수 있는 문서(예: 기술 PRD)로 렌더링할 수 있으며, 그 과정에서도 근본적인 진실의 원천을 잃지 않습니다. 주요 기능: - 커밋 전 검토: 어떤 이력이 진행되기 전에 정확한 diff를 검사합니다. - 결정적 전환: YOps 엔진을 통해 순서가 지정된, 실패 시 즉시 중단되는 작업을 적용합니다. - 첨부된 검사: YSchema를 사용하여 실패를 숨기지 않고 검증 및 외부 검사를 수행합니다. - 출처가 풍부한 결정: 각 변경은 원천, 근거, 행위자, 증거를 함께 연결합니다. - 되돌릴 수 있는 이력: 이전 변경을 지우지 않고 구조화된 상태를 비교, 분기, 병합, 되돌리기합니다. - 사람과 에이전트를 위한 통합 경로: 에이전트 제안도 사람의 변경과 동일한 검토 과정을 거칩니다. 이 프로젝트는 공개 알파(v1.0.0)입니다. 게시된 npm 표면에는 네 개의 패키지가 포함됩니다: - @t3x-dev/local – 런처를 통해 T3X를 로컬에서 실행합니다. - @t3x-dev/yops – 선언적 YAML 작업을 적용합니다. - @t3x-dev/transition – 프로토콜 객체와 커밋 무결성을 검증합니다. - @t3x-dev/yschema – 구조화된 상태를 검증하고 수정 사항을 생성합니다. WebUI, API, CLI, MCP 통합, 러너, 스토리지는 내부 또는 프리뷰로 남아 있으며 변경될 수 있습니다. 빠른 시작 옵션: - 로컬 평가: npx -p @t3x-dev/local t3x-local - 소스에서 개발: 저장소를 복제하고 pnpm install을 실행한 다음 pnpm dev:api와 pnpm dev:webui를 실행합니다(Node.js 20+ 및 pnpm 10+ 필요). - Docker를 통한 자체 호스팅: .env.example을 .env로 복사하고 docker compose up -d --build를 실행합니다. 이 시스템은 Apache 2.0 라이선스입니다. 배포, 제한 사항, 안정성, 보안, 기여에 대한 가이드를 포함한 자세한 내용은 문서에서 확인할 수 있습니다: https://docs.t3x.dev