Skip to content

git-flow.md

Latest commit

 

History

History
47 lines (32 loc) · 1.46 KB

git-flow.md

File metadata and controls

47 lines (32 loc) · 1.46 KB

Git Flow

Language: English | 简体中文

Docs: Index · Architecture · OAuth Setup · Privacy Boundary

Branch Model

  • Long-lived branches: main, dev
  • Feature branches: feat/* or feature/* (branch from dev)

Daily Workflow

  1. Create a feature branch from dev.
  2. Implement changes in small, reviewable commits.
  3. Run targeted tests first, then full suite:
go test ./...
go test -race ./...
  1. Open PR into dev.
  2. After validation, merge dev into main for release.

Commit Convention

Use Angular-style conventional commits:

  • feat: new user-visible capability
  • fix: behavior correction
  • docs: documentation only
  • chore: tooling or maintenance
  • Agent-authored commits must include: Co-authored-by: opencode-agent[bot] <opencode-agent[bot]@users.noreply.github.com>

Examples:

  • feat: add oauth device login command
  • fix: map upstream 5xx to gateway 502
  • docs: add oauth setup guide

Release Workflow

  • Tag releases from main as v* (for example v0.1.0).
  • Tag push triggers .github/workflows/package.yml, which runs go test ./... and go test -race ./... before packaging.
  • Release build targets: macos-arm, windows-x64, linux-x64, linux-arm.
  • Each release archive includes: binary, README.md, README.zh-CN.md, and config.example.yaml.