--- name: fireworks-devops description: Git, CI/CD, and deployment superbrain — conventional commits, PR workflows, Electron packaging, release management version: 1.0.0 author: mneme tags: [git, ci-cd, devops, packaging, releases, electron-builder, github-actions] triggers: [git, commit, PR, pull request, release, deploy, package, build, CI, CD, pipeline, changelog] --- # Fireworks DevOps — Git, CI/CD & Deployment Superbrain > Conventional commits. PR workflows. Electron packaging. Release management. CI/CD pipeline design. Documentation sync. Everything from commit to customer. --- ## 1. Git Workflow Protocol ### Branch Naming Convention ``` Feature: feat/short-description Bug fix: fix/short-description Refactor: refactor/short-description Docs: docs/short-description Test: test/short-description Chore: chore/short-description Hotfix: hotfix/short-description Release: release/vX.Y.Z ``` Rules: - All lowercase, hyphens to separate words - Keep it short but descriptive (max 50 characters) - Include ticket/issue number if applicable: `feat/123-add-invoice-export` - Never work directly on `main` — always branch ### Conventional Commits ``` Format: (): Types: feat: New feature (triggers MINOR version bump) fix: Bug fix (triggers PATCH version bump) refactor: Code change that neither fixes a bug nor adds a feature docs: Documentation only changes test: Adding or correcting tests chore: Build process, auxiliary tool changes perf: Performance improvement style: Code style (formatting, semicolons, etc.) ci: CI/CD configuration changes build: Build system or external dependency changes Scope (optional): The area of the codebase affected feat(inventory): add barcode scanner support fix(reports): correct profit margin calculation refactor(ipc): simplify channel registration Description: - Imperative mood: "add" not "added" or "adds" - Lowercase first letter - No period at the end - Maximum 72 characters for the subject line ``` ### Commit Message Structure ``` (): ← blank line ← explain WHY, not WHAT ← focus on motivation and context ← blank line