Forge is pre-1.0 and under active development — usable for evaluation and self-host testing, not yet for production. See
RELEASE_READINESS.mdfor the honest per-area status.
Start here and follow the path that fits you.
| Doc | What it covers |
|---|---|
| Getting started | From a clone to your first orchestrated run in ~15 minutes |
| Concepts | The mental model: specs, workflows, agents, runs, knowledge, approvals, policies + a glossary |
| Architecture | Services, package map, and how a change flows through the platform |
| Doc | What it covers |
|---|---|
| BYOK & bring-your-own board | Model-provider keys, reranker, and syncing to Jira / Linear / Asana / Monday / GitHub Projects / ClickUp / Trello / GitLab |
| Runbooks | Live setup for GitHub App, model providers, reranker, MCP, and Slack |
| Examples | Copy-paste, schema-validated policies, skills, workflows, MCP connectors, and specs |
| Doc | What it covers |
|---|---|
| Self-hosting quickstart | Single-host Docker Compose walkthrough |
| Docker Compose (production) | Hardened, digest-pinned production stack |
| Kubernetes / Helm | Clustered deployment |
| Infrastructure as Code | OpenTofu apply for Hetzner + Cloudflare + Fly.io (dev/staging/prod) |
| Backup · Restore · Upgrade | Day-2 operations |
| Observability · Reliability · Performance | Running it well |
| Troubleshooting | When something won't come up |
| Doc | What it covers |
|---|---|
| Security policy | How to report a vulnerability |
| Threat model | STRIDE threat model |
| Self-hosting security | Secret management + hardening |
| Doc | What it covers |
|---|---|
| Platform specification | The full Forge spec |
| Release readiness | Automated gate status at the beta bar |
| Eval results | Real-corpus retrieval evaluation |
Contributions go through pull requests — see CONTRIBUTING.md and the Code of Conduct.