Skip to content

REQ 010

sergio velderrain edited this page Nov 9, 2026 · 1 revision

REQ-010: Branch governance follows GitFlow per ADR-0001

Requirement

This repository's branch governance shall follow GitFlow (develop, feature/*, release/*, hotfix/*), per ADR-0001.

Rationale

Required to satisfy repo-standards-review's CM gate, per operator decision (VITechnologies/projectbuddy#6).

Fit Criterion

A develop branch exists alongside main; releases are cut via release/vX.Y.Z branches merged to both main and develop (or confirmed as a legitimate no-op merge-back if the two are already content-identical), never tagged directly off ad-hoc commits to main.

Verification

Live-verified: v0.3.9-v0.3.27 were all cut through the full release/* flow (see docs/release/release-procedure.md and each release's own PR history). v0.3.28 has one disclosed, judged exception (a non-release PR landed directly on main after its release branch's own promotion, to ship a real-CI-dispatch-discovered parse-error fix without cutting a second release branch for one two-line change) -- recorded in docs/cm/cm-plan.md's Status Accounting section, not a silent deviation.

Source

Software-Requirements-Specification

Priority

High

TestID

TEST-010

TestArtifact

Live: v0.3.9-v0.3.27 cut via full release/* flow; v0.3.28 has one disclosed, judged exception (a post-release-branch direct-to-main fix, see docs/cm/cm-plan.md Status Accounting)

CodeRef

docs/release/release-procedure.md, docs/architecture/adr/ADR-0001-adopt-gitflow-for-release-governance.md

Status

Verified (live), with 1 disclosed exception

Clone this wiki locally