claude-plugins/plugins/workflow/README.md

Workflow Plugin for Claude Code

A comprehensive plugin providing Git workflow, code quality, testing, and context management commands for Claude Code.

Installation

# Add to your project
claude plugins add workflow --source https://gitea.romfast.ro/romfast/claude-plugins

# Or test locally
claude --plugin-dir ./plugins/workflow

Commands Overview

Git Workflow (5 commands)

Command	Description
/workflow:commit	Smart commit with conventional message
/workflow:push	Push with safety checks
/workflow:pr	Create PR with auto-generated summary
/workflow:sync	Pull + rebase + push in one command
/workflow:issue <n>	Analyze and fix GitHub issue #n

Code Quality (4 commands)

Command	Description
/workflow:simplify	Reduce code complexity without changing behavior
/workflow:format	Run code formatters (prettier, eslint, black)
/workflow:cleanup	Remove unused imports and dead code
/workflow:refactor	Detect patterns and suggest improvements

Testing & Verification (3 commands)

Command	Description
/workflow:test	Smart test runner (changed files only)
/workflow:check	Run typecheck + lint + test combined
/workflow:verify	End-to-end verification of implementation

Context Management (3 commands)

Command	Description
/workflow:catchup	Rebuild context after /clear
/workflow:save	Save progress to HANDOFF.md
/workflow:onboard	Quick onboarding to a new project

Usage Examples

Daily Workflow

# Start of day - sync your branch
/workflow:sync

# After implementing a feature
/workflow:check          # Verify everything works
/workflow:commit         # Create commit

# Create PR when ready
/workflow:pr

# End of day - save context
/workflow:save
/clear

# Next session - restore context
/workflow:catchup

Fix a GitHub Issue

/workflow:issue 42

This will:

1. Fetch issue details from GitHub
2. Search codebase for relevant files
3. Implement the fix
4. Run tests
5. Create a commit referencing the issue

Code Review Workflow

# After making changes
/workflow:verify         # Full verification
/workflow:simplify       # Simplify if needed
/workflow:commit         # Commit changes
/workflow:pr             # Create PR

New Project Onboarding

cd /path/to/new/project
claude

# In Claude:
/workflow:onboard

Subagents

The plugin includes specialized subagents for complex tasks:

code-simplifier

Used by /workflow:simplify for multi-file simplification.

app-verifier

Used by /workflow:verify for comprehensive verification.

Templates

Located in templates/:

• commit-message.md - Conventional commit format
• pr-template.md - Pull request body template
• handoff-template.md - Context handoff format

Configuration

The plugin auto-detects your project's tech stack and tools. No configuration needed.

Supported Stacks

• JavaScript/TypeScript: Jest, Vitest, ESLint, Prettier
• Python: pytest, mypy, ruff, black
• Go: go test, go fmt
• Rust: cargo test, cargo fmt

Best Practices

1. Use /workflow:check before committing - Catch issues early
2. Use /workflow:save before /clear - Preserve context
3. Use /workflow:catchup to restore context - Continue seamlessly
4. Use /workflow:issue for GitHub issues - Automate the fix process

Inspiration

This plugin is inspired by:

• wshobson/commands
• awesome-claude-code
• claude-code-tips
• Anthropic Best Practices

License

MIT

Contributing

Contributions welcome! Please follow the conventional commit format.