tsaol/awesome-claude/git-commit

# Find design docs
find . -name "DESIGN.md" -o -name "*.design.md" -o -name "design*.md"

# Check recent changes vs CHANGELOG
git diff HEAD~5 --name-only
cat CHANGELOG.md | head -50

# Compare README with actual code
cat README.md

# Check if history.log exists
if [ -f ~/history.log ]; then
    echo "history.log exists, will update"
fi

=== {DATE} {PROJECT_NAME} - {BRIEF_DESCRIPTION} ===
 
## Changes
-Feature/fix description
-Files modified
-PRs created
 
## Key Commands
-python hub/main.py search "query"
-etc.

# Check common version file locations (in priority order)
[ -f package.json ] && echo "package.json"
[ -f pyproject.toml ] && echo "pyproject.toml"
[ -f setup.py ] && echo "setup.py"
[ -f setup.cfg ] && echo "setup.cfg"
[ -f VERSION ] && echo "VERSION"
[ -f version.txt ] && echo "version.txt"
[ -f Cargo.toml ] && echo "Cargo.toml"
[ -f build.gradle ] && echo "build.gradle"

# Python (pyproject.toml) - example: 0.2.1 → 0.2.2
# Read current version, calculate new version, update file
grep 'version = ' pyproject.toml
 
# Node.js (package.json) - example: 1.3.0 → 1.4.0
# Use npm version or manual edit
grep '"version"' package.json
 
# Plain VERSION file
cat VERSION

## [0.2.2] - 2026-02-26
 
-Fix slow query in user search
-Update error handling for API timeout

## Consistency Check Report
 
### Files Changed
-[ ] List modified files
 
### Documentation Status
-[ ] CHANGELOG updated: Yes/No
-[ ] README accurate: Yes/No
-[ ] Design docs aligned: Yes/No
-[ ] ~/history.log updated: Yes/No/Not exists
 
### Version
-[ ] Version file detected: Yes (package.json) / No
-[ ] Current version: 0.2.1
-[ ] Bump type: patch / minor / major
-[ ] New version: 0.2.2
 
### Deploy Config
-[ ] Deploy configured: Yes/No
-[ ] Method: ssm / ssh / script / N/A
-[ ] Target: instance-id or host
 
### Issues Found
-Issue 1: ...
-Issue 2: ...
 
### Recommendations
-Action 1: ...
-Action 2: ...

Code Changes Complete
        ↓
    /git-commit
        ↓
┌──────────────────────────────┐
│  1. Read changed files       │
│  2. Check CHANGELOG          │
│  3. Verify README            │
│  4. Compare with docs        │
│  5. Update ~/history.log     │
│  6. Version Bump             │
│  7. Generate report          │
│  8. Fix issues (if any)      │
│  9. Git commit & push        │
│ 10. Auto Deploy (if config)  │
└──────────────────────────────┘

# Example commit flow
git add .
git commit -m "add browser fetcher with screenshot support"
git push origin <branch>
gh pr create --reviewer tsaol  # if on feature branch

projects:
  my-project:
    repo: user/my-project
    deploy:
      method: ssm           # Deployment method (ssm, ssh, script)
      instance: i-0abc123   # Target instance (for ssm/ssh)
      command: "cd /app && git pull origin main && sudo systemctl restart myapp"

# Read collaboration.yml and find current project's deploy config
cat ~/.claude/collaboration.yml

🚀 Deploy detected for project "languages"
   Method: ssm
   Instance: i-0123456789abcdef0
   Command: cd /home/ubuntu/languages && git pull origin main && sudo systemctl restart englearn
 
   Proceed with deployment? (y/n)

# SSM method
aws ssm send-command \
  --instance-ids "i-0abc123" \
  --document-name "AWS-RunShellScript" \
  --parameters "commands=[\"<deploy-command>\"]" \
  --output text
 
# SSH method
ssh user@host "<deploy-command>"
 
# Script method
bash -c "<deploy-command>"

# Check SSM command status
aws ssm list-command-invocations \
  --command-id "<command-id>" \
  --details \
  --output text
 
# Or check service status via SSM
aws ssm send-command \
  --instance-ids "i-0abc123" \
  --document-name "AWS-RunShellScript" \
  --parameters "commands=[\"systemctl status <service>\"]"

### Deploy Result
-Project: languages
-Method: ssm
-Instance: i-0123456789abcdef0
-Status: ✅ SUCCESS / ❌ FAILED
-Details: Service restarted successfully

/git-commit              # Full consistency review + commit + deploy
/git-commit --quick      # Quick check (CHANGELOG + README only)
/git-commit --verbose    # Detailed report with suggestions
/git-commit --no-deploy  # Skip deployment even if configured

## Git Check Report
 
### Changed Files (last commit)
- src/storage.py
- src/main.py
 
### CHANGELOG Status
⚠️  CHANGELOG.md not updated for recent changes
 
### README Status
✅ README.md is up to date
 
### Recommendations
1. Add entry to CHANGELOG.md:
   - "save url/source/category in sent_news.json"