vercel-labs/eve-software-factory-template

What it solves

Foreman is an AI-powered software factory that automates the development loop. It reduces the manual effort required to move a task from an issue tracker (like GitHub or Linear) to a reviewed pull request, while keeping human developers in the loop for final judgment calls.

How it works

The system uses a pipeline of four specialized AI agents, each with its own instructions, sandbox, and tools:

1. Classifier: Triages the task for type, priority, and complexity, and ensures the task is actionable before proceeding.
2. Analyst: Creates a detailed plan with acceptance criteria based on a live checkout of the repository.
3. Implementer: Executes the plan in a sandbox, verifies the code with the repository's own checks, and pushes a branch.
4. Reviewer: Independently evaluates the the pushed branch against the real diff to provide a verdict.

Between runs, the system maintains a "factory brain" (memory) containing notes about the repository to provide context for future tasks.

Who it’s for

Developers and engineering teams who want to automate the triage, planning, and implementation of software tasks via GitHub or Linear integration.

Highlights

• Multi-agent pipeline: Uses four distinct roles (Classifier, Analyst, Implementer, Reviewer) to ensure quality and only push code changes.
• Integration: Works directly with GitHub issues, Linear, and a local TUI for task delegation.
• Integration with CI: Automatically diagnoses and fixes failures in its own pull requests.
• Repository Memory: Maintains a long-term memory of the repository to improve efficiency across different tasks.