Foreman - eve Software Factory Template

Search…⌘ KAsk AIAsk AIGitHub<br>Search…⌘ K

Foreman<br>Free, open-source software factory that puts AI agents on every stage of the development loop and keeps you on the judgment calls.

svg]:px-4 rounded-full">Deploy on Vercelsvg]:px-4 rounded-full" href="/en/docs">Read the docs

Label an issue, get a reviewed PR<br>Foreman classifies, plans, implements, and reviews the work, then links a draft PR back on the thread. You make two judgment calls, what to hand it and whether the result ships.

Add a --json flag to eve info

Benji added the factory label

Foreman Picked this up and classified it as a feature, small in scope. eve info prints discovery diagnostics for humans, and CI scripts need a machine-readable version. Planning now.

Foreman Plan ready with 3 acceptance criteria. Implementing on factory/feature-eve-info-json.

Foreman Implemented and verified: lint, typecheck, and the CLI tests pass. Review in progress in a separate checkout.

Foreman Reviewer approved: 3 of 3 acceptance criteria pass. Draft PR #815 is ready for you to review and mark ready.

Four stations, one line<br>Each station is a declared subagent with its own instructions, sandbox, and tools, and returns a structured result the next one builds on.

Classifier

Triages the work item and decides what counts as trivial, so the orchestrator never guesses.

Analyst

Plans against a live checkout of your repository, ending in testable acceptance criteria.

Implementer

Executes the plan in its own sandbox, verifies with your repo's own checks, and pushes a branch.

Reviewer

Independently judges every acceptance criterion against the real diff, with evidence for each verdict.

Work arrives from wherever it lives<br>Six surfaces feed the same pipeline.

Label an issue<br>onIssue<br>Add the factory label and the pipeline runs unattended, ending in a draft PR.

@mention Foreman<br>onComment<br>Mention Foreman on an issue or PR to start an attended session.

Delegate in Linear<br>onAgentSession<br>Assign Foreman a Linear issue and it reports back as Agent Activities.

Red CI on PRs<br>onCheckSuite<br>Foreman diagnoses failed checks on its own PRs and pushes a fix.

PR summaries<br>onPullRequest<br>Every newly opened PR gets one orienting comment for reviewers.

Dev TUI<br>pnpm dev<br>Hand Foreman a work item locally and approve each write yourself.

Nothing ships without you<br>Unattended runs stop at a draft pull request. Anything that ships waits for a person, and merging isn't in Foreman's tool surface at all.

Approval Required

Foreman wants to mark draft PR #815 ready for review.<br>github_updatePullRequest

ApproveDeny

factory-brain/.md<br># Factory brain: your-org/your-repo

## Build<br>- Integration tests need the local Postgres from `pnpm db:up` first.<br>- `pnpm typecheck` is the slow one; lint and unit tests are cheap.

## Recurring review findings<br>- Server code assumes UTC; client bugs cluster around local-time math.<br>- New endpoints must register in `api/router.ts` or 404 in prod.

A factory that learns your repository<br>Foreman keeps durable notes on your repo, including build quirks, verification steps, and recurring review findings. It reads them at the start of every run, so the second run starts where the first left off.

Put agents on the assembly line<br>svg]:px-4 w-fit rounded-full" href="/en/docs">Read the docssvg]:px-4 w-fit rounded-full">Deploy now