Claude Dev Workflow

A production-tested collection of Claude Code skills, slash commands, hooks, CI/CD templates, and workflow documentation for AI-assisted software development.

Extracted from a real-world Turborepo monorepo powering web apps, mobile apps, and backend microservices. Everything is sanitized and templated for you to adopt in your own projects.

What's Included

Directory	What It Contains
claude-code/	Drop-in .claude/ directory: commands, hooks, skills, config
automation-skills/	Standalone automation scripts for iOS, testing, and Xcode
github-workflows/	Reusable CI/CD workflow templates for GitHub Actions
docs/	Developer workflow documentation and testing guides
config/	Linting, security, and build config templates

Quick Start

Full Adoption

Copy the entire Claude Code configuration into your project:

# Clone this repo
git clone https://github.com/TYLANDER/claude-dev-workflow.git

# Copy the .claude directory into your project
cp -R claude-dev-workflow/claude-code/ your-project/.claude/

# Customize the project context file
cp your-project/.claude/CLAUDE.md.example your-project/.claude/CLAUDE.md
# Edit CLAUDE.md with your project's details

Cherry-Pick Individual Pieces

You don't have to adopt everything. Pick what you need:

Just slash commands:

mkdir -p your-project/.claude/commands
cp claude-dev-workflow/claude-code/commands/*.md your-project/.claude/commands/

Just hooks:

mkdir -p your-project/.claude/hooks
cp claude-dev-workflow/claude-code/hooks/*.sh your-project/.claude/hooks/
chmod +x your-project/.claude/hooks/*.sh
# Add hook configuration to your .claude/settings.json (see claude-code/settings.json)

Just CI/CD workflows:

cp claude-dev-workflow/github-workflows/*.yml your-project/.github/workflows/
# Review and customize each workflow for your project

Just config templates:

cp claude-dev-workflow/config/commitlint.config.js your-project/
cp claude-dev-workflow/config/.gitleaks.toml your-project/
cp claude-dev-workflow/config/.gitignore.example your-project/.gitignore

Command Reference

Slash commands are invoked in Claude Code with /command-name.

Command	Purpose
/commit-push-pr	Stage, commit, push, and create a PR in one step
/precommit	Smart pre-commit validation — analyzes diff and runs checks
/pre-push	Pre-push validation to catch issues before pushing
/quick-check	Fast smoke tests for rapid iteration
/test-fix	Run tests and automatically fix failures
/lint-format	Lint and format changed files
/validate	Full validation suite across the entire codebase
/verify	Comprehensive verification suite
/deploy-dev	Build and deploy to dev environment
/rollback	Rollback to a previous deployment
/doc-write	Generate/update documentation for code changes
/ux-test	Test UX and accessibility for changed UI components
/ios-build	Build the iOS app
/ios-test	Run iOS tests
/xcode-sync	Sync and verify Xcode project files

Hook Reference

Hooks run automatically after Claude Code tool calls.

Hook	Trigger	Purpose
format-file.sh	Edit/Write	Auto-format files after Claude edits them
suggest-tests.sh	Edit/Write	Suggest test files for new components/services
notify-on-stop.sh	Stop	Desktop notification when Claude needs input
pre-deploy-check.sh	Bash(git push)	Verify quality gates before pushing deploy branches
check-deployment.sh	Bash(git push)	Monitor deployment status after pushing

Skills

PRD Generator (claude-code/skills/prd/)

A multi-file skill that generates AI-optimized Product Requirements Documents with blast radius analysis and machine-verifiable acceptance criteria. Invoke with /prd in Claude Code.

See PRD Skill Documentation for full usage.

Automation Skills (automation-skills/)

Standalone scripts for specialized tasks:

Skill	Purpose
test-suite-generator	Generate test files from source code
ios-build-doctor	Diagnose and fix iOS build issues
xcode-project-manager	Manage Xcode project file operations
swift-api-generator	Generate Swift API clients from specs

CI/CD Workflow Templates

Workflow	Purpose
ci.yml	Main CI pipeline: lint, test, build, scan
quality-gates.yml	Integration tests and coverage gates
security-scan.yml	CodeQL, Trivy, and gitleaks scanning
commitlint.yml	Enforce conventional commit messages
ai-review.yml	AI-powered code review on PRs
ai-test-generation.yml	Generate tests for uncovered code
todo-issues.yml	Auto-create GitHub issues from TODO comments

Documentation

Document	Purpose
Developer Workflow	Day-to-day development process
Branching Strategy	Git branching conventions
Testing Overview	Testing strategy and tools
Complete Testing Guide	Full testing walkthrough
Testing Checklist	Pre-release testing checklist
PRD Skill Guide	How to use the PRD generator

Recommended Workflow

For any non-trivial feature or change:

1. /prd — Generate a Product Requirements Document (explores codebase, maps blast radius, defines acceptance criteria)
2. Implement tasks from the PRD sequentially
3. /test-fix — Verify tests pass after each task
4. /precommit — Validate before committing
5. /commit-push-pr — Submit when complete

Configuration Templates

File	Purpose
commitlint.config.js	Conventional commit rules
.gitleaks.toml	Secret detection patterns and allowlists
.gitignore.example	Comprehensive gitignore for monorepos
turbo.json.example	Turborepo pipeline configuration

Contributing

Found a useful pattern? PRs are welcome. Please:

1. Keep files generic — no project-specific references
2. Add descriptions to new commands/hooks
3. Update this README if adding new files
4. Test commands in at least one real project

License

MIT