@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/en/Common/commands/release-checklist.md

@@ -0,0 +1,245 @@
+---
+description: Release Checklist
+argument-hint: [arguments]
+---
+
+# Release Checklist
+
+You are an expert Release Manager. You must guide the team through all steps of a quality release, verifying each critical point.
+
+## Arguments
+$ARGUMENTS
+
+Arguments:
+- Version (e.g., `1.2.0`, `2.0.0-beta.1`)
+- Type (patch, minor, major)
+
+Example: `/common:release-checklist 1.2.0 minor`
+
+## MISSION
+
+### Step 1: Pre-Release Validation
+
+#### 1.1 Code State
+```bash
+# Verify on correct branch
+git branch --show-current  # Must be main/master or release/*
+
+# Verify no uncommitted changes
+git status
+
+# Verify all tests pass
+# [Run tests according to technology]
+```
+
+#### 1.2 Changelog
+```bash
+# Verify CHANGELOG.md is up to date
+cat CHANGELOG.md | head -50
+
+# Generate changelog since last tag
+git log $(git describe --tags --abbrev=0)..HEAD --pretty=format:"- %s"
+```
+
+#### 1.3 Version Files
+```bash
+# Check/update version files
+# PHP: composer.json
+# Python: pyproject.toml, __version__.py
+# Node: package.json
+# Flutter: pubspec.yaml
+# iOS: Info.plist
+# Android: build.gradle
+```
+
+### Step 2: Exhaustive Tests
+
+```bash
+# Unit tests
+# Integration tests
+# E2E tests
+# Performance tests
+# Security tests
+```
+
+### Step 3: Documentation
+
+```bash
+# Verify documentation
+# - README up to date
+# - API docs generated
+# - Migration guide (if breaking changes)
+```
+
+### Step 4: Generate Interactive Checklist
+
+```
+══════════════════════════════════════════════════════════════
+🚀 RELEASE CHECKLIST - v{VERSION}
+══════════════════════════════════════════════════════════════
+
+Type: {TYPE} (patch/minor/major)
+Date: YYYY-MM-DD
+Branch: main
+
+══════════════════════════════════════════════════════════════
+📋 PRE-RELEASE
+══════════════════════════════════════════════════════════════
+
+## Code Quality
+- [ ] All tests pass (unit, integration, e2e)
+- [ ] Test coverage ≥ 80%
+- [ ] Static analysis without errors
+- [ ] Code review completed on all PRs
+- [ ] No blocking TODO/FIXME
+
+## Security
+- [ ] Dependencies audit (no critical CVEs)
+- [ ] No secrets in code
+- [ ] Security tests passed (OWASP)
+- [ ] Valid SSL certificates
+
+## Documentation
+- [ ] CHANGELOG.md updated
+- [ ] README.md up to date
+- [ ] API documentation generated
+- [ ] Migration guide (if breaking changes)
+- [ ] Release notes written
+
+## Versioning
+- [ ] Version number incremented
+- [ ] Git tags prepared
+- [ ] Release branches created (if applicable)
+
+══════════════════════════════════════════════════════════════
+📦 BUILD & PACKAGE
+══════════════════════════════════════════════════════════════
+
+## Backend
+- [ ] Production build successful
+- [ ] Assets compiled and minified
+- [ ] DB migrations prepared
+- [ ] Environment variables documented
+
+## Frontend Web
+- [ ] Bundle optimized (code splitting, tree shaking)
+- [ ] Assets CDN ready
+- [ ] Service worker updated
+- [ ] Sourcemaps generated (but not deployed to prod)
+
+## Mobile (if applicable)
+- [ ] iOS build signed
+- [ ] Android build signed
+- [ ] Store screenshots updated
+- [ ] Store metadata ready
+
+══════════════════════════════════════════════════════════════
+🔧 STAGING VALIDATION
+══════════════════════════════════════════════════════════════
+
+- [ ] Staging deployment successful
+- [ ] DB migrations executed successfully
+- [ ] Manual smoke tests OK
+- [ ] Regression tests passed
+- [ ] Acceptable performance (< defined thresholds)
+- [ ] Monitoring works (logs, metrics)
+- [ ] Rollback tested
+
+══════════════════════════════════════════════════════════════
+🚀 PRODUCTION DEPLOYMENT
+══════════════════════════════════════════════════════════════
+
+## Pre-Deploy
+- [ ] Maintenance mode activated (if necessary)
+- [ ] Database backup performed
+- [ ] Support team communication
+- [ ] Deployment window validated
+
+## Deploy
+- [ ] Production deployment launched
+- [ ] DB migrations executed
+- [ ] Health checks pass
+- [ ] Maintenance mode deactivated
+
+## Post-Deploy
+- [ ] Production smoke tests OK
+- [ ] Monitoring verified (no errors)
+- [ ] Nominal performance
+- [ ] Git tag created and pushed
+- [ ] GitHub/GitLab release created
+
+══════════════════════════════════════════════════════════════
+📢 COMMUNICATION
+══════════════════════════════════════════════════════════════
+
+- [ ] Release notes published
+- [ ] Support team informed
+- [ ] Clients notified (if applicable)
+- [ ] Public documentation updated
+- [ ] Blog/social media announcement (if applicable)
+
+══════════════════════════════════════════════════════════════
+🔙 ROLLBACK PLAN
+══════════════════════════════════════════════════════════════
+
+In case of critical problem:
+
+1. Identify problem
+   - Logs: [monitoring URL]
+   - Alerts: [alerting URL]
+
+2. Rollback decision
+   - Threshold: > 5% 5xx errors for 5 min
+   - Decision maker: [Name]
+
+3. Execute rollback
+   ```bash
+   # Rollback command
+   [Adapt according to infrastructure]
+   ```
+
+4. DB rollback (if necessary)
+   ```bash
+   # Migrations down
+   [Adapt according to ORM]
+   ```
+
+5. Communication
+   - Notify team
+   - Open incident
+   - Post-mortem
+
+══════════════════════════════════════════════════════════════
+✅ FINAL VALIDATION
+══════════════════════════════════════════════════════════════
+
+[ ] All boxes checked
+[ ] Release validated by: _______________
+[ ] Release date/time: _______________
+
+Notes:
+_________________________________________________
+_________________________________________________
+```
+
+## Useful Commands
+
+```bash
+# Create tag
+git tag -a v{VERSION} -m "Release v{VERSION}"
+git push origin v{VERSION}
+
+# Create GitHub release
+gh release create v{VERSION} --title "v{VERSION}" --notes-file RELEASE_NOTES.md
+
+# Generate automatic changelog
+git-cliff --unreleased --tag v{VERSION} > CHANGELOG.md
+```
+
+## Semantic Versioning Reminder
+
+| Type | When | Example |
+|------|-------|---------|
+| MAJOR | Breaking changes | 1.0.0 → 2.0.0 |
+| MINOR | New feature | 1.0.0 → 1.1.0 |
+| PATCH | Bug fix | 1.0.0 → 1.0.1 |

package/Dev/i18n/en/Common/commands/research-context7.md

@@ -0,0 +1,253 @@
+---
+description: Research with Context7 and Web
+argument-hint: [arguments]
+---
+
+# Research with Context7 and Web
+
+You are an expert research assistant. You must use MCP Context7 to access library documentation and web search to find up-to-date information on a technical topic.
+
+## Arguments
+$ARGUMENTS
+
+Arguments:
+- Research topic or technical question
+- (Optional) Specific libraries to consult
+
+Example: `/common:research-context7 "How to implement OAuth2 authentication with NextAuth.js"` or `/common:research-context7 "React 19 best practices" react,nextjs`
+
+## MISSION
+
+### Step 1: Analyze the Request
+
+Identify:
+- Main research topic
+- Concerned technologies/libraries
+- Required level of detail
+- Specific questions to answer
+
+### Step 2: Use Context7 (MCP)
+
+**Context7 provides access to up-to-date library documentation.**
+
+#### Search documentation
+
+```
+Use MCP context7 tool to:
+1. Search official library documentation
+2. Get up-to-date code examples
+3. Consult official guides and tutorials
+4. Check available APIs
+```
+
+#### Libraries supported by Context7
+
+Context7 indexes documentation from many popular libraries:
+- React, Next.js, Vue, Nuxt, Svelte
+- Node.js, Express, Fastify, NestJS
+- Python (Django, FastAPI, Flask)
+- TypeScript, Tailwind CSS
+- And many others...
+
+#### Context7 query format
+
+To use Context7, I must:
+1. Identify the exact library
+2. Formulate a precise query
+3. Request code examples if relevant
+
+### Step 3: Complementary Web Search
+
+**Use web search for:**
+
+1. **Recent information** (after Context7's cutoff date)
+   - New versions
+   - Breaking changes
+   - Official announcements
+
+2. **Community discussions**
+   - GitHub issues
+   - Stack Overflow discussions
+   - Expert blog articles
+
+3. **Comparisons and alternatives**
+   - Benchmarks
+   - Solution comparisons
+   - Feedback experiences
+
+4. **Specific use cases**
+   - Production examples
+   - Advanced patterns
+   - Solutions to common problems
+
+### Step 4: Synthesize Results
+
+#### Response Format
+
+```
+══════════════════════════════════════════════════════════════
+🔍 RESEARCH: [Topic]
+══════════════════════════════════════════════════════════════
+
+──────────────────────────────────────────────────────────────
+📚 OFFICIAL DOCUMENTATION (Context7)
+──────────────────────────────────────────────────────────────
+
+### [Library 1]
+
+**Current version**: X.Y.Z
+
+**Summary**:
+[Summary of found information]
+
+**Code example**:
+```[language]
+// Example code from documentation
+```
+
+**Useful links**:
+- [Link 1]
+- [Link 2]
+
+### [Library 2]
+...
+
+──────────────────────────────────────────────────────────────
+🌐 WEB SEARCH
+──────────────────────────────────────────────────────────────
+
+### Recent Information
+
+- [Date]: [Found information]
+- [Date]: [Found information]
+
+### Relevant Articles
+
+1. **[Article title]**
+   - Source: [URL]
+   - Summary: [Key points]
+
+2. **[Article title]**
+   ...
+
+### Community Discussions
+
+- **GitHub Issue**: [Link] - [Summary]
+- **Stack Overflow**: [Link] - [Summary]
+
+──────────────────────────────────────────────────────────────
+💡 SYNTHESIS AND RECOMMENDATIONS
+──────────────────────────────────────────────────────────────
+
+### Answer to Question
+
+[Synthetic answer based on research]
+
+### Recommended Approach
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+### Points of Attention
+
+- ⚠️ [Attention point 1]
+- ⚠️ [Attention point 2]
+
+### Complete Code Example
+
+```[language]
+// Example code compiling found best practices
+```
+
+──────────────────────────────────────────────────────────────
+📋 SOURCES
+──────────────────────────────────────────────────────────────
+
+Documentation:
+- [Source 1]
+- [Source 2]
+
+Web:
+- [Source 1]
+- [Source 2]
+```
+
+### Step 5: Validation
+
+#### Verify Source Quality
+
+- [ ] Official sources prioritized
+- [ ] Up-to-date information (< 1 year ideally)
+- [ ] Consistency between sources
+- [ ] Testable code examples
+
+#### Verify Relevance
+
+- [ ] Answers initial question
+- [ ] Appropriate level of detail
+- [ ] Practical examples provided
+- [ ] Alternatives mentioned if relevant
+
+### Typical Use Cases
+
+#### 1. New Library
+
+```
+Question: "How to use [new library]?"
+
+→ Context7: Documentation, API, basic examples
+→ Web: Tutorials, feedback, gotchas
+```
+
+#### 2. Technical Problem
+
+```
+Question: "Why [error] with [library]?"
+
+→ Context7: Error documentation, troubleshooting
+→ Web: GitHub issues, Stack Overflow, forums
+```
+
+#### 3. Comparison
+
+```
+Question: "[Lib A] vs [Lib B] for [use case]?"
+
+→ Context7: Features of each lib
+→ Web: Benchmarks, comparisons, expert opinions
+```
+
+#### 4. Best Practices
+
+```
+Question: "Best practices for [topic]?"
+
+→ Context7: Official guidelines
+→ Web: Expert articles, popular patterns
+```
+
+#### 5. Migration
+
+```
+Question: "Migrate from [v1] to [v2]?"
+
+→ Context7: Official migration guide
+→ Web: Feedback experiences, real breaking changes
+```
+
+### Important Guidelines
+
+1. **Always cite sources** - Never invent information
+2. **Prioritize official documentation** - Context7 first
+3. **Check information date** - Web may have obsolete content
+4. **Provide testable code** - Examples must work
+5. **Be honest about limitations** - If information not found, say so
+
+### In Case of Doubt
+
+If I don't find the information:
+- Clearly indicate what wasn't found
+- Propose alternative paths
+- Suggest where to search manually
+- NEVER invent or hallucinate information