Fabrika는 코딩 작업을 단계별로 검토하게 한다

Fabrika에는 약 1,200개의 테스트가 들어 있다. 각 테스트는 실행할 가치가 있는 속성을 확인하도록 만들어졌다.

Fabrika는 기능 개발을 여러 단계의 작업자와 검사자에게 나눠 맡기고, 결과를 사람이 검토할 패킷으로 돌려주는 소프트웨어 제작 도구다. Claude Code와 Codex, OpenHands를 통해 모델을 실행하며, 기능을 설계하고 구현·검증하는 과정을 정해진 흐름으로 진행하려는 개인이나 소규모 팀을 겨냥한다.

Fabrika는 어떤 도구인가?

소프트웨어 제작 공장에 빗대면 이해하기 쉽다. Fabrika는 요구사항 작성부터 구현, 시험, 코드 검토까지를 역할별 작업대로 나누며, 각 작업대에는 한 가지 임무를 맡은 에이전트가 배치된다.

구현을 맡은 팀과 결과를 공격적으로 확인하는 팀은 서로 다른 모델 계열을 쓰도록 구성하는 것이 목표다. 예를 들어 Claude로 만들고 GPT나 Gemini로 검사할 수 있다. 각 역할의 지시는 실행 때 불러오는 마크다운 프롬프트이며, 콘솔에서 읽고 수정할 수 있다.

개발 과정은 어떻게 진행되나?

먼저 저장소를 살펴 린터와 형식 검사기, 보안·접근성 검사, 단위·통합·사용자 대상 테스트, AGENTS.md와 CLAUDE.md 같은 에이전트 안내 파일을 찾는다. 발견한 검사는 변경되지 않은 체크아웃에서 실행한다. 사용자가 기준 검사를 받아들이기 전에는 기능을 만들지 않는다. 검사가 통과하지 않아도 현재 상태에서 고치거나 기준선으로 고정하거나 적용 대상이 아니라고 판단할 수 있다.

그다음 정찰 역할이 코드베이스를 읽고, 질문 역할이 코드만으로 답을 정할 수 없는 점을 묻는다. 명세 작성자와 검사자가 명세를 만들고 검토하며, 해결하지 못한 의견 차이만 열린 질문으로 사용자에게 전달한다. 명세에는 변경 대상, 해야 할 일과 범위 밖인 일, 가정과 위험, 결정 근거가 담긴다. 각 기준에는 검증 방법과 단계, 되돌리기 어려운 정도가 붙는다. 사용자가 명세를 확정해야 구현이 시작된다.

구현 단계에서는 설계자가 작업 단위를 나누고 계획 검사자가 반대 의견을 낸다. 둘이 합의하지 못하면 사용자에게 계획 검토를 요청한다. 이후 작업자는 코드를 만들고, 통합자는 작업 결과를 합쳐 경계 부분의 테스트를 작성한다. 오라클은 구현 코드를 보지 않고 확정된 명세만으로 인수 테스트를 만든다. 검사 실행과 수정 작업의 분할은 에이전트가 아니라 일반 코드가 맡는다.

브레이커는 경계 조건, 실패 경로, 동시성, 악의적 입력과 명세의 취지를 벗어난 구현을 시험한다. 리뷰어는 중복이나 프로젝트 관례 위반, 근거 없는 추상화 등을 지적한다. 중재자는 각 지적을 수정·단순화·오라클 재검토·범위 제외·사용자 확인 중 하나로 분류한다. 수정 담당자는 전달받은 문제만 좁게 고친다. 기본 수정 반복 횟수는 두 번이며, 설정한 예산과 최대 실행 시간에도 제한된다. 마지막에는 보고 담당자가 검토 패킷을 구성한다.

검토 패킷에서 무엇을 확인하나?

결과물은 풀 리퀘스트만이 아니라, 명세를 충족한다는 근거를 함께 담은 검토 패킷이다. 코드는 해당 코드를 요구한 기준을 따라 찾아볼 수 있고, 기준과 파일 사이의 연결도 표시된다. 각 파일에는 관련 기준과 작업자가 내린 결정, 그 파일을 지목한 이견이 연결된다. 실제 판단이 필요한 신규 코드와 건너뛰어도 되는 상용구도 구분한다.

패킷에는 프로젝트 자체의 검사 결과, 오라클의 맹검 인수 테스트, 브레이커의 시험, 브라우저 테스트 녹화가 들어간다. 각 근거 항목은 무엇을 증명하지 못하는지도 함께 밝힌다. 의존성은 OSV를 이용해 알려진 취약점과 악성 패키지를 확인하고, 프로젝트의 라이선스 기준과 며칠 전에 배포된 릴리스인지도 살핀다. 걸린 항목은 사용자가 판단할 사안으로 올라온다. 수정된 이견도 처리 결과와 함께 남으며, 근거보다 좋아 보이는 수치가 있는 지점도 별도로 표시한다.

저장소 구조를 파악하는 기능은 모든 파일을 읽어 아키텍처와 하위 시스템, 기능 지도를 만든다. 일반 코드가 보고 내용을 확인하고 그래프로 합친 뒤, 지도 작성 역할이 그룹 이름을 붙인다. 각 항목에는 안정적으로 유지되는 세 글자 ID가 부여된다. 실행할 때마다 분석할 수 있고, 이후에는 마지막으로 처리한 커밋 뒤에 바뀐 파일만 읽는다.

사용하려면 무엇을 확인해야 하나?

Fabrika는 알파 버전 0.1.0이며 MIT 라이선스다. 아직 실제 업무에서 사용되지 않았고 버그가 있을 수 있다고 설명한다. 한 명 또는 소규모 팀이 독립적으로 개발하는, 범위가 분명하고 자체적으로 완결된 기능에 맞춰져 있다. 개인 컴퓨터에서 단일 사용자로 실행하는 용도다. 팀 로그인, 작업 흐름 조정, 클라우드 배포는 아직 지원 대상으로 제시되지 않았다. 사용자 경험을 다듬거나 문제 공간을 탐색하는 등 왕복 논의가 많은 작업에도 적합하지 않다고 안내한다.

Claude Code와 Codex는 Anthropic 및 OpenAI 구독으로 헤드리스 실행할 수 있다. OpenAI 호환 서비스와 OpenRouter, 로컬 모델은 OpenHands 하네스를 거쳐 실행한다. 구독 서비스가 요청을 제한하면 팀별 대체 에이전트로 전환하며, 모델 이름은 factory.yaml 한 파일에서 관리한다. Fabrika는 원문에서 가격과 구체적인 운영체제 지원 범위를 밝히지 않는다.