start-vibing 2.0.11 → 2.0.12

package/template/.claude/skills/git-workflow/SKILL.md

@@ -1,454 +1,454 @@
----
-name: git-workflow
-description: Git workflow patterns and best practices. Branch management, conventional commits, PR creation, hooks. Use when working with git operations.
-allowed-tools: Bash, Read, Grep, Glob
----
-
-# Git Workflow - Version Control Best Practices
-
-## Purpose
-
-Expert guidance for Git:
-
-- **Branch Management** - Feature, fix, release branches
-- **Conventional Commits** - Standardized commit messages
-- **Pull Requests** - Well-formatted PRs with gh CLI
-- **Git Hooks** - Automated quality gates
-- **Merge Strategies** - Rebase, squash, merge
-
----
-
-## Branch Naming Conventions
-
-### Format
-
-```
-<type>/<description>
-```
-
-### Types
-
-| Type        | Use Case               |
-| ----------- | ---------------------- |
-| `feature/`  | New functionality      |
-| `fix/`      | Bug fixes              |
-| `refactor/` | Code restructuring     |
-| `test/`     | Test additions/changes |
-| `docs/`     | Documentation only     |
-| `chore/`    | Maintenance tasks      |
-
-### Examples
-
-```bash
-feature/user-authentication
-feature/add-dark-mode
-fix/login-validation-error
-fix/memory-leak-dashboard
-refactor/api-client-structure
-test/e2e-checkout-flow
-docs/api-documentation
-chore/update-dependencies
-```
-
----
-
-## Branch Workflow
-
-### Create Feature Branch
-
-```bash
-# From main branch
-git checkout main
-git pull origin main
-
-# Create and switch to new branch
-git checkout -b feature/my-feature
-
-# Alternative
-git switch -c feature/my-feature
-```
-
-### Keep Branch Updated
-
-```bash
-# Fetch latest changes
-git fetch origin
-
-# Rebase on main
-git rebase origin/main
-
-# If conflicts, resolve and continue
-git add .
-git rebase --continue
-
-# Or abort if needed
-git rebase --abort
-```
-
-### Push Branch
-
-```bash
-# First push (set upstream)
-git push -u origin feature/my-feature
-
-# Subsequent pushes
-git push
-
-# After rebase (force with lease is safer)
-git push --force-with-lease
-```
-
----
-
-## Conventional Commits
-
-### Format
-
-```
-<type>(<scope>): <description>
-
-[optional body]
-
-[optional footer]
-```
-
-### Types
-
-| Type       | Description                 |
-| ---------- | --------------------------- |
-| `feat`     | New feature for the user    |
-| `fix`      | Bug fix for the user        |
-| `docs`     | Documentation only          |
-| `style`    | Formatting, no code change  |
-| `refactor` | Code change, no feature/fix |
-| `perf`     | Performance improvement     |
-| `test`     | Adding/updating tests       |
-| `chore`    | Maintenance, deps update    |
-| `ci`       | CI/CD changes               |
-| `build`    | Build system changes        |
-
-### Examples
-
-```bash
-# Feature
-git commit -m "feat(auth): add OAuth2 Google login"
-
-# Fix
-git commit -m "fix(cart): prevent duplicate items on rapid click"
-
-# With body (use HEREDOC for multi-line)
-git commit -m "$(cat <<'EOF'
-feat(api): add rate limiting middleware
-
-- Implement token bucket algorithm
-- Add configurable limits per endpoint
-- Include bypass for authenticated users
-
-Closes #123
-EOF
-)"
-```
-
-### Scopes (Project-Specific)
-
-```
-api, auth, cart, checkout, dashboard, db, docker, ui, tests
-```
-
----
-
-## Commit Message Template
-
-```bash
-# Set up template
-git config commit.template .gitmessage
-
-# .gitmessage file
-# <type>(<scope>): <description>
-#
-# [body - explain what and why]
-#
-# [footer - issue references]
-#
-# Types: feat, fix, docs, style, refactor, perf, test, chore, ci, build
-# Scopes: api, auth, ui, db, tests, docker, etc.
-```
-
----
-
-## Pull Request Creation
-
-### Using GitHub CLI
-
-```bash
-# Create PR with title and body
-gh pr create --title "feat(auth): add OAuth2 Google login" --body "$(cat <<'EOF'
-## Summary
-- Implements Google OAuth2 authentication
-- Adds login button to auth page
-- Stores OAuth tokens securely
-
-## Changes
-- `src/auth/oauth.ts` - OAuth client implementation
-- `src/pages/login.tsx` - UI integration
-- `src/types/auth.ts` - New auth types
-
-## Test Plan
-- [ ] Login with Google account
-- [ ] Verify session persists
-- [ ] Test logout flow
-- [ ] Check token refresh
-
-## Screenshots
-[If applicable]
-EOF
-)"
-
-# Create draft PR
-gh pr create --draft --title "WIP: feature name"
-
-# Create PR with specific base branch
-gh pr create --base develop --title "feat: ..."
-
-# Create PR and assign reviewers
-gh pr create --title "feat: ..." --reviewer user1,user2
-
-# Create PR with labels
-gh pr create --title "feat: ..." --label "enhancement,priority:high"
-```
-
-### PR Template
-
-```markdown
-## Summary
-
-[Brief description of changes]
-
-## Type of Change
-
-- [ ] Feature (new functionality)
-- [ ] Bug fix (fixes an issue)
-- [ ] Refactor (code change, no feature/fix)
-- [ ] Documentation
-- [ ] Tests
-
-## Changes Made
-
-- [Change 1]
-- [Change 2]
-
-## Test Plan
-
-- [ ] Unit tests pass
-- [ ] E2E tests pass
-- [ ] Manual testing done
-
-## Screenshots
-
-[If UI changes]
-
-## Checklist
-
-- [ ] Code follows project style
-- [ ] Self-review completed
-- [ ] Documentation updated
-- [ ] Tests added/updated
-```
-
----
-
-## Git Hooks (Husky)
-
-### Setup
-
-```bash
-# Install Husky
-bun add -D husky lint-staged
-
-# Initialize
-bunx husky init
-
-# Create hooks
-echo "bun run lint-staged" > .husky/pre-commit
-echo "bun run typecheck" > .husky/pre-push
-```
-
-### lint-staged Configuration
-
-```json
-// package.json
-{
-	"lint-staged": {
-		"*.{ts,tsx}": ["eslint --fix", "prettier --write"],
-		"*.{json,md}": ["prettier --write"]
-	}
-}
-```
-
-### Commit Message Hook
-
-```bash
-# .husky/commit-msg
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-bunx --no -- commitlint --edit "$1"
-```
-
-### commitlint Configuration
-
-```javascript
-// commitlint.config.js
-export default {
-	extends: ['@commitlint/config-conventional'],
-	rules: {
-		'type-enum': [
-			2,
-			'always',
-			['feat', 'fix', 'docs', 'style', 'refactor', 'perf', 'test', 'chore', 'ci', 'build'],
-		],
-		'scope-enum': [1, 'always', ['api', 'auth', 'ui', 'db', 'tests', 'docker']],
-		'subject-case': [2, 'always', 'lower-case'],
-		'body-max-line-length': [2, 'always', 100],
-	},
-};
-```
-
----
-
-## Merge Strategies
-
-### Squash Merge (Recommended for Features)
-
-```bash
-# Combines all commits into one
-gh pr merge --squash
-
-# Result: Clean main history
-```
-
-### Rebase Merge (For Clean History)
-
-```bash
-# Replays commits on top of base
-gh pr merge --rebase
-
-# Result: Linear history, individual commits preserved
-```
-
-### Merge Commit (For Preserving History)
-
-```bash
-# Creates merge commit
-gh pr merge --merge
-
-# Result: Preserves full branch history
-```
-
-### Recommendation
-
-| Branch Type | Strategy |
-| ----------- | -------- |
-| feature/\*  | Squash   |
-| fix/\*      | Squash   |
-| release/\*  | Merge    |
-| hotfix/\*   | Merge    |
-
----
-
-## Useful Git Commands
-
-### Status & Diff
-
-```bash
-# Status
-git status
-
-# Diff unstaged
-git diff
-
-# Diff staged
-git diff --staged
-
-# Diff between branches
-git diff main..feature/my-feature
-```
-
-### History
-
-```bash
-# Recent commits
-git log --oneline -10
-
-# Commits in branch not in main
-git log main..HEAD --oneline
-
-# Files changed in last commit
-git diff-tree --no-commit-id --name-only -r HEAD
-
-# Who changed a file
-git blame src/file.ts
-```
-
-### Undo Changes
-
-```bash
-# Unstage file
-git reset HEAD file.ts
-
-# Discard local changes
-git checkout -- file.ts
-
-# Undo last commit (keep changes)
-git reset --soft HEAD~1
-
-# Undo last commit (discard changes)
-git reset --hard HEAD~1
-```
-
-### Stash
-
-```bash
-# Stash changes
-git stash
-
-# Stash with message
-git stash push -m "WIP: feature X"
-
-# List stashes
-git stash list
-
-# Apply latest stash
-git stash pop
-
-# Apply specific stash
-git stash apply stash@{2}
-```
-
----
-
-## Agent Integration
-
-This skill is used by:
-
-- **commit-manager** agent
-- **branch-manager** agent
-- **pr-creator** agent
-- **quality-checker** for pre-commit validation
-
----
-
-## FORBIDDEN
-
-1. **Force push to main/master** - Never without explicit permission
-2. **Commit directly to main** - Use feature branches
-3. **Skip hooks** - Don't use `--no-verify` unless absolutely necessary
-4. **Vague commit messages** - Be specific and descriptive
-5. **Large unrelated changes in one commit** - Keep commits focused
-6. **Committing secrets** - Never commit .env, tokens, passwords
-
----
-
-## Version
-
-- **v1.0.0** - Initial implementation based on 2024-2025 Git workflow patterns
+---
+name: git-workflow
+description: Git workflow patterns and best practices. Branch management, conventional commits, PR creation, hooks. Use when working with git operations.
+allowed-tools: Bash, Read, Grep, Glob
+---
+
+# Git Workflow - Version Control Best Practices
+
+## Purpose
+
+Expert guidance for Git:
+
+- **Branch Management** - Feature, fix, release branches
+- **Conventional Commits** - Standardized commit messages
+- **Pull Requests** - Well-formatted PRs with gh CLI
+- **Git Hooks** - Automated quality gates
+- **Merge Strategies** - Rebase, squash, merge
+
+---
+
+## Branch Naming Conventions
+
+### Format
+
+```
+<type>/<description>
+```
+
+### Types
+
+| Type        | Use Case               |
+| ----------- | ---------------------- |
+| `feature/`  | New functionality      |
+| `fix/`      | Bug fixes              |
+| `refactor/` | Code restructuring     |
+| `test/`     | Test additions/changes |
+| `docs/`     | Documentation only     |
+| `chore/`    | Maintenance tasks      |
+
+### Examples
+
+```bash
+feature/user-authentication
+feature/add-dark-mode
+fix/login-validation-error
+fix/memory-leak-dashboard
+refactor/api-client-structure
+test/e2e-checkout-flow
+docs/api-documentation
+chore/update-dependencies
+```
+
+---
+
+## Branch Workflow
+
+### Create Feature Branch
+
+```bash
+# From main branch
+git checkout main
+git pull origin main
+
+# Create and switch to new branch
+git checkout -b feature/my-feature
+
+# Alternative
+git switch -c feature/my-feature
+```
+
+### Keep Branch Updated
+
+```bash
+# Fetch latest changes
+git fetch origin
+
+# Rebase on main
+git rebase origin/main
+
+# If conflicts, resolve and continue
+git add .
+git rebase --continue
+
+# Or abort if needed
+git rebase --abort
+```
+
+### Push Branch
+
+```bash
+# First push (set upstream)
+git push -u origin feature/my-feature
+
+# Subsequent pushes
+git push
+
+# After rebase (force with lease is safer)
+git push --force-with-lease
+```
+
+---
+
+## Conventional Commits
+
+### Format
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer]
+```
+
+### Types
+
+| Type       | Description                 |
+| ---------- | --------------------------- |
+| `feat`     | New feature for the user    |
+| `fix`      | Bug fix for the user        |
+| `docs`     | Documentation only          |
+| `style`    | Formatting, no code change  |
+| `refactor` | Code change, no feature/fix |
+| `perf`     | Performance improvement     |
+| `test`     | Adding/updating tests       |
+| `chore`    | Maintenance, deps update    |
+| `ci`       | CI/CD changes               |
+| `build`    | Build system changes        |
+
+### Examples
+
+```bash
+# Feature
+git commit -m "feat(auth): add OAuth2 Google login"
+
+# Fix
+git commit -m "fix(cart): prevent duplicate items on rapid click"
+
+# With body (use HEREDOC for multi-line)
+git commit -m "$(cat <<'EOF'
+feat(api): add rate limiting middleware
+
+- Implement token bucket algorithm
+- Add configurable limits per endpoint
+- Include bypass for authenticated users
+
+Closes #123
+EOF
+)"
+```
+
+### Scopes (Project-Specific)
+
+```
+api, auth, cart, checkout, dashboard, db, docker, ui, tests
+```
+
+---
+
+## Commit Message Template
+
+```bash
+# Set up template
+git config commit.template .gitmessage
+
+# .gitmessage file
+# <type>(<scope>): <description>
+#
+# [body - explain what and why]
+#
+# [footer - issue references]
+#
+# Types: feat, fix, docs, style, refactor, perf, test, chore, ci, build
+# Scopes: api, auth, ui, db, tests, docker, etc.
+```
+
+---
+
+## Pull Request Creation
+
+### Using GitHub CLI
+
+```bash
+# Create PR with title and body
+gh pr create --title "feat(auth): add OAuth2 Google login" --body "$(cat <<'EOF'
+## Summary
+- Implements Google OAuth2 authentication
+- Adds login button to auth page
+- Stores OAuth tokens securely
+
+## Changes
+- `src/auth/oauth.ts` - OAuth client implementation
+- `src/pages/login.tsx` - UI integration
+- `src/types/auth.ts` - New auth types
+
+## Test Plan
+- [ ] Login with Google account
+- [ ] Verify session persists
+- [ ] Test logout flow
+- [ ] Check token refresh
+
+## Screenshots
+[If applicable]
+EOF
+)"
+
+# Create draft PR
+gh pr create --draft --title "WIP: feature name"
+
+# Create PR with specific base branch
+gh pr create --base develop --title "feat: ..."
+
+# Create PR and assign reviewers
+gh pr create --title "feat: ..." --reviewer user1,user2
+
+# Create PR with labels
+gh pr create --title "feat: ..." --label "enhancement,priority:high"
+```
+
+### PR Template
+
+```markdown
+## Summary
+
+[Brief description of changes]
+
+## Type of Change
+
+- [ ] Feature (new functionality)
+- [ ] Bug fix (fixes an issue)
+- [ ] Refactor (code change, no feature/fix)
+- [ ] Documentation
+- [ ] Tests
+
+## Changes Made
+
+- [Change 1]
+- [Change 2]
+
+## Test Plan
+
+- [ ] Unit tests pass
+- [ ] E2E tests pass
+- [ ] Manual testing done
+
+## Screenshots
+
+[If UI changes]
+
+## Checklist
+
+- [ ] Code follows project style
+- [ ] Self-review completed
+- [ ] Documentation updated
+- [ ] Tests added/updated
+```
+
+---
+
+## Git Hooks (Husky)
+
+### Setup
+
+```bash
+# Install Husky
+bun add -D husky lint-staged
+
+# Initialize
+bunx husky init
+
+# Create hooks
+echo "bun run lint-staged" > .husky/pre-commit
+echo "bun run typecheck" > .husky/pre-push
+```
+
+### lint-staged Configuration
+
+```json
+// package.json
+{
+	"lint-staged": {
+		"*.{ts,tsx}": ["eslint --fix", "prettier --write"],
+		"*.{json,md}": ["prettier --write"]
+	}
+}
+```
+
+### Commit Message Hook
+
+```bash
+# .husky/commit-msg
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+bunx --no -- commitlint --edit "$1"
+```
+
+### commitlint Configuration
+
+```javascript
+// commitlint.config.js
+export default {
+	extends: ['@commitlint/config-conventional'],
+	rules: {
+		'type-enum': [
+			2,
+			'always',
+			['feat', 'fix', 'docs', 'style', 'refactor', 'perf', 'test', 'chore', 'ci', 'build'],
+		],
+		'scope-enum': [1, 'always', ['api', 'auth', 'ui', 'db', 'tests', 'docker']],
+		'subject-case': [2, 'always', 'lower-case'],
+		'body-max-line-length': [2, 'always', 100],
+	},
+};
+```
+
+---
+
+## Merge Strategies
+
+### Squash Merge (Recommended for Features)
+
+```bash
+# Combines all commits into one
+gh pr merge --squash
+
+# Result: Clean main history
+```
+
+### Rebase Merge (For Clean History)
+
+```bash
+# Replays commits on top of base
+gh pr merge --rebase
+
+# Result: Linear history, individual commits preserved
+```
+
+### Merge Commit (For Preserving History)
+
+```bash
+# Creates merge commit
+gh pr merge --merge
+
+# Result: Preserves full branch history
+```
+
+### Recommendation
+
+| Branch Type | Strategy |
+| ----------- | -------- |
+| feature/\*  | Squash   |
+| fix/\*      | Squash   |
+| release/\*  | Merge    |
+| hotfix/\*   | Merge    |
+
+---
+
+## Useful Git Commands
+
+### Status & Diff
+
+```bash
+# Status
+git status
+
+# Diff unstaged
+git diff
+
+# Diff staged
+git diff --staged
+
+# Diff between branches
+git diff main..feature/my-feature
+```
+
+### History
+
+```bash
+# Recent commits
+git log --oneline -10
+
+# Commits in branch not in main
+git log main..HEAD --oneline
+
+# Files changed in last commit
+git diff-tree --no-commit-id --name-only -r HEAD
+
+# Who changed a file
+git blame src/file.ts
+```
+
+### Undo Changes
+
+```bash
+# Unstage file
+git reset HEAD file.ts
+
+# Discard local changes
+git checkout -- file.ts
+
+# Undo last commit (keep changes)
+git reset --soft HEAD~1
+
+# Undo last commit (discard changes)
+git reset --hard HEAD~1
+```
+
+### Stash
+
+```bash
+# Stash changes
+git stash
+
+# Stash with message
+git stash push -m "WIP: feature X"
+
+# List stashes
+git stash list
+
+# Apply latest stash
+git stash pop
+
+# Apply specific stash
+git stash apply stash@{2}
+```
+
+---
+
+## Agent Integration
+
+This skill is used by:
+
+- **commit-manager** agent
+- **branch-manager** agent
+- **pr-creator** agent
+- **quality-checker** for pre-commit validation
+
+---
+
+## FORBIDDEN
+
+1. **Force push to main/master** - Never without explicit permission
+2. **Commit directly to main** - Use feature branches
+3. **Skip hooks** - Don't use `--no-verify` unless absolutely necessary
+4. **Vague commit messages** - Be specific and descriptive
+5. **Large unrelated changes in one commit** - Keep commits focused
+6. **Committing secrets** - Never commit .env, tokens, passwords
+
+---
+
+## Version
+
+- **v1.0.0** - Initial implementation based on 2024-2025 Git workflow patterns