block/trailblaze

What it solves

Trailblaze는 AI 코딩 에이전트가 자연어를 사용하여 실제 기기(iOS, Android, web)를 제어할 수 있는 방법을 제공합니다. 이는 에이전트의 코드 작성 능력과 실제 애플리케이션 UI와 상호작용하는 능력 사이의 간극을 메워주며, 개발자가 에이전트를 사용하여 앱을 구동하고, 이러한 상호작용을 결정론적 테스트로 기록하며, AI 기반의 셀프 힐링(self-healing)을 통해 이를 유지 관리할 수 있도록 합니다.

How it works

Trailblaze는 코딩 에이전트(Claude Code, Cursor, 또는 Goose와 같은)가 기기와 상호작용하는 데 사용할 수 있는 CLI를 제공합니다. 에이전트는 snapshot을 사용하여 UI 트리를 읽고 tool을 사용하여 특정 요소에 동작을 수행합니다. 이러한 세션은 "trails"로 저장됩니다. 즉, 자연어 의도와 플랫폼별 동작을 모두 기록하는 YAML 파일입니다. 이러한 trails는 LLM 없이 CI에서 결정론적으로 재생할 수 있거나, 내장된 에이전트를 사용하여 작은 UI 변경 사항을 패치하는 --self-heal 플래그와 함께 다시 실행할 수 있습니다.

Who it’s for

다양한 플랫폼에 걸쳐 모바일 및 웹 애플리케이션의 엔드 투 엔드(end-to-end) 테스트를 자동화하기 위해 AI 코딩 에이전트를 사용하는 개발자와 QA 엔지니어를 위해 설계되었습니다.

Highlights

• Cross-Platform Control: iOS, Android, 및 web을 네이티브 수준의 충실도로 지원하며, 제한된 기능의 교집합이 아닌 전체 접근성 트리 또는 DOM을 노출합니다.
• Agent-Ready Skills: 에이전트에게 CLI 사용법을 가르치는 휴대 가능한 SKILL.md 형식을 제공하여, 에이전트가 기기를 어떻게 구동해야 하는지 정확히 알 수 있도록 합니다.
• Deterministic Replay: AI 기반 세션을 커밋된 YAML trails로 변환하여 런타임에 LLM이 필요하지 않은 CI에서 실행할 수 있습니다.
• AI-Powered Self-Healing: 재생 중 사소한 UI 드리프트(텍스트 변경 또는 팝업 등)를 자동으로 패치하여 취약한 테스트 실패를 방지합니다.
• Custom Tooling: 개발자가 TypeScript를 사용하여 더 복잡한 에이전트 상호작용을 위해 타입이 지정된 커스텀 명령(예: login 또는 addToCart)을 정의할 수 있도록 합니다.
• Trace Viewer: 실행의 모든 단계에 대해 스크린샷, 뷰 계층 구조, 비디오를 제공하는 브라우저 기반 보고서 뷰어입니다.