docs(multi-forge): add runbook + adoption guide (MF-9) #310

claude-desktop · 2026-04-24T09:37:57Z

claude-desktop commented

2026-04-24 09:37:57 +00:00

Summary

New docs/multi-forge.md runbook covering operator overview, step-by-step adoption for a GitHub repo and a GitLab repo, cross-forge routing matrix (deps, label IDs, auth scheme, review model, squash merge, webhook sig), troubleshooting of real startup-validator / adapter error strings, and the per-forge webhook-secret uniqueness requirement (plus the FORGEJO_ACCESS_TOKEN scoping note).
CLAUDE.md gains a one-line pointer under a new Multi-forge section, mirroring the existing Multi-repo / Penpot sections.
Docs-only; cites actual config keys (token_files, github_webhook_secret_file, gitlab_webhook_secret_file) and actual source paths (adapter-factory.ts, webhook-config.ts, agent-runner.ts, gitlab-adapter.ts).

Test plan

docs/multi-forge.md renders correctly on forge.jacquin.app (headings, tables, code fences, relative links to multi-repo.md and ../specs/multi-forge.md).
CLAUDE.md Multi-forge section renders with a working link to docs/multi-forge.md.

Closes #300

## Summary - New `docs/multi-forge.md` runbook covering operator overview, step-by-step adoption for a GitHub repo and a GitLab repo, cross-forge routing matrix (deps, label IDs, auth scheme, review model, squash merge, webhook sig), troubleshooting of real startup-validator / adapter error strings, and the per-forge webhook-secret uniqueness requirement (plus the `FORGEJO_ACCESS_TOKEN` scoping note). - `CLAUDE.md` gains a one-line pointer under a new **Multi-forge** section, mirroring the existing Multi-repo / Penpot sections. - Docs-only; cites actual config keys (`token_files`, `github_webhook_secret_file`, `gitlab_webhook_secret_file`) and actual source paths (`adapter-factory.ts`, `webhook-config.ts`, `agent-runner.ts`, `gitlab-adapter.ts`). ## Test plan - [ ] `docs/multi-forge.md` renders correctly on forge.jacquin.app (headings, tables, code fences, relative links to `multi-repo.md` and `../specs/multi-forge.md`). - [ ] `CLAUDE.md` Multi-forge section renders with a working link to `docs/multi-forge.md`. Closes #300

claude-desktop added 1 commit

2026-04-24 09:37:57 +00:00

docs(multi-forge): add runbook + adoption guide (MF-9)

qa / qa (pull_request) Successful in 3m53s

Details

qa / dockerfile (pull_request) Successful in 8s

Details

ab96ad14fa

New `docs/multi-forge.md` walks operators through adding a GitHub or
GitLab repo to an existing Forgejo deployment — PAT scopes, token-file
layout, `config/agents.json` extensions, per-forge webhook setup,
routing differences, troubleshooting, and the per-forge webhook-secret
uniqueness requirement. CLAUDE.md gains a one-line pointer under a new
"Multi-forge" section.

Closes #300

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

code-lead merged commit 4b6380ded5 into main

2026-04-24 09:43:15 +00:00

code-lead deleted branch feat/300-mf9-multi-forge-docs

2026-04-24 09:43:16 +00:00

code-lead referenced this pull request from a commit

2026-04-24 09:43:17 +00:00

docs(multi-forge): add runbook + adoption guide (MF-9) (#310)

Sign in to join this conversation.

No reviewers