mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
Clean up references to deleted scripts and pattern system
- Removed references to validate-references.sh from YAML files - Removed expand-references.sh from settings.local.json - Cleaned up @pattern/@flags references from shared files - Updated documentation to reflect current no-code implementation - Simplified reference-index.yml to remove @include patterns This cleanup removes confusion from the abandoned pattern reference system while maintaining all functionality. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
NomenAK
@@ -1,37 +1,251 @@
|
||||
@include shared/constants.yml#Process_Symbols
|
||||
# /dev-setup - Configure development environment and CI/CD
|
||||
|
||||
@include shared/command-templates.yml#Universal_Flags
|
||||
| Symbol | Meaning | | Abbrev | Meaning |
|
||||
|--------|---------|---|--------|---------|
|
||||
| → | leads to | | cfg | configuration |
|
||||
| & | and/with | | impl | implementation |
|
||||
| w/ | with | | perf | performance |
|
||||
| @ | at/located | | ops | operations |
|
||||
| > | greater than | | val | validation |
|
||||
| ∀ | for all/every | | req | requirements |
|
||||
| ∃ | exists/there is | | deps | dependencies |
|
||||
| ∴ | therefore | | env | environment |
|
||||
| ∵ | because | | db | database |
|
||||
| ≡ | equivalent | | api | interface |
|
||||
| ≈ | approximately | | docs | documentation |
|
||||
| 📁 | directory/path | | std | standard |
|
||||
| 🔢 | number/count | | def | default |
|
||||
| 📝 | text/string | | ctx | context |
|
||||
| ⚙ | setting/config | | err | error |
|
||||
| 🎛 | control/flags | | exec | execution |
|
||||
| 🔧 | configuration | | qual | quality |
|
||||
| 📋 | group/category | | rec | recovery |
|
||||
| 🚨 | critical/urgent | | sev | severity |
|
||||
| ⚠ | warning/caution | | resp | response |
|
||||
| 🔄 | retry/recovery | | esc | escalation |
|
||||
| ✅ | success/fixed | | tok | token |
|
||||
| ❌ | failure/error | | opt | optimization |
|
||||
| ℹ | information | | UX | user experience |
|
||||
| ⚡ | fast/quick | | UI | user interface |
|
||||
| 🐌 | slow/delayed | | C | critical |
|
||||
| ✨ | complete/done | | H | high |
|
||||
| 📖 | read operation | | M | medium |
|
||||
| ✏ | edit operation | | L | low |
|
||||
| 🗑 | delete operation | | |
|
||||
|
||||
Setup comprehensive dev env or CI/CD pipeline based on $ARGUMENTS.
|
||||
## Purpose
|
||||
Configure comprehensive development environments and CI/CD pipelines based on project requirements in $ARGUMENTS.
|
||||
|
||||
Thinking flags (optional):
|
||||
- --think→multi-tool env coordination
|
||||
- --think-hard→complex CI/CD pipeline architecture
|
||||
- --ultrathink→enterprise dev infrastructure design
|
||||
## Syntax
|
||||
`/dev-setup [flags] [target]`
|
||||
|
||||
Examples:
|
||||
- `/user:dev-setup --install --think` - Tool installation w/ dependency analysis
|
||||
- `/user:dev-setup --ci --think-hard` - CI/CD pipeline w/ comprehensive workflow design
|
||||
- `/user:dev-setup --monitor --ultrathink` - Complete observability infrastructure
|
||||
## Universal Flags
|
||||
--plan: "Show execution plan before running"
|
||||
--uc: "UltraCompressed mode (~70% token reduction)"
|
||||
--ultracompressed: "Alias for --uc"
|
||||
--think: "Multi-file analysis w/ context (4K tokens)"
|
||||
--think-hard: "Deep architectural analysis (10K tokens)"
|
||||
--ultrathink: "Critical system redesign (32K tokens)"
|
||||
--c7: "Enable Context7→library documentation lookup"
|
||||
--seq: "Enable Sequential→complex analysis & thinking"
|
||||
--magic: "Enable Magic→UI component generation"
|
||||
--pup: "Enable Puppeteer→browser automation & testing"
|
||||
--all-mcp: "Enable all MCP servers"
|
||||
--no-mcp: "Disable all MCP servers (native tools only)"
|
||||
--no-c7: "Disable Context7 specifically"
|
||||
--no-seq: "Disable Sequential thinking specifically"
|
||||
--no-magic: "Disable Magic UI builder specifically"
|
||||
--no-pup: "Disable Puppeteer specifically"
|
||||
|
||||
--install flag:
|
||||
- Install & cfg dev tools (Node.js, Git, Docker, DBs) | Setup IDE cfgs→consistent dev experience
|
||||
- Create npm scripts→common tasks | Cfg pre-commit hooks→code quality | Setup linting & testing frameworks
|
||||
## Command-Specific Flags
|
||||
|
||||
--ci flag:
|
||||
- Cfg CI/CD pipelines (GitHub Actions, GitLab CI, other platforms) | Setup build, test & deployment stages
|
||||
- Cfg envs: dev, staging & prod | Add security scanning & dep checking | Setup deployment automation
|
||||
**Setup Types:**
|
||||
- `--install`: Install and configure development tools (Node.js, Git, Docker, databases)
|
||||
- `--ci`: Configure CI/CD pipelines (GitHub Actions, GitLab CI, Jenkins)
|
||||
- `--monitor`: Setup observability tools (logging, monitoring, error tracking)
|
||||
- `--docker`: Configure Docker development environment
|
||||
- `--env`: Setup environment configuration and secrets management
|
||||
|
||||
--monitor flag:
|
||||
- Cfg observability tools | Setup logging & monitoring | Add perf tracking
|
||||
- Cfg error reporting | Setup alerts→critical issues
|
||||
**Development Tools:**
|
||||
- `--ide`: Configure IDE settings and extensions
|
||||
- `--git`: Setup Git workflows, hooks, and repository configuration
|
||||
- `--deps`: Configure dependency management and security scanning
|
||||
- `--testing`: Setup testing frameworks and coverage tools
|
||||
- `--linting`: Configure code quality tools (ESLint, Prettier, etc.)
|
||||
|
||||
**Infrastructure:**
|
||||
- `--local`: Local development environment setup
|
||||
- `--cloud`: Cloud development environment configuration
|
||||
- `--database`: Database setup and migration tools
|
||||
- `--security`: Security tools and vulnerability scanning
|
||||
|
||||
## Examples
|
||||
- `/dev-setup --install --docker --think` → Docker dev environment with analysis
|
||||
- `/dev-setup --ci --security --think-hard` → Secure CI/CD pipeline design
|
||||
- `/dev-setup --monitor --cloud --ultrathink` → Enterprise observability infrastructure
|
||||
- `/dev-setup --git --testing --linting` → Complete development workflow
|
||||
- `/dev-setup --env --database --local` → Local development with database
|
||||
|
||||
## Installation Setup (--install)
|
||||
|
||||
**Core Development Tools:**
|
||||
- Node.js with version management (nvm/fnm)
|
||||
- Git with global configuration
|
||||
- Docker and Docker Compose
|
||||
- Database tools (PostgreSQL, Redis)
|
||||
- Package managers (npm, yarn, pnpm)
|
||||
|
||||
**IDE Configuration:**
|
||||
- VS Code settings and extensions
|
||||
- Consistent formatting and linting
|
||||
- Debugging configurations
|
||||
- Integrated terminal setup
|
||||
|
||||
**Development Scripts:**
|
||||
- npm/yarn scripts for common tasks
|
||||
- Pre-commit hooks for code quality
|
||||
- Git hooks for automated checks
|
||||
- Build and deployment scripts
|
||||
|
||||
## CI/CD Setup (--ci)
|
||||
|
||||
**Pipeline Stages:**
|
||||
- **Build**: Compile, bundle, and optimize code
|
||||
- **Test**: Unit, integration, and E2E testing
|
||||
- **Security**: Vulnerability scanning and code analysis
|
||||
- **Deploy**: Automated deployment to environments
|
||||
- **Monitor**: Post-deployment verification
|
||||
|
||||
**Platform Configurations:**
|
||||
- GitHub Actions workflows
|
||||
- GitLab CI/CD pipelines
|
||||
- Jenkins pipeline scripts
|
||||
- Azure DevOps pipelines
|
||||
|
||||
**Environment Management:**
|
||||
- Development, staging, production environments
|
||||
- Secret management and environment variables
|
||||
- Infrastructure as Code (Terraform, CloudFormation)
|
||||
- Container orchestration (Kubernetes, Docker Swarm)
|
||||
|
||||
## Monitoring Setup (--monitor)
|
||||
|
||||
**Observability Stack:**
|
||||
- Application performance monitoring (APM)
|
||||
- Centralized logging (ELK stack, Splunk)
|
||||
- Metrics collection (Prometheus, Grafana)
|
||||
- Distributed tracing (Jaeger, Zipkin)
|
||||
- Error tracking (Sentry, Rollbar)
|
||||
|
||||
**Alerting & Notifications:**
|
||||
- Critical issue alerts
|
||||
- Performance threshold monitoring
|
||||
- Service health checks
|
||||
- Deployment notifications
|
||||
|
||||
## Deliverables
|
||||
- **Configuration Files**: Complete development and CI/CD configurations
|
||||
- **Documentation**: Setup guides, workflows, and best practices
|
||||
- **Scripts**: Automation scripts for environment setup
|
||||
- **Templates**: Reusable configurations for new projects
|
||||
- **Security Policies**: Development security guidelines and tools
|
||||
|
||||
|
||||
```yaml
|
||||
Mandatory_Research_Flows:
|
||||
External_Library_Research:
|
||||
Step_1: "Identify library/framework mentioned"
|
||||
Step_2: "Context7 lookup for official documentation"
|
||||
Step_3: "Verify API patterns and examples"
|
||||
Step_4: "Check version compatibility"
|
||||
Step_5: "Document findings in implementation"
|
||||
|
||||
Pattern_Research:
|
||||
Step_1: "Search existing codebase for similar patterns"
|
||||
Step_2: "Magic component search if UI-related"
|
||||
Step_3: "WebSearch for official documentation"
|
||||
Step_4: "Validate approach with Sequential thinking"
|
||||
Step_5: "Document pattern choice rationale"
|
||||
|
||||
API_Integration_Research:
|
||||
Step_1: "Official documentation lookup"
|
||||
Step_2: "Authentication requirements"
|
||||
Step_3: "Rate limiting and error handling"
|
||||
Step_4: "SDK availability and examples"
|
||||
Step_5: "Integration testing approach"
|
||||
```
|
||||
|
||||
|
||||
```yaml
|
||||
Standard_Notifications:
|
||||
Operation_Start: "▶ Starting {operation}"
|
||||
Operation_Complete: "✅ {operation} completed successfully"
|
||||
File_Created: "📝 Created: {file_path}"
|
||||
File_Updated: "✏ Updated: {file_path}"
|
||||
Report_Generated: "📄 Report saved to: {path}"
|
||||
Error_Occurred: "❌ {operation} failed: {reason}"
|
||||
Warning_Issued: "⚠ {warning_message}"
|
||||
Info_Message: "ℹ {information}"
|
||||
|
||||
Output_Notifications:
|
||||
Success_Format: "✅ {operation} completed in {duration}"
|
||||
Error_Format: "❌ {operation} failed: {error_details}"
|
||||
Warning_Format: "⚠ {warning}: {details}"
|
||||
Info_Format: "ℹ {message}"
|
||||
Progress_Format: "🔄 {operation}: {current}/{total} ({percentage}%)"
|
||||
```
|
||||
|
||||
## Best Practices & Security
|
||||
|
||||
Ensure all cfgs follow security practices & include comprehensive docs.
|
||||
**Security First:**
|
||||
- Secure secret management (never commit secrets)
|
||||
- Vulnerability scanning in CI/CD
|
||||
- Code analysis and security linting
|
||||
- Environment isolation and access controls
|
||||
- Regular security updates and patches
|
||||
|
||||
@include shared/command-templates.yml#Research_Requirements
|
||||
**Development Standards:**
|
||||
- Consistent code formatting and linting
|
||||
- Automated testing at all levels
|
||||
- Git workflow with protected branches
|
||||
- Code review requirements
|
||||
- Documentation standards
|
||||
|
||||
@include shared/command-templates.yml#Report_Output
|
||||
**Performance & Reliability:**
|
||||
- Fast feedback loops in CI/CD
|
||||
- Efficient caching strategies
|
||||
- Parallel execution where possible
|
||||
- Robust error handling and recovery
|
||||
- Monitoring and observability from day one
|
||||
|
||||
@include shared/constants.yml#Success_Messages
|
||||
## Environment-Specific Configurations
|
||||
|
||||
**Local Development:**
|
||||
- Hot reload and fast refresh
|
||||
- Local database and service mocking
|
||||
- Debug-friendly configurations
|
||||
- Offline-first development tools
|
||||
|
||||
**CI/CD Environments:**
|
||||
- Optimized build times
|
||||
- Comprehensive testing suites
|
||||
- Security scanning integration
|
||||
- Automated deployment gates
|
||||
|
||||
**Production Monitoring:**
|
||||
- Real-time performance metrics
|
||||
- Error tracking and alerting
|
||||
- Log aggregation and analysis
|
||||
- User experience monitoring
|
||||
|
||||
## Troubleshooting
|
||||
- **Installation Issues**: Check system requirements and permissions
|
||||
- **CI/CD Failures**: Review pipeline logs and dependency conflicts
|
||||
- **Environment Conflicts**: Use containerization for consistency
|
||||
- **Complex Setups**: Use `--think-hard` for architectural planning
|
||||
|
||||
## Success Messages
|
||||
✅ {operation} completed successfully
|
||||
📝 Created: {file_path}
|
||||
✏ Updated: {file_path}
|
||||
✨ Task completed: {task_title}
|
||||
|
||||
Reference in New Issue
Block a user