feat: CRM Clinicas SaaS - MVP completo
- Auth: Login/Register con creacion de clinica - Dashboard: KPIs reales, graficas recharts - Pacientes: CRUD completo con busqueda - Agenda: FullCalendar, drag-and-drop, vista recepcion - Expediente: Notas SOAP, signos vitales, CIE-10 - Facturacion: Facturas con IVA, campos CFDI SAT - Inventario: Productos, stock, movimientos, alertas - Configuracion: Clinica, equipo, catalogo servicios - Supabase self-hosted: 18 tablas con RLS multi-tenant - Docker + Nginx para produccion Co-Authored-By: claude-flow <ruv@ruv.net>
This commit is contained in:
Consultoria AS
338
.claude/commands/github/release-manager.md
Normal file
338
.claude/commands/github/release-manager.md
Normal file
@@ -0,0 +1,338 @@
|
||||
# GitHub Release Manager
|
||||
|
||||
## Purpose
|
||||
Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages.
|
||||
|
||||
## Capabilities
|
||||
- **Automated release pipelines** with comprehensive testing
|
||||
- **Version coordination** across multiple packages
|
||||
- **Deployment orchestration** with rollback capabilities
|
||||
- **Release documentation** generation and management
|
||||
- **Multi-stage validation** with swarm coordination
|
||||
|
||||
## Tools Available
|
||||
- `mcp__github__create_pull_request`
|
||||
- `mcp__github__merge_pull_request`
|
||||
- `mcp__github__create_branch`
|
||||
- `mcp__github__push_files`
|
||||
- `mcp__github__create_issue`
|
||||
- `mcp__claude-flow__*` (all swarm coordination tools)
|
||||
- `TodoWrite`, `TodoRead`, `Task`, `Bash`, `Read`, `Write`, `Edit`
|
||||
|
||||
## Usage Patterns
|
||||
|
||||
### 1. Coordinated Release Preparation
|
||||
```javascript
|
||||
// Initialize release management swarm
|
||||
mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 6 }
|
||||
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Coordinator" }
|
||||
mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
|
||||
mcp__claude-flow__agent_spawn { type: "reviewer", name: "Release Reviewer" }
|
||||
mcp__claude-flow__agent_spawn { type: "coder", name: "Version Manager" }
|
||||
mcp__claude-flow__agent_spawn { type: "analyst", name: "Deployment Analyst" }
|
||||
|
||||
// Create release preparation branch
|
||||
mcp__github__create_branch {
|
||||
owner: "ruvnet",
|
||||
repo: "ruv-FANN",
|
||||
branch: "release/v1.0.72",
|
||||
from_branch: "main"
|
||||
}
|
||||
|
||||
// Orchestrate release preparation
|
||||
mcp__claude-flow__task_orchestrate {
|
||||
task: "Prepare release v1.0.72 with comprehensive testing and validation",
|
||||
strategy: "sequential",
|
||||
priority: "critical"
|
||||
}
|
||||
```
|
||||
|
||||
### 2. Multi-Package Version Coordination
|
||||
```javascript
|
||||
// Update versions across packages
|
||||
mcp__github__push_files {
|
||||
owner: "ruvnet",
|
||||
repo: "ruv-FANN",
|
||||
branch: "release/v1.0.72",
|
||||
files: [
|
||||
{
|
||||
path: "claude-code-flow/claude-code-flow/package.json",
|
||||
content: JSON.stringify({
|
||||
name: "claude-flow",
|
||||
version: "1.0.72",
|
||||
// ... rest of package.json
|
||||
}, null, 2)
|
||||
},
|
||||
{
|
||||
path: "ruv-swarm/npm/package.json",
|
||||
content: JSON.stringify({
|
||||
name: "ruv-swarm",
|
||||
version: "1.0.12",
|
||||
// ... rest of package.json
|
||||
}, null, 2)
|
||||
},
|
||||
{
|
||||
path: "CHANGELOG.md",
|
||||
content: `# Changelog
|
||||
|
||||
## [1.0.72] - ${new Date().toISOString().split('T')[0]}
|
||||
|
||||
### Added
|
||||
- Comprehensive GitHub workflow integration
|
||||
- Enhanced swarm coordination capabilities
|
||||
- Advanced MCP tools suite
|
||||
|
||||
### Changed
|
||||
- Aligned Node.js version requirements
|
||||
- Improved package synchronization
|
||||
- Enhanced documentation structure
|
||||
|
||||
### Fixed
|
||||
- Dependency resolution issues
|
||||
- Integration test reliability
|
||||
- Memory coordination optimization`
|
||||
}
|
||||
],
|
||||
message: "release: Prepare v1.0.72 with GitHub integration and swarm enhancements"
|
||||
}
|
||||
```
|
||||
|
||||
### 3. Automated Release Validation
|
||||
```javascript
|
||||
// Comprehensive release testing
|
||||
Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install")
|
||||
Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run test")
|
||||
Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run lint")
|
||||
Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run build")
|
||||
|
||||
Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm install")
|
||||
Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm run test:all")
|
||||
Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm run lint")
|
||||
|
||||
// Create release PR with validation results
|
||||
mcp__github__create_pull_request {
|
||||
owner: "ruvnet",
|
||||
repo: "ruv-FANN",
|
||||
title: "Release v1.0.72: GitHub Integration and Swarm Enhancements",
|
||||
head: "release/v1.0.72",
|
||||
base: "main",
|
||||
body: `## 🚀 Release v1.0.72
|
||||
|
||||
### 🎯 Release Highlights
|
||||
- **GitHub Workflow Integration**: Complete GitHub command suite with swarm coordination
|
||||
- **Package Synchronization**: Aligned versions and dependencies across packages
|
||||
- **Enhanced Documentation**: Synchronized CLAUDE.md with comprehensive integration guides
|
||||
- **Improved Testing**: Comprehensive integration test suite with 89% success rate
|
||||
|
||||
### 📦 Package Updates
|
||||
- **claude-flow**: v1.0.71 → v1.0.72
|
||||
- **ruv-swarm**: v1.0.11 → v1.0.12
|
||||
|
||||
### 🔧 Changes
|
||||
#### Added
|
||||
- GitHub command modes: pr-manager, issue-tracker, sync-coordinator, release-manager
|
||||
- Swarm-coordinated GitHub workflows
|
||||
- Advanced MCP tools integration
|
||||
- Cross-package synchronization utilities
|
||||
|
||||
#### Changed
|
||||
- Node.js requirement aligned to >=20.0.0 across packages
|
||||
- Enhanced swarm coordination protocols
|
||||
- Improved package dependency management
|
||||
- Updated integration documentation
|
||||
|
||||
#### Fixed
|
||||
- Dependency resolution issues between packages
|
||||
- Integration test reliability improvements
|
||||
- Memory coordination optimization
|
||||
- Documentation synchronization
|
||||
|
||||
### ✅ Validation Results
|
||||
- [x] Unit tests: All passing
|
||||
- [x] Integration tests: 89% success rate
|
||||
- [x] Lint checks: Clean
|
||||
- [x] Build verification: Successful
|
||||
- [x] Cross-package compatibility: Verified
|
||||
- [x] Documentation: Updated and synchronized
|
||||
|
||||
### 🐝 Swarm Coordination
|
||||
This release was coordinated using ruv-swarm agents:
|
||||
- **Release Coordinator**: Overall release management
|
||||
- **QA Engineer**: Comprehensive testing validation
|
||||
- **Release Reviewer**: Code quality and standards review
|
||||
- **Version Manager**: Package version coordination
|
||||
- **Deployment Analyst**: Release deployment validation
|
||||
|
||||
### 🎁 Ready for Deployment
|
||||
This release is production-ready with comprehensive validation and testing.
|
||||
|
||||
---
|
||||
🤖 Generated with Claude Code using ruv-swarm coordination`
|
||||
}
|
||||
```
|
||||
|
||||
## Batch Release Workflow
|
||||
|
||||
### Complete Release Pipeline:
|
||||
```javascript
|
||||
[Single Message - Complete Release Management]:
|
||||
// Initialize comprehensive release swarm
|
||||
mcp__claude-flow__swarm_init { topology: "star", maxAgents: 8 }
|
||||
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Director" }
|
||||
mcp__claude-flow__agent_spawn { type: "tester", name: "QA Lead" }
|
||||
mcp__claude-flow__agent_spawn { type: "reviewer", name: "Senior Reviewer" }
|
||||
mcp__claude-flow__agent_spawn { type: "coder", name: "Version Controller" }
|
||||
mcp__claude-flow__agent_spawn { type: "analyst", name: "Performance Analyst" }
|
||||
mcp__claude-flow__agent_spawn { type: "researcher", name: "Compatibility Checker" }
|
||||
|
||||
// Create release branch and prepare files using gh CLI
|
||||
Bash("gh api repos/:owner/:repo/git/refs --method POST -f ref='refs/heads/release/v1.0.72' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')")
|
||||
|
||||
// Clone and update release files
|
||||
Bash("gh repo clone :owner/:repo /tmp/release-v1.0.72 -- --branch release/v1.0.72 --depth=1")
|
||||
|
||||
// Update all release-related files
|
||||
Write("/tmp/release-v1.0.72/claude-code-flow/claude-code-flow/package.json", "[updated package.json]")
|
||||
Write("/tmp/release-v1.0.72/ruv-swarm/npm/package.json", "[updated package.json]")
|
||||
Write("/tmp/release-v1.0.72/CHANGELOG.md", "[release changelog]")
|
||||
Write("/tmp/release-v1.0.72/RELEASE_NOTES.md", "[detailed release notes]")
|
||||
|
||||
Bash("cd /tmp/release-v1.0.72 && git add -A && git commit -m 'release: Prepare v1.0.72 with comprehensive updates' && git push")
|
||||
|
||||
// Run comprehensive validation
|
||||
Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install && npm test && npm run lint && npm run build")
|
||||
Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm install && npm run test:all && npm run lint")
|
||||
|
||||
// Create release PR using gh CLI
|
||||
Bash(`gh pr create \
|
||||
--repo :owner/:repo \
|
||||
--title "Release v1.0.72: GitHub Integration and Swarm Enhancements" \
|
||||
--head "release/v1.0.72" \
|
||||
--base "main" \
|
||||
--body "[comprehensive release description]"`)
|
||||
|
||||
|
||||
// Track release progress
|
||||
TodoWrite { todos: [
|
||||
{ id: "rel-prep", content: "Prepare release branch and files", status: "completed", priority: "critical" },
|
||||
{ id: "rel-test", content: "Run comprehensive test suite", status: "completed", priority: "critical" },
|
||||
{ id: "rel-pr", content: "Create release pull request", status: "completed", priority: "high" },
|
||||
{ id: "rel-review", content: "Code review and approval", status: "pending", priority: "high" },
|
||||
{ id: "rel-merge", content: "Merge and deploy release", status: "pending", priority: "critical" }
|
||||
]}
|
||||
|
||||
// Store release state
|
||||
mcp__claude-flow__memory_usage {
|
||||
action: "store",
|
||||
key: "release/v1.0.72/status",
|
||||
value: {
|
||||
timestamp: Date.now(),
|
||||
version: "1.0.72",
|
||||
stage: "validation_complete",
|
||||
packages: ["claude-flow", "ruv-swarm"],
|
||||
validation_passed: true,
|
||||
ready_for_review: true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Release Strategies
|
||||
|
||||
### 1. **Semantic Versioning Strategy**
|
||||
```javascript
|
||||
const versionStrategy = {
|
||||
major: "Breaking changes or architecture overhauls",
|
||||
minor: "New features, GitHub integration, swarm enhancements",
|
||||
patch: "Bug fixes, documentation updates, dependency updates",
|
||||
coordination: "Cross-package version alignment"
|
||||
}
|
||||
```
|
||||
|
||||
### 2. **Multi-Stage Validation**
|
||||
```javascript
|
||||
const validationStages = [
|
||||
"unit_tests", // Individual package testing
|
||||
"integration_tests", // Cross-package integration
|
||||
"performance_tests", // Performance regression detection
|
||||
"compatibility_tests", // Version compatibility validation
|
||||
"documentation_tests", // Documentation accuracy verification
|
||||
"deployment_tests" // Deployment simulation
|
||||
]
|
||||
```
|
||||
|
||||
### 3. **Rollback Strategy**
|
||||
```javascript
|
||||
const rollbackPlan = {
|
||||
triggers: ["test_failures", "deployment_issues", "critical_bugs"],
|
||||
automatic: ["failed_tests", "build_failures"],
|
||||
manual: ["user_reported_issues", "performance_degradation"],
|
||||
recovery: "Previous stable version restoration"
|
||||
}
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
### 1. **Comprehensive Testing**
|
||||
- Multi-package test coordination
|
||||
- Integration test validation
|
||||
- Performance regression detection
|
||||
- Security vulnerability scanning
|
||||
|
||||
### 2. **Documentation Management**
|
||||
- Automated changelog generation
|
||||
- Release notes with detailed changes
|
||||
- Migration guides for breaking changes
|
||||
- API documentation updates
|
||||
|
||||
### 3. **Deployment Coordination**
|
||||
- Staged deployment with validation
|
||||
- Rollback mechanisms and procedures
|
||||
- Performance monitoring during deployment
|
||||
- User communication and notifications
|
||||
|
||||
### 4. **Version Management**
|
||||
- Semantic versioning compliance
|
||||
- Cross-package version coordination
|
||||
- Dependency compatibility validation
|
||||
- Breaking change documentation
|
||||
|
||||
## Integration with CI/CD
|
||||
|
||||
### GitHub Actions Integration:
|
||||
```yaml
|
||||
name: Release Management
|
||||
on:
|
||||
pull_request:
|
||||
branches: [main]
|
||||
paths: ['**/package.json', 'CHANGELOG.md']
|
||||
|
||||
jobs:
|
||||
release-validation:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
- name: Setup Node.js
|
||||
uses: actions/setup-node@v3
|
||||
with:
|
||||
node-version: '20'
|
||||
- name: Install and Test
|
||||
run: |
|
||||
cd claude-code-flow/claude-code-flow && npm install && npm test
|
||||
cd ../../ruv-swarm/npm && npm install && npm test:all
|
||||
- name: Validate Release
|
||||
run: npx claude-flow release validate
|
||||
```
|
||||
|
||||
## Monitoring and Metrics
|
||||
|
||||
### Release Quality Metrics:
|
||||
- Test coverage percentage
|
||||
- Integration success rate
|
||||
- Deployment time metrics
|
||||
- Rollback frequency
|
||||
|
||||
### Automated Monitoring:
|
||||
- Performance regression detection
|
||||
- Error rate monitoring
|
||||
- User adoption metrics
|
||||
- Feedback collection and analysis
|
||||
Reference in New Issue
Block a user