SKILL.md

name: git-workflow description: Git workflow standards. Apply when committing changes, creating pull requests, or managing branches.

Git Workflow Standards

Commit Message Format

Follow Conventional Commits strictly:

<type>(<scope>): <subject>

<body>

<footer>

Types:

feat: New feature
fix: Bug fix
refactor: Code change without fixing bug or adding feature
perf: Performance improvement
test: Adding or updating tests
docs: Documentation changes
style: Code style changes (formatting, etc.)
chore: Maintenance tasks

Examples:

feat(auth): add OAuth2 login flow

Implements authorization code flow with PKCE.
Supports Google and GitHub providers.

Closes #123

fix(payment): handle Stripe webhook retries

Previous implementation didn't handle duplicate
webhook events, causing duplicate charge attempts.

Fixes #456

Commit Rules

Subject line max 50 chars
Imperative mood: "Add feature" not "Added feature" or "Adds feature"
No period at end of subject
Body explains WHY, not WHAT (code shows what)
Reference issues: Use Closes #123 or Refs #456

Branch Strategy

main (protected)
  ├─ feature/<feature-name>
  ├─ fix/<bug-description>
  ├─ hotfix/<urgent-fix>
  └─ refactor/<description>

Rules:

main: Only via merge PR, direct push forbidden
feature branches: Delete after merge
branch naming: Lowercase, kebab-case, descriptive
branch lifespan: Max 2 weeks, else split or abandon

Pull Request Standards

PR Title

Follow commit format, include PR number:

feat(auth): add OAuth2 login flow (#42)

PR Description Template

## Summary
[Bullet points, 2-3 lines max]

## Changes
- File A: What changed
- File B: What changed

## Test Plan
- [ ] Unit tests pass
- [ ] Integration tests pass
- [ ] Manual testing done

## Breaking Changes
[List any breaking changes or "None"]

## Screenshots (if applicable)

PR Review Rules

At least 1 reviewer approval before merge
All checks must pass (CI/CD, tests, linting)
Address all review comments before requesting re-review
Squash commits when merging to main

Git Best Practices

Amend only: If commit not pushed, use --amend to fix typos
Never force push to main
Use .gitignore religiously: Never commit:
- .env, .env.local
- node_modules/, dist/, build/
- IDE files (.vscode/, .idea/)
- OS files (.DS_Store, Thumbs.db)
Rebase before PR: Keep branch up-to-date with main
Atomic commits: Each commit should be a logical unit, can be reverted independently

Score

Total Score

50/100

Based on repository quality metrics

✓SKILL.md

SKILL.mdファイルが含まれている

+20

○LICENSE

ライセンスが設定されている

0/10

○説明文

100文字以上の説明がある

0/10

○人気

GitHub Stars 100以上

0/15

○最近の活動

3ヶ月以内に更新がある

0/10

○フォーク

10回以上フォークされている

0/5

✓Issue管理

オープンIssueが50未満

+5

✓言語

プログラミング言語が設定されている

+5

○タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon