eve-software-factory-template README

The project's README from github.com/vercel-labs/eve-software-factory-template. As one markdown file: README.md.

eve Software Factory Banner

eve Software Factory Template

Docs Agent Stack MIT License

Meet Foreman, an eve software factory that puts AI agents on every stage of the development loop and keeps people on the judgment calls.

Foreman takes tasks from GitHub and Linear, moves each one through four stations, and delivers a reviewed draft pull request on your repository. You review, mark ready, and merge.

Deploy with Vercel

How it works

Each station is its own agent with its own instructions, sandbox, and tools. The Reviewer sees only the pushed branch, never the Implementer's reasoning. Between runs, Foreman keeps a factory brain: notes about your repository that every run starts from. See the pipeline and factory memory for the full picture.

How work arrives

Deploy

Deploy with Vercel

The Vercel deploy flow sets up everything: the GitHub connector, Linear connector, Vercel Blob store, and a prompt for the FACTORY_REPO and FACTORY_LABEL environment variables.

Two things must line up before the first deployment can finish. FACTORY_REPO must name a real repository in owner/repo format, and the GitHub App behind the connector you select must be installed with access to that repository. The deployment clones FACTORY_REPO up front to prewarm the station sandboxes, so a repository the app cannot reach fails the deploy with a Cannot access <owner/repo> error; install the app on the repository (or fix the value), then redeploy.

Configuration (see .env.example):

Variable Required Default What it does
FACTORY_REPO Yes — An existing GitHub repository in owner/repo format; the selected GitHub App must have access to it (the deploy fails otherwise)
FACTORY_SETUP_COMMAND No — Runs once inside the sandbox checkout at build time (e.g. pnpm install), so every run starts with dependencies already installed
FACTORY_LABEL No factory The issue label that hands an issue to the factory
FACTORY_BRANCH_PREFIX No factory/ Branch prefix marking the factory's own PRs, which are the only branches automated CI fixes touch
FACTORY_BOT_NAME No the GitHub App's slug The @mention name, resolved from the connector automatically when unset
GITHUB_CONNECTOR / LINEAR_CONNECTOR Yes — Set automatically from Vercel Connect connector UIDs

Local development

Link the project you deployed (or a fresh one), pull its environment, and start the TUI:

vercel link
vercel env pull
pnpm dev

Hand the agent a task ("users report the password reset email arrives twice, fix it") and watch the four stations fire in order, ending in a draft PR on FACTORY_REPO. Local runs are treated as untrusted, so changes to GitHub wait for your approval in the TUI.

Resources

Explore more templates

eve-software-factory-template (vercel-labs/eve-software-factory-template)

Searching Database…

1.2K ·GitHub
Eve-software-factory-template
Что это?Foreman — это «eve Software Factory», которая ставит ИИ-агентов на каждый этап цикла разработки, оставляя за людьми решения о суждениях. Она берёт задачи из GitHub и Linear, прогоняет их через четыре агентские станции и выдаёт проверенный черновой pull request для слияния.
Это чат-бот или автоматизированный конвейер агентов?Это автоматизированный мультиагентный конвейер, а не чат-ассистент: Classifier, Analyst, Implementer и Reviewer работают каждый как собственный агент со своей песочницей и инструментами, хотя взаимодействовать можно и через упоминания (@mentions) или локальный TUI.
Как развернуть Foreman?Используйте Vercel deploy flow, который настраивает GitHub-коннектор, коннектор Linear и хранилище Vercel Blob и запрашивает переменные окружения FACTORYREPO и FACTORYLABEL.
Что нужно перед развертыванием?Нужен существующий репозиторий GitHub (в формате owner/repo), в который выбранное GitHub App реально установлено и имеет доступ; интеграция с Linear опциональна — для делегирования задач из Linear.
Какая главная ошибка при развертывании?Если FACTORYREPO и установленный доступ GitHub App не совпадают, развертывание падает с ошибкой «Cannot access», потому что оно пытается прогреть песочницы, заранее клонируя репозиторий; нужно исправить установку приложения или значение репозитория и развернуть заново.
Что такое factory brain?Между запусками Foreman хранит заметки о вашем репозитории, с которых начинается каждый новый запуск, поэтому со временем накапливает контекст вместо старта с нуля на каждой задаче.
Можно ли протестировать задачу, не трогая GitHub?Да, локальная dev-TUI позволяет передать Foreman задачу прямо на вашей машине; любые возникающие изменения всё равно ждут вашего одобрения, прежде чем попасть в GitHub.
Какая переменная окружения задаёт метку issue на GitHub, запускающую конвейер?FACTORYLABEL, которая по умолчанию равна 'factory', если её не задать.
What are similar projects?open-swe, claude-code-action, orca, grok-ship, pulls.review, github-mcp-server, factory, emdash
Which topics is it in?linear, pull-request, vercel, ci-cd, template, code-review, agent-framework, github, workflow-automation, ci, agent-orchestration, multi-agent
Creator
vercel-labs
Size
1.4 MB
Stars
1.2K
Updated
CommitSep 29
Age
2mo
Commits · 90 Days