clydehub

Clydehub - Git Workflow Plugin

A comprehensive Claude Code plugin for managing Git workflows with automated linting, type checking, and CI validation.

Features

• Smart commits with automatic lint fixing and type checking
• Pull request creation with GitHub PR checks monitoring
• Branch syncing with clean rebase workflow
• Test debugging for investigating specific failures
• CI validation without running full test suites locally
• Zero Claude attribution in commits

Tech Stack Preferences

JavaScript/TypeScript

• Package manager: pnpm
• Linting/Formatting: biome
• Type checking: tsc
• Tests: pnpm test

Python

• Package manager: uv
• Linting: ruff check --fix
• Formatting: ruff format
• Type checking: ty check
• Tests: uv run pytest

Commands

/commit [message]

Create a smart commit with automatic linting and type checking.

Workflow:

1. Stage relevant files
2. Run linters and auto-fix
3. Run type checking
4. Stage fixes
5. Create commit

Important: Does NOT run tests. No Claude attribution added.

/pr [title]

Create a pull request with validation.

Workflow:

1. Lint and type check
2. Commit any pending changes
3. Push to remote
4. Create PR with gh pr create
5. Monitor PR checks with gh pr checks
6. Return PR URL and deployment info

Important: Relies on GitHub PR checks, not local test runs.

/lint-fix

Run all linters and automatically fix issues.

Detects and runs:

• JavaScript/TypeScript: pnpm biome check --write
• Python: uv run ruff check --fix, uv run ruff format

/ci-check

Run comprehensive CI validation locally.

Runs in order:

1. Linters (auto-fix)
2. Type checking
3. Tests
4. Build (if applicable)

Important: Stops at first failure.

/sync

Sync current branch with main/master.

Workflow:

1. Fetch latest
2. Ensure clean working directory
3. Rebase on main
4. Handle conflicts if needed
5. Run linters
6. Report status

Important: No stashing. Requires clean working directory.

/test-debug [test-name]

Debug a specific failing test.

Workflow:

1. Run specific test
2. Analyze failures
3. Iterate on fixes
4. After test passes: lint → type check → test again
5. Stage all changes

Important: For investigating specific failures, not running full suite.

Custom Agent

@git-workflow

Specialized agent for Git operations with strict adherence to:

• No Claude Code attribution
• Always lint before commits
• Use pnpm/uv, biome/ruff
• Clean workflows (no stashing)
• Fail fast with clear errors

Hooks

PreToolUse

• lint-before-commit: Validates linting before git commits

PostToolUse

• verify-no-claude-attribution: Ensures no Claude Code attribution in commit messages

Installation

/plugin install clydehub

Configuration

This plugin is opinionated and configured for:

• Modern JavaScript/TypeScript development with pnpm and biome
• Python development with uv and ruff
• Clean Git workflows without attribution noise
• GitHub-centric CI/CD (gh CLI)

What This Plugin Does NOT Do

• ❌ Add Claude Code attribution to commits
• ❌ Suggest npm, yarn, eslint, prettier, or black
• ❌ Use git stash
• ❌ Run full test suites as part of commit flow
• ❌ Force-push without confirmation

License

MIT