Foreman: An agent supervisor and software factory foreman

Foreman: An agent supervisor and software factory foreman thruwire / foreman Public Notifications You must be signed in to change notification settings Fork 45 Star 576 Branches Tags Open more actions menu Latest commit History 18 Commits 18 Commits Folders and files Name Name Last commit message Last commit date .github .github docs docs src/ foreman src/ foreman tests tests .env.example .env.example .gitignore .gitignore CODE_OF_CONDUCT.md CODE_OF_CONDUCT.md CONTRIBUTING.md CONTRIBUTING.md LICENSE LICENSE README.md README.md SECURITY.md SECURITY.md pyproject.toml pyproject.toml Repository files navigation Foreman Foreman watches the software factory floor with TypeSafe AI's Jev , placing a fast decision model above slower coding agents. Give it a ticket, specification, bug report, or any free-form software job.

This PolicyChange is relevant to the technology intelligence record because it involves GitHub. The source article should remain the factual reference for follow-up coverage.

• thruwire / foreman Public Notifications You must be signed in to change notification settings Fork 45 Star 576 Branches Tags Open more actions menu Latest commit History 18 Commits 18 Commits Folders and files Name Name Last commit message Last commit date .github .github docs docs src/ foreman src/ foreman tests tests .env.example .env.example .gitignore .gitignore CODE_OF_CONDUCT.md CODE_OF_CONDUCT.md CONTRIBUTING.md CONTRIBUTING.md LICENSE LICENSE README.md README.md SECURITY.md SECURITY.md pyproject.toml pyproject.toml Repository files navigation Foreman Foreman watches the software factory floor with TypeSafe AI's Jev , placing a fast decision model above slower coding agents.
• Give it a ticket, specification, bug report, or any free-form software job.
• A Codex or OpenCode worker does the software engineering while Foreman independently assesses whether the implementation is complete, requirements are satisfied, tests are sufficient, verification is needed, or human input is required.
• SOFTWARE FACTORY Codex/OpenCode Codex/OpenCode Tests worker worker │ │ │ │ └──────────────────┼──────────────────┘ │ factory evidence ▼ FOREMAN Jev │ ▼ responsibilities completion implementation_complete .91 requirements_satisfied .79 ready_to_finish .21 verification tests_sufficient .34 needs_verification .82 worker health worker_stuck .02 work_off_track .06 meaningful_progress .94 repository instructions agents_md_drift .01 human escalation needs_human .01 │ ▼ continue / steer / stop / retry verify / finish Generative models work.
• Foreman is an architectural experiment, not a claim that this design is already better than a conventional coding-agent harness.
• Documentation Theory: semantic supervision Why Jev fits the experiment What Foreman is proving Runtime and event flow Responsibility configuration and routing Extensions Coding-assistant hooks and attached workers Live steering Worker backends Contributing Contributions are welcome.