Skip to content
Agent Stack
  • AI SDK
  • AI Gateway
  • Sandbox
  • Passport
  • Connect
  • eve
Core Platform
  • Build and deploy
  • Vercel CI
  • Fluid Compute
  • Content Delivery
  • Observability
  • Workflows
  • Security
Tools
  • Next.js
  • Vercel Agent
  • Vercel Plugin
  • Open Source
  • Domains↗
  • v0↗
Learn
  • Docs
  • About
  • Blog
  • Changelog
  • Knowledge Base
Build
  • AI Apps
  • Web Apps
  • Marketing Sites
  • Platforms
  • Commerce
Explore
  • Customers
  • Marketplace
  • Partner Finder
  • AWS
  • Community↗
EnterprisePricing
Contact
Log InSign Up
Dashboard

Products
Agent Stack
  • AI SDK
  • AI Gateway
  • Sandbox
  • Passport
  • Connect
  • eve
Core Platform
  • Build and deploy
  • Vercel CI
  • Fluid Compute
  • Content Delivery
  • Observability
  • Workflows
  • Security
Tools
  • Next.js
  • Vercel Agent
  • Vercel Plugin
  • Open Source
  • Domains↗
  • v0↗
Resources
Learn
  • Docs
  • About
  • Blog
  • Changelog
  • Knowledge Base
Build
  • AI Apps
  • Web Apps
  • Marketing Sites
  • Platforms
  • Commerce
Explore
  • Customers
  • Marketplace
  • Partner Finder
  • AWS
  • Community↗
Enterprise
Pricing
Sign UpLog In
Contact
Templates
Template name

Agent Stack

  • AI SDK
  • AI Gateway
  • Sandbox
  • Workflows
  • ConnectNew
  • PassportNew
  • eveNew

Core Platform

  • Build and deploy
  • Vercel CINew
  • Fluid Compute
  • Content Delivery
  • Observability

Security

  • Platform Security
  • WAF
  • Bot Management
  • BotID

Tools

  • Vercel Drop
  • Vercel Agent
  • Vercel Plugin
  • Agent Skills
  • Domains
  • v0

Frameworks

  • eveNew
  • Next.js
  • Nuxt
  • SvelteKit
  • Nitro
  • Turborepo
  • Tanstack Start
  • FastAPI
  • All frameworks

SDKs

  • Vercel SDK
  • Workflow SDK
  • Flags SDK
  • Chat SDK
  • Queues SDK
  • Streamdown

Build

  • AI Apps
  • Web Apps
  • Marketing Sites
  • Platforms
  • Commerce
  • Platform Engineers
  • Design Engineers

Learn

  • Docs
  • Blog
  • Changelog
  • Knowledge Base
  • Academy
  • Articles
  • Community
  • Is Agentic

Explore

  • Customers
  • Marketplace
  • Templates
  • Partner Finder
  • Vercel + AWS

Company

  • About
  • Careers
  • Press
  • Events
  • Startups
  • Shipped on Vercel
  • Open Source Program
  • Enterprise
  • Pricing
  • Help

Legal & Trust

  • Privacy Policy
  • Terms of Service
  • Cookie Policy
  • DPA
  • Acceptable Use Policy
  • Legal (all documents)
  • Trust Center
  • Status

Social

  • GitHub
  • X
  • LinkedIn
  • YouTube
  • Instagram
  • VercelVercel
Templates
Template name

Loading status…

Select a display theme:
Templates

eve Software Factory

Turn GitHub and Linear issues into reviewed draft pull requests with specialist eve agents and human approval before shipping.

DeployView Demo
Owner
  • vercel-labs
Repository
  • eve-software-factory-template
Use Cases
  • AI
Stack
  • eve
Database
  • Vercel Blob
Deploy

eve Software Factory

eve Software Factory is a template for teams that want artificial intelligence agents to turn repository issues into reviewed draft pull requests. Its orchestrator, Foreman, assigns work to specialist agents and reports progress in GitHub or Linear. A person decides when to mark the result ready and merge it.

What can you build with this template?

Start a run by labeling a GitHub issue factory, mentioning the bot on an issue or pull request, or delegating an issue in Linear. Foreman sends actionable work through four stations:

StationWork it performs
ClassifierTriages the request and identifies missing information.
AnalystBuilds a plan and acceptance criteria against a repository checkout.
ImplementerWrites code in a sandbox, runs the repository's checks, and pushes a branch.
ReviewerEvaluates the pushed branch against the acceptance criteria, using a different model vendor from the implementer.

Each station has its own instructions, sandbox, and tools. The reviewer receives the branch without the implementer's reasoning. Foreman's instructions allow up to two revision cycles; if review still fails, they direct it to report the unresolved findings without opening a pull request.

After approval from the reviewer, Foreman opens a draft pull request. It can also diagnose failed CI on branches with the configured factory prefix and push a repair. That repair workflow is instructed to stop after two attempts and ask for human troubleshooting.

Why use this template?

Use this template to move an issue through planning and independent review before your team receives a pull request. It supplies specialist handoffs and policies for unattended work.

Adapt station instructions and models to build AI agents around your development process. To choose the best AI agent workflow, examine what the reviewer sees and where human approval is required. Foreman gives you a concrete starting point for both, with included evaluations for routing, safety, and prompt-injection behavior.

Why use eve on Vercel?

eve is an open-source AI agent framework with durable execution and declared subagents. The factory implementation assigns stations to subagents with Vercel Sandbox execution environments.

Vercel Connect supplies GitHub and Linear credentials. Git credentials are injected at the sandbox firewall without entering its processes. Vercel Blob stores shared repository notes, while Blob and model access authenticate with the project's OIDC token.

What should you know before deploying?

Set FACTORY_REPO to an existing repository in owner/repo format and give the selected GitHub App access to it. The repository setup guide covers the GitHub and Linear connectors, Blob storage, and configuration. Keep the factory branch prefix reserved for factory work because it determines which branches qualify for automated CI repair.

Unattended runs stop at draft pull requests. Attended requests to mark a pull request ready require human approval, and merging is absent from the supplied tools. The push tool refuses main and master; review that protection if your default branch has another name. Approval requests appear in GitHub comments, Linear, or the development TUI.

The optional full-pipeline evaluation pushes a real branch. Use a scratch repository when running it.

Frequently asked questions

How do I send an issue to the software factory?

Apply the configured factory label to a GitHub issue, mention the bot in an issue or pull request, or delegate work in Linear. GitHub label intake requires at least triage permission, and mentions are accepted from repository owners, members, and collaborators. If classification finds missing information, Foreman asks for clarification before implementation.

Why does Foreman use separate specialist agents?

The classifier, analyst, implementer, and reviewer have distinct instructions and execution environments. The reviewer checks the actual branch against the plan's criteria without seeing the implementer's reasoning. Its model comes from a different vendor than the implementation model.

Can the factory merge its own pull requests?

No. The supplied GitHub tool list excludes merging. An unattended run can produce a draft PR, while marking it ready in an attended session waits for a person's approval. A person performs the merge.

Which failed CI checks can Foreman repair?

The automated repair trigger accepts failed check suites on pull requests whose head branch matches the configured factory prefix. Its instructions limit repairs to two attempts before handing the problem to a person. The branch prefix determines eligibility, so reserve it for factory work.

What does the factory remember about a repository?

Shared notes in Vercel Blob hold build quirks and verification details, including recurring review findings. Foreman reads them at the start of a task. Unattended runs cannot update this memory; trusted attended sessions can write it, and writes from the development TUI require approval.

Related resources

  • Deploy eve on Vercel
  • Vercel Sandbox

Related Templates

  • eve Marketing Team thumbnail

    eve Marketing Team

    Coordinate a marketing lead and five specialist agents in Slack, with Notion drafts, Typefully posts, and Resend email campaigns.

  • eve Personal Agent thumbnail

    eve Personal Agent

    Build a personal eve assistant with persistent web chat, linked Slack identity, optional iMessage, and per-user memory.

  • eve GitHub Maintainer thumbnail

    eve GitHub Maintainer

    Maintain GitHub from your inbox with Kody: weekly issue digests, actions by email reply, pull request summaries, and Linear work.

Related Integrations

  • GitHub Issues

    Convert comments to GitHub issues

  • Linear

    Convert comments to Linear issues

License
  • View License