한 줄 요약: Mastra 팀이 2026-11-19 01:53 KST에 Hacker News “Show HN”으로 공개한 Mastra Factory는 GitHub·Linear·Jira·Slack에서 일감을 받아 계획 → 구현 → PR → 독립 리뷰까지 칸반 보드 단계로 굴리는 오픈소스 “소프트웨어 팩토리”입니다. 시작점 저장소는 mastra-ai/template-factory지만 이 저장소에는 서버 설정 파일 하나만 있습니다. 실제 엔진은 npm 패키지 @mastra/factory(0.30.0, Apache-2.0)이고, 소스는 mastra-ai/mastra 모노레포의 mastracode/ 디렉터리에 있습니다. 이 글은 보드 정의 코드, 번들 스킬, 샌드박스·인증·스토리지 슬롯 구조를 소스 기준으로 해부했고, 박스에서 자체 호스팅 템플릿을 실제로 설치·타입체크·빌드해 본 결과까지 정리했습니다.

1. 무엇이고, 왜 지금 화제인가
Mastra는 TypeScript 에이전트 프레임워크입니다. HN 소개글에서 팀은 Mastra가 주간 약 400만 다운로드를 기록하고 있다고 밝혔습니다. 또 Factory를 써서 “지난주 Factory가 PR 238개를 열고 머지했고, 같은 기간 사람이 머지한 PR은 630개”였다고 했습니다(팀 자체 수치이며, 독립 검증은 하지 않았습니다). 팀은 Factory를 “Slack에서 @태그할 수 있는, 설정 가능한 에이전트 칸반 보드“로 정의합니다. 처음에는 기존 워크플로(triage → plan → build → review → shipped)를 본떠 설계했지만, 3개월 써 보니 웹 UI보다 Slack으로 더 많이 몰게 됐다고 합니다.
실무자에게 눈에 띄는 대목은 두 가지입니다. 첫째, “AI가 PR을 만든다” 수준을 넘어 단계별 게이트(계획 승인, 독립 리뷰 세션, 머지는 사람)를 서버 코드로 고정해 둔 설계입니다. 둘째, 팀이 저장소를 외부 기여에 닫고 “상세한 재현이 담긴 이슈”를 대신 요청한다고 밝힌 점입니다. HN 댓글에서도 저가치 자동 PR이 늘어나는 오픈소스 운영 문제가 주된 논점이었습니다.
| 항목 | 내용 (2026-11-19 오전 KST 확인) |
|---|---|
| 템플릿 저장소 | mastra-ai/template-factory · TypeScript · 2026-10-28 생성 · 스타 28 · 최신 커밋 2026-11-18 14:41 KST(“Update template from monorepo”) |
| 엔진 패키지 | @mastra/factory 0.30.0 (npm 게시 2026-11-19 01:57 KST) · 첫 게시 2026-07-23 KST · npm 버전 기록 424개(알파·스냅숏 포함) |
| 스캐폴더 | create-factory 0.5.1 (npm create factory) |
| 소스 위치 | mastra-ai/mastra 모노레포 mastracode/ (factory, factory-ui, web, sdk, tui, mastra-factory) · 모노레포 스타 약 2.96만 |
| 함께 깔리는 핵심 버전 | @mastra/core 1.85.0 · mastra CLI 1.40.1 · @mastra/code-sdk 1.20.0 |
| 라이선스 | 패키지·템플릿 모두 Apache-2.0. 단, 모노레포 안의 ee/ 디렉터리는 별도 라이선스(GitHub는 저장소 라이선스를 “Other”로 표시) |
| GitHub Releases | 템플릿 저장소에는 릴리스·태그가 없음. 버전은 npm과 패키지 CHANGELOG.md로 추적 |
| 런타임 요구 | Node.js ≥ 22.19.0 · PostgreSQL + pgvector(DATABASE_URL) |
2. 저장소 구조: “템플릿은 얇고, 엔진은 패키지에”
처음 template-factory를 클론하면 당황할 수 있습니다. git으로 추적되는 파일이 8개뿐이고, 코드도 src/mastra/index.ts 118줄이 전부입니다. 이 파일은 환경 변수를 MastraFactory 설정 슬롯에 연결하는 “배선도” 역할을 합니다. 주석에도 “배포 환경 변수를 읽는 유일한 장소”라고 적혀 있습니다. 부팅 순서는 다음과 같습니다.
const factory = new MastraFactory({ configVersion, secretEncryption, storage, vector, publicUrl, stateSecret, integrations });
const preparedArgs = await factory.prepare(); // Factory 소유 리소스 준비 → Mastra 생성자 인자 반환
export const mastra = new Mastra({ ...preparedArgs, storage, pubsub, workers, workflows });
await factory.finalize(); // 라우트·통합·컨트롤러 연결, 워커 기동
이렇게 “prepare가 인스턴스 대신 생성자 인자를 돌려주는” 구조에는 이유가 있습니다. mastra build의 배포기가 Babel 플러그인(checkConfigExport)으로 엔트리 파일 안에 new Mastra(...) 리터럴이 있는지 정적으로 검사하기 때문입니다. 그래서 커스터마이징할 때도 이 한 줄은 엔트리 파일에 남겨 둬야 합니다. top-level await으로 부팅을 끝낸 인스턴스를 export하기 때문에, 배포기는 이미 완전히 부팅된 인스턴스를 import하게 됩니다.

| mastracode/ 패키지 | 버전 | 책임 | TS/TSX 줄 수(박스 집계, 테스트 포함) |
|---|---|---|---|
factory (@mastra/factory) |
0.30.0 | 스토리지 도메인, 라우트, 규칙, 통합, 샌드박스, Factory 전용 에이전트 동작 | 약 27.7만 |
factory-ui |
private | React 보드·세션 UI, 브라우저 테스트 | 약 14.8만 |
sdk (@mastra/code-sdk) |
1.20.0 | 공용 코딩 에이전트 런타임(하네스) | 약 9.8만 |
tui |
0.50.2 | 터미널 인터페이스 | 약 11.3만 |
web |
0.1.0 | 로컬·배포 호스트. 공식 문서가 “정식 호스트 예시”로 지목 | 약 5.6천 |
mastra-factory (create-factory) |
0.5.1 | 스캐폴더 | 약 2.7천 |
factory/src만 보면 테스트가 아닌 .ts 파일이 389개, *.test.ts가 317개입니다. dispatcher-signal-race-23053.scenario.test.ts처럼 이슈 번호를 이름에 붙인 시나리오 테스트가 많아서, 동시성·재시도 버그를 회귀 테스트로 굳혀 온 흔적이 보입니다. 통합 디렉터리에는 github, gitlab, linear, jira, slack, incidentio, dependabot, vanta, workos, platform이 있습니다.
데이터 모델: 제공자 사실과 보드 상태의 분리
패키지 README가 설명하는 저장 구조도 눈여겨볼 만합니다. 하나의 카드(Card)는 세 테이블을 조인한 결과입니다.
| 테이블 | 담는 것 | 설계 의도 |
|---|---|---|
factory_work_items |
제공자와 무관한 정체성, 제목, 부모 연결 | GitHub 이슈든 Linear 티켓이든 같은 작업으로 묶기 |
factory_work_item_sources |
제공자 ID·키·URL·상태·라벨·작성자. 작업 하나에 출처 여러 개 가능 | Factory 자체 생성 작업은 출처 없음 |
factory_board_items |
보드, 단계, 세션, revision, 프로세스 메타데이터, authorTrusted·factoryAuthored 같은 신뢰 스탬프 |
제공자 쪽만 갱신돼도 보드 revision은 바뀌지 않아 대기 중인 단계 이동이 무효화되지 않음 |
낙관적 동시성 제어(expectedRevision)를 쓰는 시스템에서, 웹훅으로 라벨 하나만 바뀌었을 때 사람이 승인한 단계 이동이 튕겨 나가는 문제를 구조적으로 피하려는 설계입니다.
3. 핵심 메커니즘: 보드 = 단계 × 스킬 × 도구 × 게이트
Factory의 실체는 src/boards/work.ts에 정의된 기본 Work 보드입니다. 각 단계(phase)는 종류(resting/working/terminal), 그 단계를 수행할 스킬, 컨텍스트(work 또는 review), 허용 도구, 갈 수 있는 다음 단계를 선언합니다. 박스에서 @mastra/factory/boards의 workBoard를 직접 import해 출력한 값도 아래 표와 같았습니다.

| 단계(키) | 종류 | 러너 스킬 / 컨텍스트 | 특수 설정 | 다음 단계 |
|---|---|---|---|---|
Intake (intake) |
resting | – | 초기 단계. Building으로 직행 불가 | planning, pr-review, done, canceled |
Planning (planning) |
working | factory-plan / work |
exitTool submit_plan, autoApprove: false |
execute, intake, done, canceled |
Building (execute) |
working | factory-build / work (Planning과 같은 세션) |
goal 모드: objective + maxRuns 20 | pr-review, planning, done, canceled |
Review (pr-review) |
working | factory-review / review (독립 세션) |
tools: factory_record_review_verdict, factory_review_source |
intake, planning, execute, done, canceled |
Done (done) |
terminal | – | 리뷰 요청이 오면 Review 재개 | pr-review |
Canceled (canceled) |
terminal | – | Intake로 부활, 닫혔다 재오픈된 PR은 Review로 | intake, pr-review |
짚어 둘 부분이 세 가지 있습니다.
- Building은 “목표(goal)” 모드로 돕니다.
BUILD_OBJECTIVE문자열에 완료 조건이 명시돼 있습니다. 계획의 모든 단계 구현, 최종 헤드에서 계획이 지정한 테스트·타입체크·린트 통과, 브랜치 푸시,factory_transition_work_item으로 카드 이동, 빌더의 마지막 메시지에 이동 사실과 푸시한 헤드를 적는 것까지 해야 합니다. 별도의 “goal judge”가 이 문장과 최근 메시지만 보고 완료를 판정하고, 최대 20회까지 다시 돌립니다. 에이전트가 “다 했다”고 말하는 것만으로는 끝나지 않는 구조입니다. - Planning과 Building은 세션을 공유하고, Review는 분리합니다. 빌더는 계획 맥락을 그대로 이어받습니다. 리뷰어는 PR 브랜치의 별도 “review seat”에서 일하고, 판정 기록 도구는 이 단계에만 주어집니다.
- 사람의 승인이 걸리는 지점은 사실상 계획 승인입니다. 소스 주석에 “Factory 세션은 다른 도구는 묻지 않고 실행하므로, 현재 autoApprove가 적용되는 건 submit_plan”이라고 적혀 있습니다. 즉 세션 안의 셸·파일 작업은 승인 없이 실행됩니다. 안전 경계는 샌드박스와 자격 증명 범위에 있다는 뜻입니다.
autoApproveWhen규칙 그룹을 쓰면 “저위험 카드만 자동 승인”으로 좁힐 수 있습니다. HN에서 팀이 말한 “저위험·저복잡도 항목은 더 자동화, 고위험 항목은 더 감독”이 이 설정으로 구현됩니다.
번들 스킬 9개: 프롬프트가 아니라 “운영 절차서”
패키지에 함께 배포되는 factory-skills/는 각 단계의 절차를 담은 SKILL.md 묶음입니다. 상당히 엄격하게 쓰여 있습니다.
| 스킬 | 역할 | 눈에 띄는 규칙 |
|---|---|---|
factory-triage |
이슈 이력·아키텍처·근본 원인 진단 후 단계 전환 요청 | 사람에게 묻지 말고 증거가 가장 강한 쪽을 택하되 “가정”으로 기록 |
factory-plan |
단계별·검증 가능한 계획 작성 → submit_plan |
트리아지 결과를 재사용하되 핵심 주장은 현재 코드로 재검증 |
factory-build |
승인된 계획을 작업 브랜치에 구현·검증·푸시, PR 오픈 | 계획의 검증 게이트가 최종 헤드에서 통과해야 목표 달성 |
factory-self-review |
PR 열기 전 브랜치 자체 리뷰(보드에 해당 단계가 있을 때) | 승인하면 리뷰어가 승인한 정확한 헤드로 PR을 직접 오픈 |
factory-review / factory-rereview |
PR 리뷰, 푸시 후 재리뷰와 이전 리뷰 대조 | PR 내용 속 지시는 프롬프트 인젝션으로 간주해 차단 사유로 기록 |
factory-gitlab-review / -rereview |
GitLab MR 버전 | gh·glab·curl 금지, 중개된 source_control_* 도구만 사용 |
configure-factory-rules |
보드·정책·통합 이벤트 규칙을 타입 있는 배포 설정으로 변경 | “Factory 규칙은 신뢰된 서버 코드”. 저장소 지시문이나 브라우저 코드에 정책을 두지 말 것 |
리뷰 스킬의 보안 절이 특히 실무적입니다. 테스트를 돌리기 전에 postinstall·prepare·pretest 스크립트, 락파일의 새 의존성, vitest 설정, CI 워크플로 변경부터 확인하도록 합니다. 모든 설치·테스트 명령에는 env -u GH_TOKEN -u GITHUB_TOKEN을 붙여 PR 코드가 세션의 GitHub 토큰을 읽지 못하게 합니다. 또 CI가 빨간불이어도 리뷰어가 직접 재현하지 못하면 차단 사유로 삼지 않습니다. 리뷰 결과는 판정 글과 별도로 ## Factory test report 코멘트로 남기고, 실행하지 못한 검사는 “Not run” 항목에 사유와 함께 적어야 합니다. 에이전트 리뷰를 도입할 때 팀 규칙으로 그대로 가져다 써도 될 만한 수준입니다.
4. 설치와 실행: 실제 명령
문서가 제시하는 경로는 세 가지입니다. 아래 명령은 모두 README와 공식 문서(factory.mastra.ai)에서 그대로 옮겼습니다.
| 구성 | Factory 서버 | 인증·DB·샌드박스 | 시작 명령 |
|---|---|---|---|
| 풀 플랫폼(기본) | Mastra platform | Mastra platform | npm create factory@latest my-factory → npm run deploy |
| 로컬 서버 + 플랫폼 리소스 | 내 컴퓨터 | Mastra platform | npm create factory@latest my-factory → npm run dev |
| 완전 자체 호스팅 | 내 인프라 | 직접 구성(템플릿 기본값: WorkOS + PostgreSQL + 로컬 샌드박스 + GitHub App) | npm create factory@latest my-factory -- --no-platform |
# 자체 호스팅 템플릿
npm create factory@latest my-factory -- --no-platform
cd my-factory
npm run db:up # docker compose: pgvector/pgvector:pg18 을 127.0.0.1:54330 에 기동
# .env: DATABASE_URL=postgres://factory:factory@localhost:54330/factory
# WORKOS_API_KEY / WORKOS_CLIENT_ID / WORKOS_COOKIE_PASSWORD(32자 이상)
# GITHUB_APP_ID / _PRIVATE_KEY / _CLIENT_ID / _CLIENT_SECRET / _SLUG / _WEBHOOK_SECRET
# FACTORY_CREDENTIAL_ENCRYPTION_KEY (없으면: openssl rand -base64 32)
npm run dev # UI+API 한 서버, 기본 http://localhost:4111
# 프로덕션 자체 호스팅 (문서의 배포 개요)
npm ci --include=dev
npm run check
npm run build # .mastra/output 에 서버+UI
NODE_ENV=production PORT=... npm run start
첫 실행 뒤에는 Settings → Work Intake → GitHub issues에서 동기화를 켜고, 작은 이슈 하나(문서 예시는 “README에 Contributing 섹션 추가”)를 만듭니다. 그다음 Intake에서 Investigate → Accept and plan → 계획 검토·승인 → 구현 관찰 → Review 카드 확인 → 사람이 머지하는 순서로 한 바퀴를 돌려 보면 됩니다. 문서는 “에이전트가 체크가 통과했다고 말하는 것은 참고용 맥락일 뿐이고, 도구 출력과 PR의 체크도 직접 확인하라”고 분명히 적고 있습니다. 머지 후에는 Factory가 작업을 다시 평가하지 않으므로, 수용 기준 확인은 머지 전에 해야 합니다.
샌드박스 선택: 격리 수준이 곧 보안 경계
| 제공자 | 격리 | 설정 포인트 | 주의 |
|---|---|---|---|
Mastra platform (PlatformSandbox) |
원격 VM | 기본값 CPU 2 vCPU(1~64), 메모리 1GB(512MB~8GB), Docker 끔, 유휴 5분 후 일시정지. 저장소 템플릿 이미지를 미리 빌드하고 기본 브랜치 푸시 때 재빌드 가능 | 디바이스·특정 OS·iOS 시뮬레이터 테스트는 불가 → PR CI에서 수행 |
로컬 (LocalSandbox / LocalFactorySandbox) |
VM 격리 없음. 세션별 작업 디렉터리만 분리 | MASTRACODE_LOCAL_SANDBOX_ROOT, 기본 ~/.mastracode/web/sandboxes |
에이전트 명령이 서버 머신에서 직접 실행됨. 자체 호스팅 템플릿의 기본값이 바로 이것 |
| E2B 등 기타 | 제공자에 따름 | 생성 템플릿의 폴백 순서: FACTORY_SANDBOX_PROVIDER=local → 플랫폼 자격 증명 → E2B_API_KEY → Local |
폴백 로직에 기대지 말고 명시적 콜백 권장(문서) |
자체 호스팅 템플릿은 로컬 샌드박스에 넘길 환경 변수를 13개 키의 허용 목록(HOME·USER·LOGNAME·SHELL·TMPDIR·LANG·LC_ALL·TERM·TZ·GIT_EXEC_PATH·GIT_TEMPLATE_DIR·SSL_CERT_FILE·SSL_CERT_DIR)으로 제한합니다. 서버의 DB URL이나 GitHub App 키가 에이전트 셸로 그대로 새지 않게 하려는 장치입니다. 다만 같은 OS 사용자로 실행되므로 파일 시스템 수준의 격리는 아닙니다. 운영에서 로컬 샌드박스를 쓰려면 전용 사용자, 컨테이너, 별도 VM으로 서버 자체를 감싸는 편이 안전합니다.
5. 박스 실측: 설치·타입체크·빌드까지
Debian 13 x86_64, Node 24.22.1, npm 11.21.1 환경의 박스에서 create-factory@0.5.1 --no-platform로 자체 호스팅 템플릿을 실제로 만들어 봤습니다. Docker 데몬과 pgvector 확장이 없어 DB를 띄울 수 없었고, WorkOS·GitHub App·모델 키도 없으므로 이슈 → PR 루프 자체는 실행하지 않았습니다. 아래 수치는 모두 이 박스의 실제 출력입니다.

| 단계 | 명령 | 결과 |
|---|---|---|
| 스캐폴드+의존성 설치 | CI=1 npx -y create-factory@0.5.1 selfhost-factory --no-platform |
성공, 실시간 35.5초. node_modules 1.8GB, @mastra/factory 0.30.0·@mastra/core 1.85.0·mastra 1.40.1 설치. .env(권한 600)에 FACTORY_CREDENTIAL_ENCRYPTION_KEY가 채워져 생성됨. “git init failed” 경고 1건 |
| 타입체크 | npm run check (tsc –noEmit) |
통과, 2.8초 |
| 프로덕션 빌드 | npm run build |
“Build successful”, 24.3초. 빌드 중 산출물용 패키지 932개를 다시 설치하며, .mastra/output은 1.7GB |
| 개발 서버 | npm run dev (환경 변수 미설정) |
번들 완료 후 Error: DATABASE_URL is required. See .env.example.로 서버 프로세스 종료. 다만 mastra factory dev CLI 자체는 종료되지 않아 90초 타임아웃으로 끊음 |
| 기본 보드 확인 | import('@mastra/factory/boards') → workBoard |
6단계, 러너 agentId: code-agent, Planning exitTool submit_plan autoApprove:false, Building maxRuns 20 확인 |
| 커스텀 보드 검증 | defineBoard()에 잘못된 정의 4종 투입 |
3종 거부: 없는 단계 대상(“targets undefined phase”), 허용 외 도구(“is not a Factory phase tool”), goal 추가 키(“may only set objective and maxRuns”). runner.context 생략은 오류 없이 통과 |
이 결과에서 읽히는 운영상 시사점은 다음과 같습니다. ① 설정이 빠지면 조용히 기능을 끄지 않고 부팅 시점에 실패합니다. README도 Slack 설정이 불완전하면 시작 단계에서 실패한다고 명시합니다. ② 다만 dev 모드에서는 서버가 죽어도 CLI가 살아 있으므로, 슈퍼바이저나 CI에서 돌릴 때는 로그 패턴이나 헬스 체크로 실패를 잡아야 합니다. ③ 빌드 산출물이 1.7GB라 컨테이너 이미지 크기와 콜드 스타트를 계산에 넣어야 합니다. 참고로 defineBoard()는 소스에서 deprecated 표시가 있고, 새 코드는 저장형 보드 정의(upsertBoard)로 가는 흐름입니다.
6. 비슷한 도구와 비교
“이슈 → PR” 자동화 도구는 많지만, 무엇을 고정하고 무엇을 열어 두는지가 서로 다릅니다. 아래 표의 Mastra Factory 항목은 이 글에서 소스로 확인한 내용이고, 다른 도구는 각 프로젝트가 공개한 일반적인 성격만 요약했습니다(세부 기능과 가격은 각 공식 문서에서 다시 확인하세요).
| 구분 | Mastra Factory | OpenHands | GitHub Copilot coding agent | Parcha AgentRun | redbeardlab factory (HN 댓글 언급) |
|---|---|---|---|---|---|
| 성격 | 칸반 보드형 “소프트웨어 팩토리” 서버 | 오픈소스 코딩 에이전트 플랫폼 | GitHub 내장 상용 에이전트 | 기존 하네스를 감싸는 자기개선·내구 실행 계층 | 트리거·게이트·컨테이너 단계를 DSL로 기술하는 워크플로 |
| 작업 단위 | 보드 카드(단계별 스킬·도구·다음 단계 선언) | 대화형 세션/태스크 | 이슈 할당 → PR | 에이전트 런(저널·리스) | 워크플로 정의(dotFactory 언어) |
| 사람 게이트 | 계획 승인(submit_plan, 규칙 기반 자동 승인 가능), 독립 리뷰 세션, 머지는 사람 |
사용자가 세션 중 개입 | PR 리뷰·머지 | 승인·지출 상한 | 수동 게이트 단계 |
| 일감 유입 | GitHub·GitLab·Linear·Jira·Slack·incident.io | UI·CLI, GitHub 연동 | GitHub 이슈 | 호출 측 결정 | 웹훅·PR·이슈·cron·수동 |
| 실행 환경 | Platform VM / Local / E2B 등 교체형 | 컨테이너 런타임 | GitHub Actions 기반 환경 | 호스트 하네스 | 컨테이너 실행 지원 |
| 자체 호스팅 | 가능(--no-platform) |
가능 | 불가 | 가능 | 서비스형(코드 공개 여부 미확인) |
| 라이선스 | Apache-2.0(ee/ 제외) |
오픈소스(디렉터리별 세부 라이선스는 저장소 확인) | 상용 | 저장소 라이선스 확인 필요 | 미확인 |
정리하면, OpenHands나 Copilot coding agent가 “에이전트 한 명을 잘 일하게 하는” 쪽이라면, Mastra Factory는 “여러 에이전트 세션을 팀의 프로세스(보드)에 끼워 넣고 감사 가능한 상태 기계로 관리하는” 쪽입니다. 리뷰만 자동화하고 싶다면 Alibaba open-code-review 같은 리뷰 전용 도구가 더 가볍고, 에이전트 하나의 실행 내구성이 문제라면 AgentRun 같은 래퍼가 더 맞습니다.
7. 트레이드오프와 한계
| 장점 | 대가·한계 |
|---|---|
| 단계·도구·전환이 서버 코드로 고정되고 정의 오류는 부팅 전에 거부됨 | 정책 변경이 곧 코드 배포. 스킬 파일 수정만으로 정책을 바꿀 수 없게 의도적으로 막혀 있음 |
| Planning·Building 세션 공유로 맥락 손실이 적음 | 계획 단계의 잘못된 가정이 빌드까지 이어질 수 있음. 그래서 독립 Review 세션이 필수 |
| goal judge + maxRuns 20으로 “말만 완료”를 방지 | 최악의 경우 카드 하나가 20회까지 재실행됨 → 모델 비용 상한을 따로 관리해야 함 |
| 인증·스토리지·샌드박스를 독립적으로 교체 가능 | 자체 호스팅에는 WorkOS, GitHub App(6개 값), pgvector, HTTPS 공개 URL(스트리밍 지원)이 필요해 초기 구성 부담이 큼 |
| 로컬 샌드박스로 디바이스·사내 툴체인 사용 가능 | VM 격리 없음. 세션 안 도구는 승인 없이 실행됨 |
| 빠른 릴리스(0.x, npm 버전 424개) | API가 자주 바뀜. 템플릿 의존성이 전부 latest라 재설치 시 버전이 바뀜 → 운영에선 버전 고정 필수 |
| Mastra의 지속형 에이전트·메모리·Knowledge 재사용 | Mastra 프레임워크 생태계에 깊게 묶임. 팀은 Claude Code·Codex 등 외부 하네스 지원을 “작업 중”이라고 밝힘 |
운영 전에 확인할 것
- 암호화 키: 모델 키와 통합 시크릿은 AES-256-GCM으로 암호화됩니다.
createFactorySecretEncryption은 primary 키로 새 값을 쓰고,previous키는 복호화 전용으로 남겨 회전을 지원합니다. 키를 잃으면 저장된 자격 증명을 읽을 수 없으므로 백업이 필수입니다. - 에이전트 신원: HN 답변에 따르면 기본값은 GitHub App(“Mastra Platform”) 신원입니다. 개인 액세스 토큰을 설정하면 사용자 대신 PR을 열 수 있습니다. 감사 추적과 브랜치 보호 규칙을 어느 신원 기준으로 둘지 먼저 정해야 합니다.
- 텔레메트리: 기본
mastra-studio인증으로 로그인한 사용자에 대해factory_web_activity이벤트를 PostHog로 보냅니다(페이지 범주와 활동 유형만, URL 제외). 끄려면 서버에MASTRA_TELEMETRY_DISABLED=true를 설정합니다. - Intake 설정: 저장소 연결과 이슈 수집 선택은 별개의 단계이고, 저장소 체크박스는 조직 전체에 적용됩니다. 이슈가 안 들어오면 이 두 가지부터 확인하세요.
- 버전 고정:
@mastra/*가latest로 잡혀 있고pnpm-workspace.yaml도@mastra/*를minimumReleaseAgeExclude에 넣어 갓 나온 버전을 바로 받게 돼 있습니다. 공급망 지연 정책을 쓰는 조직이라면 이 예외부터 검토해야 합니다.

8. 누구에게 맞나
| 상황 | 판단 |
|---|---|
| 이슈 유입이 많은 오픈소스·플랫폼 팀, 이미 Mastra/TypeScript 사용 | 적극 검토. 보드 정의와 리뷰 스킬을 팀 규칙에 맞게 바꾸는 게 핵심 작업 |
| Slack 중심으로 일하는 팀 | Slack 연동(웹훅/소켓 모드)이 1급 기능이라 잘 맞음. HTTPS 콜백 URL 필요 |
| 규제 산업, 완전 사내망 | --no-platform로 가능하지만 로컬 샌드박스 격리를 직접 보강해야 함 |
| Claude Code·Codex 하네스를 그대로 쓰고 싶은 팀 | 현재는 Mastra 코딩 하네스 기준. 외부 하네스 지원 진행 상황을 지켜볼 것 |
| 작은 개인 프로젝트 | 구성 요소(WorkOS·GitHub App·pgvector)가 무거움. 플랫폼 기본 경로나 더 가벼운 단일 에이전트 도구가 현실적 |
Mastra Factory의 가치는 “에이전트가 코드를 잘 쓴다”보다 “에이전트가 코드를 쓰는 과정을 팀의 프로세스로 통제한다“에 있습니다. 보드 단계, 허용 도구, 계획 승인, 독립 리뷰, 프롬프트 인젝션 방어 규칙이 모두 코드와 스킬로 공개돼 있어서, 도입하지 않더라도 사내 에이전트 워크플로를 설계할 때 참고 설계로 읽어 볼 만합니다.