Artifactize

Artifactize: Evaluation-driven development for people and AI agents.

애니메이션, Artifactize에서 함께 일하기: 사람과 AI 에이전트가 세 역할을 나눠 맡아 Artifact Graph 하나를 주고받습니다. Artifact Graph는 저마다 검사를 갖춘 프로젝트 조각인 Artifact로 이루어집니다. 사람 세 명과 AI 에이전트 두 개가 Director를 맡아 무엇을 만들지 정하고 Artifact를 추가하면, AI 에이전트 다섯 개가 Builder를 맡아 만들고, AI 에이전트 네 개와 사람 한 명이 Evaluator를 맡아 Artifact를 하나씩 검사합니다. 새 Artifact가 RED라서 Artifact Graph는 Builder에게 돌아가 수정을 거친 뒤 다시 Evaluator에게 가고, 그 Artifact는 GREEN이 됩니다. 이어서 Director가 Artifact를 하나 더 추가하고 하나를 바꾸면, Artifact가 GREEN이 될 때까지 Builder와 Evaluator가 다시 Artifact Graph를 주고받습니다.
Artifact Graph 예시: PROBLEM.md, SPEC.md, code/, docs/는 프로젝트의 구성 요소이며, 각 요소마다 별도의 검사를 붙입니다. 사람은 문제를 리뷰하고, AI 에이전트는 프로젝트가 해야 할 일을 적은 문서인 명세가 문제를 해결하는지, 코드 테스트가 명세의 요구 사항을 제대로 검증하는지, 문서가 코드를 설명하는지, 코드와 문서가 각각 정해진 규칙을 따르는지 확인합니다. 코드의 테스트는 명령으로 실행됩니다.
Artifactize 데스크톱 앱에서 예제 프로젝트의 Run을 네 번 실행한 과정을 실제로 녹화했습니다. 실패한 부분이 빨간색으로 표시되면 다음 Run 전에 고치고, 바뀌지 않은 작업은 결과를 재사용하며, 네 번째 Run에서 통과합니다.
상자 하나하나가 Artifact, 즉 검사가 따로 붙는 프로젝트의 한 조각이고, 그 사이의 선들이 Artifact Graph를 이룹니다. 데스크톱 앱 미리보기 버전에서 예제 프로젝트의 검사를 한 번씩 모두 거치는 Run을 네 번 실행한 과정을 녹화해 8배속으로 재생합니다.

이런 분께 추천합니다

동작 방식

  1. 평가로 결과물의 조건을 정하면, AI 에이전트가 평가를 통과할 때까지 결과물을 고쳐 나갑니다.
  2. 테스트, AI 에이전트, 사람 모두 동등한 평가자가 될 수 있고, 각각 잘 평가하는 부분이 다릅니다.
  3. 평가를 거친 결과물은 다음 평가의 입력이 되고, 이렇게 최종 결과물까지 이어집니다.

스토리

프로젝트가 성장하는 모습을 지켜보세요.

아래에서는 단계별로 그 시점의 프로젝트 상태를 설명하며, 옆의 애니메이션에서도 같은 내용을 볼 수 있습니다.

01아이디어

아이디어에서 시작합니다.

무엇을 만들지 적은 메모 몇 줄입니다. 아직 리뷰할 것은 없습니다.

아이디어가 하나 있고, 아직 검사는 없습니다.

02Artifact

계획과 명세가 Artifact가 됩니다.

따로 리뷰할 조각을 고르세요. AI는 명세에 계획 내용이 빠짐없이 반영됐는지 확인합니다.

계획과 명세가 두 Artifact가 되고, AI 리뷰 하나로 둘을 비교합니다.

03검사

코드가 추가되고, 검사로 조각들을 연결합니다.

조각끼리 비교하세요. Alice는 명세를 바탕으로 작업을 시작하기 전에 명세를 승인합니다.

코드가 명세에 맞는지 확인하고, Alice가 명세를 승인합니다.

04테스트와 스타일

테스트와 스타일 리뷰로 코드를 검사합니다.

테스트가 코드를 검사합니다. AI는 Alice가 승인한 가이드에 맞춰 코드의 스타일을 확인합니다.

테스트, AI 스타일 리뷰, Alice의 승인은 서로 다른 세 가지 검사입니다.

05모듈

코드가 모듈로 나뉩니다.

더 작은 코드 조각마다 검사를 붙이면, 변경의 영향을 받는 부분을 골라 리뷰할 수 있습니다.

코드가 세 부분으로 나뉘고, 부분마다 따로 테스트하고 리뷰합니다.

06코드 너머

웹사이트와 문서 페이지도 Artifact Graph에 들어옵니다.

글과 디자인도 검사하세요. 가이드에 설명된 앱 연결 방식이 실제 구현과 맞는지 확인합니다.

문서와 웹사이트를 검사하고, Dana가 디자인을 승인하는 절차도 추가합니다.

07변경 하나

모듈 하나를 바꾸면 그 모듈에 의존하는 것만 다시 실행됩니다.

앱 연결을 바꿔 보세요. 그 연결을 확인하는 검사와 그 연결을 사용하는 부분의 검사만 다시 실행됩니다.

앱 연결 방식이 달라진 부분과 그 영향을 받는 부분만 다시 검사하고, 나머지 부분은 기존 검사 결과를 그대로 사용합니다.

08계속 성장합니다

새 Artifact와 연결이 계속 늘어납니다.

프로젝트의 리뷰 과정을 다시 설계하지 않고도 새 Artifact를 추가하고 Artifact끼리 연결할 수 있습니다.

동기화 모듈과 브랜드 가이드를 프로젝트에 추가하고, 각각에 검사를 붙입니다.

09동시에 작업

각자 프로젝트 사본을 만들어 작업하세요.

공유 리뷰 저장소를 쓰면 팀원들이 저마다 작업하는 프로젝트 사본에서 받은 리뷰 결과를 서로 재사용할 수 있습니다.

Alice, Bob, Carol이 따로 작업하고 리뷰 결과를 공유합니다.

10합치고 검사

변경을 합치고 새로 생긴 것만 검사하세요.

변경을 하나로 합치세요. 팀이 함께 쓰는 검사는 새로 조합된 부분만 리뷰하고, 공유된 리뷰 결과는 수정하지 않고 조회만 합니다.

프로젝트를 합친 뒤에는 기존 리뷰 결과를 재사용하고 새 조합만 검사합니다.

데스크톱 앱에서 보기

데스크톱 앱에서 Artifactize 프로젝트의 Artifact Graph가 성장하는 과정을 녹화했습니다.

데스크톱 앱 미리보기 버전에서 녹화했으며, 빠르게 재생합니다.

0.7.0부터 현재 릴리스까지 Artifactize 프로젝트의 Artifact Graph가 릴리스마다 성장하는 과정을 데스크톱 앱에서 실제로 녹화했습니다.
Artifactize 프로젝트의 Artifact Graph가 0.7.0부터 지금까지 릴리스마다 한 단계씩 성장하는 모습입니다.

시작하기

5분 만에 써 보세요.

Artifactize는 Apache License 2.0으로 공개된 오픈 소스입니다. Linux, macOS, Windows에서 실행되며, 빠른 시작을 따라 하면 AI 계정이나 API 키 없이 예제 프로젝트를 리뷰할 수 있습니다.

앱에 artifactize 명령이 함께 들어 있습니다. Mac에서는 앱을 한 번 열면 터미널에서 artifactize 명령을 쓸 수 있습니다. Ubuntu 22.04, Debian 12 이상에서는 소프트웨어 설치 프로그램으로 .deb를 열거나 sudo apt install ./Artifactize-amd64.deb를 실행하세요.

또는 명령줄에서 설치

# Linux (x86_64, aarch64): sudo 없이 ~/.local/bin에 설치, x86_64에서는 데스크톱 앱도 설치
$ curl -fsSL https://artifactize.dev/install.sh | sh
$ artifactize --version
# macOS (Apple 실리콘, Intel), Homebrew 사용
$ brew install lhj6102/tap/artifactize
$ artifactize --version
# Homebrew 없이: sudo 없이 ~/.local/bin에, 앱은 ~/Applications에 설치
$ curl -fsSL https://artifactize.dev/install.sh | sh

Homebrew로 앱과 명령을 함께 설치하려면: brew install --cask lhj6102/tap/artifactize

# Windows x64, Microsoft Store에서 데스크톱 앱과 함께 설치한 뒤 새 터미널을 여세요
PS> winget install 9PB6W4LL165D --source msstore
PS> artifactize --version
# Store 없이, 관리자 권한 없는 PowerShell에서
PS> irm https://artifactize.dev/install.ps1 | iex

PowerShell로 내려받는 파일은 코드 서명이 없어 Smart App Control이 막을 수 있습니다. Microsoft Store 버전은 Microsoft가 서명합니다.