@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/en/Common/commands/generate-changelog.md

@@ -0,0 +1,237 @@
+---
+description: Automatic Changelog Generation
+argument-hint: [arguments]
+---
+
+# Automatic Changelog Generation
+
+You are a documentation assistant. You must analyze git commits and generate a formatted changelog following Conventional Commits and Keep a Changelog conventions.
+
+## Arguments
+$ARGUMENTS
+
+Arguments:
+- Target version (e.g., `1.2.0`)
+- Since (previous tag, default: latest tag)
+
+Example: `/common:generate-changelog 1.2.0 v1.1.0`
+
+## MISSION
+
+### Step 1: Retrieve Commits
+
+```bash
+# Identify latest tag
+LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+
+# List commits since latest tag
+if [ -z "$LAST_TAG" ]; then
+    git log --pretty=format:"%H|%s|%an|%ad" --date=short
+else
+    git log ${LAST_TAG}..HEAD --pretty=format:"%H|%s|%an|%ad" --date=short
+fi
+```
+
+### Step 2: Parse Commits (Conventional Commits)
+
+Expected format: `type(scope): description`
+
+| Type | Changelog Category |
+|------|---------------------|
+| feat | Added |
+| fix | Fixed |
+| docs | Documentation |
+| style | (ignored) |
+| refactor | Changed |
+| perf | Performance |
+| test | (ignored) |
+| chore | (ignored) |
+| build | Build |
+| ci | (ignored) |
+| revert | Removed |
+| BREAKING CHANGE | Breaking Changes |
+
+### Step 3: Analyze PRs (if available)
+
+```bash
+# Retrieve merged PRs
+gh pr list --state merged --base main --json number,title,labels,author
+```
+
+### Step 4: Generate Changelog
+
+Keep a Changelog format:
+
+```markdown
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [{VERSION}] - {DATE}
+
+### Breaking Changes
+- **{scope}**: {description} ({author}) - #{PR}
+
+### Added
+- **{scope}**: {description} ({author}) - #{PR}
+- **{scope}**: {description} ({author}) - #{PR}
+
+### Changed
+- **{scope}**: {description} ({author}) - #{PR}
+
+### Deprecated
+- **{scope}**: {description} ({author}) - #{PR}
+
+### Removed
+- **{scope}**: {description} ({author}) - #{PR}
+
+### Fixed
+- **{scope}**: {description} ({author}) - #{PR}
+
+### Security
+- **{scope}**: {description} ({author}) - #{PR}
+
+### Performance
+- **{scope}**: {description} ({author}) - #{PR}
+
+## [{PREVIOUS_VERSION}] - {DATE}
+...
+
+[Unreleased]: https://github.com/{owner}/{repo}/compare/v{VERSION}...HEAD
+[{VERSION}]: https://github.com/{owner}/{repo}/compare/v{PREVIOUS_VERSION}...v{VERSION}
+```
+
+### Step 5: Output Example
+
+```markdown
+## [1.2.0] - 2024-01-15
+
+### Breaking Changes
+- **api**: Changed authentication from session to JWT (#123) - @john
+
+### Added
+- **auth**: Add OAuth2 social login support (#145) - @jane
+- **users**: Add user profile picture upload (#142) - @john
+- **dashboard**: Add real-time notifications (#138) - @alice
+
+### Changed
+- **api**: Upgrade API Platform to v3.2 (#150) - @bob
+- **ui**: Migrate to TailwindCSS v3 (#148) - @jane
+
+### Fixed
+- **auth**: Fix password reset email not sending (#141) - @john
+- **orders**: Fix calculation of total with discounts (#139) - @alice
+- **mobile**: Fix crash on iOS 17 (#137) - @bob
+
+### Security
+- **deps**: Update symfony/http-kernel for CVE-2024-1234 (#146) - @security-bot
+
+### Performance
+- **api**: Add Redis caching for user sessions (#144) - @alice
+- **db**: Optimize N+1 queries on orders list (#140) - @bob
+
+---
+
+**Full Changelog**: https://github.com/org/repo/compare/v1.1.0...v1.2.0
+
+### Contributors
+- @john (4 commits)
+- @jane (3 commits)
+- @alice (3 commits)
+- @bob (3 commits)
+
+### Statistics
+- Commits: 13
+- Files changed: 87
+- Lines added: +2,345
+- Lines removed: -876
+```
+
+### Step 6: Suggested Actions
+
+```
+══════════════════════════════════════════════════════════════
+📝 CHANGELOG GENERATED
+══════════════════════════════════════════════════════════════
+
+Version: 1.2.0
+Period: 2024-01-01 → 2024-01-15
+Commits analyzed: 13
+
+──────────────────────────────────────────────────────────────
+📊 SUMMARY BY CATEGORY
+──────────────────────────────────────────────────────────────
+
+| Category | Count |
+|-----------|--------|
+| Added | 3 |
+| Changed | 2 |
+| Fixed | 3 |
+| Security | 1 |
+| Performance | 2 |
+| Breaking | 1 |
+
+──────────────────────────────────────────────────────────────
+⚠️ ATTENTION POINTS
+──────────────────────────────────────────────────────────────
+
+1. ⚠️ BREAKING CHANGE detected - requires MAJOR version?
+2. 🔒 1 security fix - mention in release notes
+3. 📝 5 commits without conventional format (to improve)
+
+──────────────────────────────────────────────────────────────
+🎯 NEXT STEPS
+──────────────────────────────────────────────────────────────
+
+1. Verify and edit generated changelog
+2. Create or update CHANGELOG.md file
+3. Commit: git commit -am "docs: update changelog for v1.2.0"
+4. Create tag: git tag -a v1.2.0 -m "Release v1.2.0"
+```
+
+## Associated Commands
+
+```bash
+# Save the changelog
+# Content will be displayed, you can copy it to CHANGELOG.md
+
+# Recommended tools for automation
+# - git-cliff: https://github.com/orhun/git-cliff
+# - conventional-changelog: https://github.com/conventional-changelog/conventional-changelog
+# - release-please: https://github.com/googleapis/release-please
+```
+
+## Conventional Commits Reminder
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+
+# Standard types
+feat:     New feature
+fix:      Bug fix
+docs:     Documentation only
+style:    Formatting (no code change)
+refactor: Refactoring (no new feature or fix)
+perf:     Performance improvement
+test:     Add/modify tests
+chore:    Maintenance (deps, config, etc.)
+build:    Build system, external deps
+ci:       CI/CD configuration
+revert:   Revert previous commit
+
+# Breaking change
+feat!: description
+# or
+feat: description
+
+BREAKING CHANGE: breaking change explanation
+```

package/Dev/i18n/en/Common/commands/pre-commit-check.md

@@ -0,0 +1,205 @@
+---
+description: Pre-Commit Verification
+argument-hint: [arguments]
+---
+
+# Pre-Commit Verification
+
+You are a code quality assistant. You must perform all necessary checks BEFORE creating a commit, to ensure the code meets project standards.
+
+## Arguments
+$ARGUMENTS
+
+Options:
+- `--fix`: Automatically fix fixable issues
+- `--staged`: Check only staged files
+
+## MISSION
+
+### Step 1: Identify Modified Files
+
+```bash
+# Staged files
+git diff --cached --name-only
+
+# Modified files (unstaged)
+git diff --name-only
+```
+
+### Step 2: Detect Technology by File
+
+| Extension | Technology | Tools |
+|-----------|-------------|--------|
+| `.php` | PHP/Symfony | php-cs-fixer, phpstan |
+| `.dart` | Flutter | dart format, dart analyze |
+| `.py` | Python | ruff, mypy |
+| `.ts`, `.tsx` | React/RN | eslint, prettier |
+| `.js`, `.jsx` | React/RN | eslint, prettier |
+
+### Step 3: Execute Checks
+
+#### For PHP files
+```bash
+# Formatting
+docker compose exec php vendor/bin/php-cs-fixer fix --dry-run --diff [files]
+
+# Static analysis
+docker compose exec php vendor/bin/phpstan analyse [files]
+
+# Twig syntax (if modified)
+docker compose exec php php bin/console lint:twig templates/
+
+# Symfony container
+docker compose exec php php bin/console lint:container
+```
+
+#### For Dart/Flutter files
+```bash
+# Formatting
+docker run --rm -v $(pwd):/app -w /app dart dart format --set-exit-if-changed [files]
+
+# Analysis
+docker run --rm -v $(pwd):/app -w /app dart dart analyze [files]
+
+# Affected tests
+docker run --rm -v $(pwd):/app -w /app dart flutter test --coverage
+```
+
+#### For Python files
+```bash
+# Linting + formatting
+docker compose exec app ruff check [files]
+docker compose exec app ruff format --check [files]
+
+# Types
+docker compose exec app mypy [files]
+```
+
+#### For JS/TS files
+```bash
+# Linting
+docker compose exec node npx eslint [files]
+
+# Formatting
+docker compose exec node npx prettier --check [files]
+
+# Types (if TypeScript)
+docker compose exec node npx tsc --noEmit
+```
+
+### Step 4: Global Checks
+
+#### Secrets
+```bash
+# Search for secret patterns
+grep -rE "(password|secret|api_key|token)\s*[:=]\s*['\"][^'\"]+['\"]" --include="*.{php,py,ts,js,dart}" .
+grep -rE "sk_live_|pk_live_|ghp_|gho_|AKIA" .
+```
+
+#### Forbidden files
+```bash
+# Check for no sensitive files
+git diff --cached --name-only | grep -E "\.(env|pem|key|p12)$"
+```
+
+#### File size
+```bash
+# Files > 1MB
+find . -type f -size +1M -name "*.{php,py,ts,js,dart}"
+```
+
+### Step 5: Generate Report
+
+```
+══════════════════════════════════════════════════════════════
+🔍 PRE-COMMIT CHECK
+══════════════════════════════════════════════════════════════
+
+📁 Files checked: X
+📅 Date: YYYY-MM-DD HH:MM
+
+──────────────────────────────────────────────────────────────
+✅ SUCCESSFUL CHECKS
+──────────────────────────────────────────────────────────────
+
+✅ PHP formatting (php-cs-fixer)
+✅ PHP static analysis (phpstan)
+✅ TypeScript formatting (prettier)
+✅ TypeScript linting (eslint)
+✅ No secrets detected
+
+──────────────────────────────────────────────────────────────
+⚠️ ISSUES DETECTED
+──────────────────────────────────────────────────────────────
+
+❌ [PHP] src/Controller/UserController.php:45
+   PHPStan: Parameter $id of method __construct() has no type hint
+
+⚠️ [TS] src/components/Button.tsx:12
+   ESLint: 'unused' is defined but never used (no-unused-vars)
+
+──────────────────────────────────────────────────────────────
+📋 SUMMARY
+──────────────────────────────────────────────────────────────
+
+| Category | Status |
+|-----------|--------|
+| Formatting | ✅ OK |
+| Linting   | ⚠️ 1 warning |
+| Types     | ❌ 1 error |
+| Secrets   | ✅ OK |
+
+──────────────────────────────────────────────────────────────
+🎯 REQUIRED ACTIONS
+──────────────────────────────────────────────────────────────
+
+1. Fix PHPStan error in UserController.php
+2. (Optional) Fix ESLint warning
+
+Commit authorized: ❌ NO (1 blocking error)
+```
+
+### --fix Option
+
+If `--fix` is passed as argument:
+
+```bash
+# PHP
+docker compose exec php vendor/bin/php-cs-fixer fix [files]
+
+# Dart
+docker run --rm -v $(pwd):/app -w /app dart dart format [files]
+
+# Python
+docker compose exec app ruff check --fix [files]
+docker compose exec app ruff format [files]
+
+# JS/TS
+docker compose exec node npx eslint --fix [files]
+docker compose exec node npx prettier --write [files]
+```
+
+## Blocking Rules
+
+### Blocking (commit forbidden)
+- ❌ Syntax errors
+- ❌ PHPStan/mypy/tsc errors
+- ❌ Secrets detected
+- ❌ .env files committed
+- ❌ Private keys/certificates
+
+### Non-blocking (warning)
+- ⚠️ Formatting issues
+- ⚠️ ESLint warnings
+- ⚠️ Test coverage decreased
+- ⚠️ TODO/FIXME added
+
+## Tip
+
+To automate, configure a pre-commit hook:
+
+```bash
+# .git/hooks/pre-commit
+#!/bin/sh
+claude-code "/common:pre-commit-check --staged"
+```

package/Dev/i18n/en/Common/commands/pre-merge-check.md

@@ -0,0 +1,237 @@
+---
+description: Pre-Merge Verification
+argument-hint: [arguments]
+---
+
+# Pre-Merge Verification
+
+You are a code quality assistant. You must perform all necessary checks BEFORE merging a branch, to ensure quality and avoid regressions.
+
+## Arguments
+$ARGUMENTS
+
+Expected arguments:
+- Source branch (default: current branch)
+- Target branch (default: main or master)
+
+Example: `/common:pre-merge-check feature/auth main`
+
+## MISSION
+
+### Step 1: Analyze the Diff
+
+```bash
+# Identify branches
+SOURCE_BRANCH=$(git branch --show-current)
+TARGET_BRANCH=${2:-main}
+
+# Commits to merge
+git log $TARGET_BRANCH..$SOURCE_BRANCH --oneline
+
+# Modified files
+git diff $TARGET_BRANCH...$SOURCE_BRANCH --stat
+
+# Lines added/removed
+git diff $TARGET_BRANCH...$SOURCE_BRANCH --shortstat
+```
+
+### Step 2: Quality Checks
+
+#### 2.1 Complete Tests
+```bash
+# Run ALL tests
+# Symfony
+docker compose exec php vendor/bin/phpunit --coverage-text
+
+# Flutter
+docker run --rm -v $(pwd):/app -w /app dart flutter test --coverage
+
+# Python
+docker compose exec app pytest --cov --cov-report=term
+
+# React/RN
+docker compose exec node npm run test -- --coverage
+```
+
+#### 2.2 Complete Static Analysis
+```bash
+# PHPStan (max level)
+docker compose exec php vendor/bin/phpstan analyse -l max
+
+# Dart Analyzer
+docker run --rm -v $(pwd):/app -w /app dart dart analyze --fatal-infos
+
+# Mypy (strict)
+docker compose exec app mypy --strict .
+
+# TypeScript
+docker compose exec node npx tsc --noEmit
+```
+
+#### 2.3 Dependencies Check
+```bash
+# Security audit
+# PHP
+docker compose exec php composer audit
+
+# Python
+docker compose exec app pip-audit
+
+# Node
+docker compose exec node npm audit
+
+# Flutter
+docker run --rm -v $(pwd):/app -w /app dart dart pub outdated
+```
+
+### Step 3: Specific Checks
+
+#### DB Migrations (if present)
+```bash
+# Check Doctrine migrations
+git diff $TARGET_BRANCH...$SOURCE_BRANCH -- migrations/
+
+# If migrations present
+docker compose exec php php bin/console doctrine:migrations:diff --no-interaction
+docker compose exec php php bin/console doctrine:schema:validate
+```
+
+#### API Breaking Changes
+```bash
+# Compare OpenAPI specs
+git diff $TARGET_BRANCH...$SOURCE_BRANCH -- openapi.yaml docs/api/
+```
+
+#### Configuration Changes
+```bash
+# Modified config files
+git diff $TARGET_BRANCH...$SOURCE_BRANCH -- config/ .env.example docker-compose*.yml
+```
+
+### Step 4: Commit Analysis
+
+```bash
+# Check commit messages
+git log $TARGET_BRANCH..$SOURCE_BRANCH --pretty=format:"%s" | while read msg; do
+    # Conventional pattern: type(scope): description
+    if ! echo "$msg" | grep -qE "^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: .+"; then
+        echo "⚠️ Non-conventional message: $msg"
+    fi
+done
+```
+
+### Step 5: Coverage Check
+
+```bash
+# Compare coverage before/after
+# Coverage should not decrease
+```
+
+### Step 6: Generate Report
+
+```
+══════════════════════════════════════════════════════════════
+🔀 PRE-MERGE CHECK
+══════════════════════════════════════════════════════════════
+
+📌 Source: feature/user-auth
+📌 Target: main
+📅 Date: YYYY-MM-DD HH:MM
+
+──────────────────────────────────────────────────────────────
+📊 STATISTICS
+──────────────────────────────────────────────────────────────
+
+Commits: 12
+Modified files: 45
+Lines added: +1,234
+Lines removed: -567
+
+──────────────────────────────────────────────────────────────
+🧪 TESTS
+──────────────────────────────────────────────────────────────
+
+| Suite | Tests | Passed | Failed | Skipped |
+|-------|-------|--------|---------|---------|
+| Unit  | 234   | 234    | 0       | 0       |
+| Integ | 45    | 45     | 0       | 0       |
+| E2E   | 12    | 12     | 0       | 0       |
+
+Coverage: 85.2% (previous: 84.8%) ✅ +0.4%
+
+──────────────────────────────────────────────────────────────
+🔍 STATIC ANALYSIS
+──────────────────────────────────────────────────────────────
+
+| Tool | Errors | Warnings | Status |
+|-------|---------|----------|--------|
+| PHPStan | 0 | 2 | ✅ |
+| ESLint | 0 | 5 | ⚠️ |
+| Mypy | 0 | 0 | ✅ |
+
+──────────────────────────────────────────────────────────────
+🔒 SECURITY
+──────────────────────────────────────────────────────────────
+
+Dependencies audit: ✅ No vulnerabilities
+Secrets detected: ✅ None
+Sensitive files: ✅ None
+
+──────────────────────────────────────────────────────────────
+📦 MIGRATIONS
+──────────────────────────────────────────────────────────────
+
+New migrations: 2
+  - Version20240115_AddUserRoles.php
+  - Version20240116_CreateAuditLog.php
+
+Schema validation: ✅ OK
+Rollback possible: ✅ Yes
+
+──────────────────────────────────────────────────────────────
+⚠️ ATTENTION POINTS
+──────────────────────────────────────────────────────────────
+
+1. [MEDIUM] 5 ESLint warnings to fix
+2. [LOW] 2 TODOs added in code
+3. [INFO] 2 new migrations - verify in staging first
+
+──────────────────────────────────────────────────────────────
+📋 FINAL CHECKLIST
+──────────────────────────────────────────────────────────────
+
+- [x] All tests pass
+- [x] Coverage maintained or improved
+- [x] No static analysis errors
+- [x] No security vulnerabilities
+- [x] No secrets committed
+- [ ] Code review approved (to check manually)
+- [ ] Tested in staging (to check manually)
+
+──────────────────────────────────────────────────────────────
+🎯 VERDICT
+──────────────────────────────────────────────────────────────
+
+Merge authorized: ✅ YES
+
+Recommendations before merge:
+1. Resolve 5 ESLint warnings
+2. Test migrations in staging
+3. Obtain code review approval
+```
+
+## Blocking Rules
+
+### Blocking (merge forbidden)
+- ❌ Failing tests
+- ❌ Significant coverage drop (> 2%)
+- ❌ Static analysis errors
+- ❌ Critical/high vulnerabilities
+- ❌ Secrets in code
+- ❌ Non-reversible migrations
+
+### Non-blocking (warning)
+- ⚠️ Static analysis warnings
+- ⚠️ TODO/FIXME added
+- ⚠️ Low/medium vulnerabilities
+- ⚠️ Slightly decreased coverage (< 2%)