DevFlow - Developer Workflow Automation Plugin

Streamline your development workflow with intelligent automation, code generation, and project management capabilities.

Overview

DevFlow is a comprehensive Claude Code plugin that enhances developer productivity by automating common workflows, generating boilerplate code, managing project configurations, and integrating with development tools.

Features

1. Project Scaffolding

•Generate project templates for various tech stacks
•Intelligent configuration file generation
•Directory structure creation based on best practices
•Dependency management setup

2. Code Generation

•Boilerplate code for common patterns
•API endpoint scaffolding
•Database schema generation
•Test file generation
•Documentation generation

3. Workflow Automation

•Git workflow helpers
•CI/CD pipeline generation
•Docker configuration
•Environment setup automation

4. Development Tools Integration

•GitHub integration
•Docker management
•Database migrations
•API testing helpers

5. Code Quality

•Linting configuration
•Code formatting setup
•Pre-commit hooks
•Testing framework setup

Commands

Project Initialization

bash

/devflow init <project-type>
/devflow scaffold <template>

Code Generation

bash

/devflow generate api <endpoint-name>
/devflow generate model <model-name>
/devflow generate test <file-path>
/devflow generate component <component-name>

Configuration

bash

/devflow config docker
/devflow config ci-cd <platform>
/devflow config env <environment>
/devflow config prettier
/devflow config eslint

Workflow Commands

bash

/devflow workflow feature <name>
/devflow workflow release <version>
/devflow workflow deploy <environment>

Documentation

bash

/devflow docs api
/devflow docs readme
/devflow docs changelog

Usage Examples

Initialize a New Project

bash

/devflow init typescript-api

Creates a complete TypeScript API project with:

•Package.json with dependencies
•TypeScript configuration
•ESLint and Prettier setup
•Docker configuration
•GitHub Actions CI/CD
•Test setup with Jest
•API structure

Generate an API Endpoint

bash

/devflow generate api users

Creates:

•Controller file with CRUD operations
•Service layer
•Data models/types
•Validation schemas
•Route definitions
•Test files

Setup Docker Environment

bash

/devflow config docker

Generates:

•Dockerfile (optimized multi-stage)
•docker-compose.yml
•.dockerignore
•docker-compose.dev.yml
•docker-compose.prod.yml

Create Feature Branch Workflow

bash

/devflow workflow feature user-authentication

Automates:

•Create feature branch
•Setup tracking
•Generate task list
•Create PR template
•Setup local environment

Project Templates

Available Templates

Template	Stack	Features
`typescript-api`	TypeScript, Express, PostgreSQL	REST API, TypeORM, Jest
`nextjs-app`	Next.js 15, TypeScript, Tailwind	App Router, Server Components
`nestjs-microservice`	NestJS, TypeScript, Redis	CQRS, Event Sourcing
`python-fastapi`	Python, FastAPI, SQLAlchemy	Async, Pydantic, pytest
`react-native-app`	React Native, Expo, TypeScript	Navigation, State Management
`monorepo-turborepo`	Turborepo, pnpm, TypeScript	Multi-package, Shared configs
`docker-compose-stack`	Docker Compose	Multi-service orchestration

Template Customization

Templates are customizable via interactive prompts:

•Project name and description
•Database choice (PostgreSQL, MySQL, MongoDB, etc.)
•Authentication method (JWT, OAuth, Session)
•Package manager (npm, pnpm, yarn)
•Testing framework (Jest, Vitest, pytest)
•CI/CD platform (GitHub Actions, GitLab CI, Jenkins)

Configuration Files Generated

JavaScript/TypeScript Projects

•package.json - Dependencies and scripts
•tsconfig.json - TypeScript configuration
•.eslintrc.js - ESLint rules
•.prettierrc - Code formatting
•jest.config.js - Test configuration
•.env.example - Environment template

Docker

•Dockerfile - Container definition
•docker-compose.yml - Service orchestration
•.dockerignore - Build exclusions

CI/CD

•.github/workflows/*.yml - GitHub Actions
•.gitlab-ci.yml - GitLab CI
•Jenkinsfile - Jenkins pipeline

Git

•.gitignore - Git exclusions
•.gitattributes - Git attributes
•.git-hooks/ - Custom git hooks

Intelligent Features

Context-Aware Generation

DevFlow analyzes your existing project structure to:

•Match coding style and conventions
•Use consistent naming patterns
•Follow project-specific architecture
•Integrate with existing tools

Best Practices Enforcement

•Industry-standard directory structures
•Security best practices (no hardcoded secrets)
•Performance optimizations
•Accessibility standards
•SEO optimization

Smart Dependency Management

•Automatically install required dependencies
•Version compatibility checking
•Peer dependency resolution
•Dependency security scanning

Integration with Other Tools

Git Integration

•Automatic branch creation
•Commit message templates
•PR description generation
•Changelog automation

Docker Integration

•Container health checks
•Volume management
•Network configuration
•Multi-stage builds

Database Integration

•Migration generation
•Seed data creation
•Schema validation
•Query optimization

API Integration

•OpenAPI/Swagger generation
•Postman collection export
•API documentation
•Request validation

Advanced Workflows

Microservices Setup

bash

/devflow init microservices-mono

Creates:

•API Gateway
•Multiple services
•Message queue (RabbitMQ/Kafka)
•Service discovery
•Distributed tracing
•Centralized logging

Full-Stack Application

bash

/devflow init fullstack-app

Creates:

•Backend API (NestJS/FastAPI)
•Frontend (Next.js/React)
•Database (PostgreSQL)
•Redis cache
•Docker orchestration
•CI/CD pipeline

Serverless Project

bash

/devflow init serverless

Creates:

•Lambda functions
•API Gateway config
•DynamoDB tables
•CloudFormation/Terraform
•Local development setup
•Deployment scripts

Customization

Custom Templates

Create your own templates in ~/.claude/devflow/templates/:

code

templates/
├── my-custom-template/
│   ├── template.json
│   ├── files/
│   │   ├── package.json.hbs
│   │   ├── src/
│   │   └── README.md.hbs
│   └── hooks/
│       ├── pre-generate.js
│       └── post-generate.js

Template Variables

Use Handlebars syntax in template files:

json

{
  "name": "{{projectName}}",
  "version": "{{version}}",
  "description": "{{description}}"
}

Hooks

Custom logic for template generation:

pre-generate.js:

javascript

module.exports = async (context) => {
  // Validate inputs
  // Fetch additional data
  // Modify context
  return context;
};

post-generate.js:

javascript

module.exports = async (context, files) => {
  // Run post-generation commands
  // Install dependencies
  // Initialize git
};

Configuration

Global configuration in ~/.claude/devflow/config.json:

json

{
  "defaultPackageManager": "pnpm",
  "defaultGitProvider": "github",
  "defaultCICD": "github-actions",
  "codeStyle": {
    "indentation": "2 spaces",
    "quotes": "single",
    "semicolons": true
  },
  "templates": {
    "customPath": "~/.claude/devflow/templates"
  },
  "integrations": {
    "docker": true,
    "kubernetes": false,
    "terraform": true
  }
}

Best Practices

•
Always Review Generated Code: DevFlow generates production-ready code, but always review before committing
•
Customize Templates: Adapt default templates to match your team's conventions
•
Use Version Control: Generated code should be committed to track changes
•
Environment Variables: Never commit .env files; use .env.example
•
Security: Review security configurations, especially for production deployments
•
Testing: Generated tests are starting points; expand coverage as needed
•
Documentation: Keep generated documentation updated as code evolves

Troubleshooting

Template Not Found

bash

/devflow list-templates

Shows all available templates and their descriptions.

Dependency Conflicts

DevFlow checks for conflicts but manual resolution may be needed:

bash

npm ls
# or
pnpm why <package>

Generation Errors

Enable debug mode:

bash

export DEVFLOW_DEBUG=true
/devflow generate api users

Contributing

Adding New Templates

•Create template directory in ~/.claude/devflow/templates/
•Define template.json with metadata
•Create file templates using Handlebars
•Test generation
•Submit PR

Reporting Issues

Include:

•DevFlow version
•Command executed
•Error message
•Expected vs actual output

Examples

See examples/ directory for complete examples:

•examples/typescript-api/ - Complete TypeScript API project
•examples/nextjs-app/ - Next.js application
•examples/microservices/ - Microservices architecture
•examples/custom-template/ - Custom template example

License

MIT License - See LICENSE file

Support

•GitHub Issues: https://github.com/bmt/devflow/issues
•Documentation: https://devflow.bemind.tech
•Discord: https://discord.gg/devflow

Version: 1.0.0 Author: BeMind Technology Last Updated: 2026-01-04