KNEL/LLMScaffolding
1
0
Fork 0
Code Issues Pull Requests 1 Actions 11 Packages Projects Releases 1 Wiki Activity
Files
bootstrap-org
LLMScaffolding/docs/git-workflow.md
ReachableCEO ca8905fa4e
Some checks are pending
CI / checks (pull_request) Waiting to run
Details
chore(repo): clean root and move docs 
- Move docs to docs/; keep areas for prompts only
- Relocate Makefile to scripts/Makefile; update docs to use it
- Move ci.Dockerfile to docker/ci.Dockerfile; update compose
- Move commitlint config to .config and update hook
- Remove root AGENTS.md (use area AGENTS.md)
2025-09-11 07:01:24 -05:00

1.6 KiB
Raw Permalink Blame History

Git Workflow – Finalized Instructions

Scope

  • Applies across projects. Contributors work via branches/PRs. CI/CD is Gitea‑native.

Branches

  • main: production; default branch. Protected.
  • integration: development (unprotected; merges auto on green).
  • Working branches: feature/<topic>, fix/<topic>, chore/<topic> from integration.
  • Hotfix: hotfix/<date> from main; PR back to main, then forward‑merge into integration.
  • Release branch: ephemeral or lightweight release/*. Protect when present; may fast‑forward to latest tag via CI.

Merges & Approvals

  • Feature → integration: squash merge; auto‑merge on green (no human approval). Self‑merge allowed.
  • integration → main: squash merge; require 1 approval; self‑merge not allowed.
  • Force pushes disabled on protected branches (main, release/*); PRs required.

Commit Style

  • Conventional Commits for PR titles and commit messages.

Versioning & Tags

  • Calendar tags: vYYYY.MM.DD-HHMM (UTC) for traceability.
  • Release tags: semantic or milestone tags (e.g., v0.0.1-Bootstrap).

Release Flow

  1. Feature branches PR into integration; checks pass → auto‑merge.
  2. PR integration → main; 1 approval required; on merge, deploy and tag release.
  3. Optional: CI fast‑forwards a release branch pointer to the new tag.

Protected Checks (enable when runners are ready)

  • On protected branches (main, release/*): ci / lint, ci / build, ci / commitlint. Add ci / test and ci / security when introduced.

CODEOWNERS

  • Keep minimal; require review for integration → main.

Notes

  • No secrets in this base repo. Future repos should integrate Vault for secrets.