development-workflow

What this skill does

## Table of Contents

- [Overview](#overview)
- [Available Modules](#available-modules)
- [Quick Start](#quick-start)
- [Usage Patterns](#usage-patterns)
- [For New Projects](#for-new-projects)
- [For Existing Projects](#for-existing-projects)
- [For Team Onboarding](#for-team-onboarding)
- [Integration Benefits](#integration-benefits)
- [Quality Assurance](#quality-assurance)
- [Customization](#customization)
- [Support and Resources](#support-and-resources)


# Development Workflow Hub

This modular skill provides a detailed framework for software development workflows. It's designed as a hub that coordinates specialized modules for different aspects of development.

## Overview

Get started quickly with this development workflow framework:

** Quick Start**: Set up repository structure and basic workflow in minutes
- Initialize with git-workflow module
- Add code-review process for team collaboration
- Implement testing strategies for quality assurance

**Progressive Learning**: Start simple, add complexity as needed
1. **Basic workflow** → git-workflow and code-review
2. **Quality focus** → add testing-strategies and documentation
3. **Production ready** → add deployment-procedures and monitoring

** Use Case-Based**: Jump directly to what you need
- New project? → Start with git-workflow
- Team scaling? → Focus on code-review + testing
- Production deployment? → Use deployment-procedures
- Documentation debt? → Apply documentation-guidelines

## Available Modules

This workflow illustrates a hub coordinating these specialized
modules. Each link below resolves to a working example file in
this skill's `modules/` directory; copy the directory and adapt
the contents when using this template for a real skill:

- **[modules/git-workflow.md](modules/git-workflow.md)**: Repository setup, branching strategies, and daily git practices
- **[modules/code-review.md](modules/code-review.md)**: Pull request process, review guidelines, and quality standards
- **[modules/testing-strategies.md](modules/testing-strategies.md)**: Unit testing, integration testing, and E2E testing patterns
- **[modules/documentation-guidelines.md](modules/documentation-guidelines.md)**: Code documentation, API docs, and README standards
- **[modules/deployment-procedures.md](modules/deployment-procedures.md)**: CI/CD pipelines, environment setup, and monitoring

## Quick Start

To use this development workflow:

1. **Set up your development environment:**
   ```
   Use git-workflow module for repository initialization and branching setup
   ```
   **Verification:** Run the command with `--help` flag to verify availability.

2. **Follow the development cycle:**
   ```
   **Verification:** Run the command with `--help` flag to verify availability.
   git-workflow → code-review → testing-strategies → documentation-guidelines
   ```
   **Verification:** Run `pytest -v` to verify tests pass.

3. **Deploy and monitor:**
   ```
   **Verification:** Run the command with `--help` flag to verify availability.
   deployment-procedures module handles CI/CD and production monitoring
   ```
   **Verification:** Run the command with `--help` flag to verify availability.

## Usage Patterns

### For New Projects
Start with the git-workflow module to establish repository structure, then progress through modules as your project develops.

### For Existing Projects
Use individual modules to improve specific areas:
- Need better code reviews? Use the code-review module
- Testing coverage issues? Use the testing-strategies module
- Deployment problems? Use the deployment-procedures module

### For Team Onboarding
Guide new team members through the modules in order to establish consistent practices.

## Integration Benefits

This modular approach provides several advantages over monolithic workflows:

- **Token Efficiency**: Load only the modules you need (60% token reduction for most operations)
- **Focused Learning**: Each module concentrates on a specific development area
- **Flexible Implementation**: Adopt modules incrementally based on project needs
- **Team Specialization**: Different team members can focus on different modules

## Quality Assurance

Each module includes validation tools to validate best practices:
- Automated quality checks
- Performance benchmarks
- Security validations
- Documentation standards

Use the quality-metrics tool to assess your workflow implementation:
```bash
quality-metrics --workflow development-workflow --modules all
```
**Verification:** Run the command with `--help` flag to verify availability.

## Customization

This workflow is designed to be adaptable:
- Extend modules with project-specific practices
- Add custom tools to the scripts/ directory
- Configure module interactions for your team's needs
- Integrate with existing development tools and platforms

## Support and Resources

See the modules directory for detailed documentation on:
- Code review workflows
- Deployment procedures
- Documentation guidelines
- Git workflow patterns
- Testing strategies
## Troubleshooting

### Common Issues

**Command not found**
Ensure all dependencies are installed and in PATH

**Permission errors**
Check file permissions and run with appropriate privileges

**Unexpected behavior**
Enable verbose logging with `--verbose` flag