claude-skills/README.md

# Claude Skills Repository

A collection of professional, production-ready Claude AI skills for developers.

## Skills

### Master Workflow (v1.0.0)

**Universal Code Quality & Release Pipeline**

A comprehensive 9-stage development workflow that works with ANY programming language, framework, or project type.

**Features:**
- ✅ Code review automation
- ✅ Security compliance validation (OWASP Top 10)
- ✅ Architecture & quality audit (6 dimensions)
- ✅ Multi-perspective PR review (6 stakeholder angles)
- ✅ Interactive issue resolution
- ✅ Safe git operations with quality gates
- ✅ Language-agnostic (Python, JavaScript, Dart, Go, Rust, Java, etc.)
- ✅ Framework-independent
- ✅ Works on any project type

**Activation Phrases:**
- `@master`
- "complete workflow"
- "finish session"
- "full pipeline"
- "wrap up and push"
- And more...

**Usage:**
```
@master
```

**Time Estimate:** 35-60 minutes (full pipeline) or 10-15 minutes (quick mode)

**Perfect For:**
- Feature branches ready for PR review
- Release preparation
- Code ready to merge to main
- Security-critical changes
- Complex architectural changes
- Team code reviews
- Enterprise deployments

**Included:**
- 9-stage quality assurance pipeline
- Automated code review
- Security and compliance checks
- Architecture audit
- Multi-perspective feedback
- Issue resolution assistance
- Safe push to origin

## Repository Structure

```
.
├── README.md                  # This file
├── master-workflow.md         # Master workflow skill
├── LICENSE                    # License information
└── CONTRIBUTING.md           # Contribution guidelines
```

## Quick Start

1. Copy the skill file to your Claude Code skills directory:
   ```bash
   cp master-workflow.md ~/.claude/skills/
   ```

2. In Claude Code, invoke with:
   ```
   @master
   ```

3. Follow the 9-stage pipeline to completion

## Installation

### Option 1: Manual Installation
```bash
cp master-workflow.md ~/.claude/skills/
```

### Option 2: From This Repository
```bash
git clone https://git.openharbor.io/svrnty/claude-skills.git
cp claude-skills/master-workflow.md ~/.claude/skills/
```

## Requirements

- Claude Code (latest version)
- Git repository initialized
- Not on main/master/trunk/production branch
- Upstream tracking configured

## Compatibility

**Languages:** Python, JavaScript/TypeScript, Dart, Go, Rust, Java, C/C++, Ruby, PHP, and any other language

**Frameworks:** Language and framework-agnostic

**Project Types:**
- Backend services
- Frontend applications
- Full-stack projects
- Mobile apps
- Desktop applications
- CLI tools
- Data science projects
- DevOps/Infrastructure
- Monorepos
- Microservices

**Platforms:** Any platform with Git support (GitHub, GitLab, Gitea, self-hosted)

## Features

### Stage 1: Git Status & Preparation
- Verify repository state
- Check branch safety
- Confirm readiness

### Stage 2: Code Review
- Recent changes analysis
- Code quality assessment
- Security issue detection
- Readability check

### Stage 3: Architecture Audit
- 6-dimensional analysis (Architecture, Quality, Security, Performance, Testing, Maintainability)
- Design pattern evaluation
- Technical debt assessment
- Coupling analysis

### Stage 4: Security & Compliance
- OWASP Top 10 validation
- Enterprise security controls
- Dependency vulnerability scanning
- Secrets detection

### Stage 5: Multi-Perspective Review
- Product Manager perspective
- Developer perspective
- QA Engineer perspective
- Security Engineer perspective
- DevOps perspective
- UI/UX Designer perspective

### Stage 6: Synthesis & Prioritization
- Consolidate all findings
- Create action plan
- Estimate remediation effort
- Identify quick wins

### Stage 7: Issue Resolution
- Interactive issue fixing
- Targeted assistance
- Re-validation

### Stage 8: Pre-Push Verification
- Final safety checks
- Branch confirmation
- Remote verification

### Stage 9: Safe Git Push
- Automated commit
- Quality summary
- Secure push to origin

## Usage Modes

### Full Pipeline (Default)
```
@master
```
Executes all 9 stages (35-60 minutes)

### Quick Review
```
@master --quick
```
Stages 1-2 only (10-15 minutes)

### Security-Focused
```
@master --security
```
Prioritizes Stages 4-5

### Review Only
```
@master --review-only
```
All stages except push

### Force Mode
```
@master --force
```
Skip blockers and push (use with caution)

## Language Support

Tested and optimized for:

**Popular Languages:**
- Python (Django, FastAPI, Flask, async)
- JavaScript/TypeScript (React, Vue, Node, NestJS)
- Dart (Flutter, web, desktop)
- Go (microservices, CLI)
- Rust (systems, web, embedded)
- Java (Spring Boot, Android)
- Ruby (Rails, Sinatra)
- PHP (Laravel, Symfony)

**And supports any other language...**

## Performance

**Stage Breakdown:**
- Stage 1 (Git Prep): 2-3 minutes
- Stage 2 (Code Review): 5-10 minutes
- Stage 3 (Architecture Audit): 10-15 minutes
- Stage 4 (Security): 8-12 minutes
- Stage 5 (Multi-perspective): 5-8 minutes
- Stage 6 (Synthesis): 3-5 minutes
- Stage 7 (Issue Resolution): Variable
- Stage 8 (Verification): 2-3 minutes
- Stage 9 (Push): 2-3 minutes

**Total:** 35-60 minutes for full pipeline

## Safety Features

- ✅ Branch protection (prevents main/master pushes)
- ✅ Quality gates (blocks push if critical issues)
- ✅ Secret detection (finds exposed API keys)
- ✅ Confirmation gates (requires explicit approval)
- ✅ Re-validation (after fixes)
- ✅ Rollback-friendly (clean commit history)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on:
- Bug reports
- Feature requests
- Improvements
- Language-specific enhancements

## License

[See LICENSE file](LICENSE)

## Support

For issues or questions:
1. Check the skill documentation
2. Review the 9-stage pipeline guide
3. Create an issue in the repository

## Roadmap

Future enhancements planned:
- [ ] Language-specific linting integration
- [ ] Framework-specific best practices
- [ ] CI/CD pipeline integration
- [ ] Custom rule sets
- [ ] Multi-language projects support
- [ ] Docker-based analysis
- [ ] Pre-commit hook integration

## Changelog

### v1.0.0 (2024-10-31)
- Initial release
- 9-stage pipeline
- Universal language support
- Security validation
- Multi-perspective review
- Safe git operations

## Author

Svrnty Development Team

---

**Status:** Production Ready
**Marketplace Compatible:** Yes
**Universal:** Works with any language, framework, project type