diff --git a/.github/issue-types.yml b/.github/issue-types.yml index fbc5c53c7..3565c7ec3 100644 --- a/.github/issue-types.yml +++ b/.github/issue-types.yml @@ -83,9 +83,9 @@ issue_types: - name: Support color: 0E8A16 label: type:support - - name: Help - color: 0E8A16 - label: type:help - name: User Experience Feedback color: "5319E7" label: type:ux-feedback + - name: Help + color: 0E8A16 + label: type:help diff --git a/CLAUDE.md b/CLAUDE.md index 491f7d380..befaedb8b 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,8 +1,8 @@ --- title: "LightSpeed .github — Claude Instructions" description: "Claude-specific project instructions for the LightSpeed .github repository." -version: 'v1.2' -last_updated: '2026-06-01' +version: "v1.2" +last_updated: "2026-06-01" file_type: "agents-index" maintainer: "LightSpeed Team" --- @@ -40,6 +40,54 @@ It also hosts **portable AI operations assets** in top-level source folders that Do **not** place reusable assets under `.github/`—use the matching top-level folder instead. +## Git & Branching Strategy + +> **CRITICAL:** This repository follows a strict branching discipline. Read [docs/BRANCHING_STRATEGY.md](./docs/BRANCHING_STRATEGY.md) before opening any PR. + +### Protected Branches + +- `main` is **always production-ready**. Never push directly to `main` unless performing a **release cycle**. +- `develop` (if used) is an integration branch. Never push directly to `develop` outside release/hotfix workflows. +- All other work goes to feature/fix/chore branches. + +### Branch Naming Convention + +Use the format: `{type}/{scope}-{short-title}` (lowercase, kebab-case) + +**Common prefixes:** + +- `feat/` — new feature or capability +- `fix/` — bug fix +- `hotfix/` — urgent production fix (branches from `main`) +- `chore/` — maintenance, refactoring, dependency updates +- `docs/` — documentation changes +- `ci/` — CI/CD workflow changes +- `test/` — test-only changes +- `refactor/` — code restructure +- `security/` — security fixes + +**Examples:** + +``` +chore/readme-frontmatter-standardization +fix/invalid-branch-name-validation +docs/update-contributing-guide +release/v1.2.0 +``` + +**Branch protection enforcement:** + +- All PRs require branch names matching the regex pattern +- CI will block misnamed branches from merging +- Rename with `git branch -m ` if needed + +### Before Every Push + +1. Verify the current branch: `git branch -v` +2. Confirm it is NOT `main` or `develop` (unless in a release cycle) +3. Ensure the branch name follows the `{type}/{scope}-{short-title}` pattern +4. Use: `git push -u origin ` + ## Development Commands ```bash