Releases: dean0x/devflow
Releases · dean0x/devflow
v0.9.0 - Add /get-issue command
What's New
Added
/get-issuecommand - Fetch GitHub issue details and create working branch- Fetch issue by number (
/get-issue 42) or search term (/get-issue fix login) - Display comprehensive issue details (title, body, labels, assignees, comments)
- Auto-generate branch names:
{type}/{number}-{slug} - Branch type derived from labels (feature, fix, docs, refactor, chore)
- Pre-flight checks for gh authentication and repository validation
- Fetch issue by number (
get-issuesub-agent - Specialized agent for GitHub issue workflow
Changed
- Optimized sub-agent model selection - 5 sub-agents switched to haiku model for simple tool-call tasks:
- get-issue, pull-request, project-state, tech-debt, pr-comments
- Minimized command files - Reduced
/get-issue(16 lines) and/pull-request(20 lines) to delegate work to sub-agents
Installation
npx devflow-kit initLinks
v0.8.1 - Clean CLI Output
DevFlow Kit v0.8.1
Improves the first-run experience with cleaner, command-focused output.
✨ What's New
Added
--verboseflag fordevflow init- Clean output by default- Default output shows only version, available commands, and docs link
- Use
--verbosefor detailed installation progress, paths, and skills list - Reduces noise and highlights what matters: the available commands
Changed
- Refactored init command output rendering into separate functions
- Extracted command and skill lists into maintainable constants
📦 Installation
npx devflow-kit init🔗 Links
v0.8.0 - Code Review Enhancements
What's New
Code Review Sub-Agent Architecture
Split the monolithic /code-review command into three specialized sub-agents:
- code-review - Summary report generation and merge recommendations
- pr-comments - Line-specific PR comments with fix suggestions
- tech-debt - GitHub issue management with deduplication and auto-cleanup
Features
- Automatic PR Comments: Creates individual comments for blocking and should-fix issues with code fix suggestions
- Tech Debt Tracking: Maintains a GitHub issue with pre-existing issues, auto-removes fixed items
- Pros/Cons Tables: When multiple fix approaches exist, shows comparison tables
- Claude Code Attribution: All generated comments include attribution footer
- Rate Limiting: Throttle delays between API calls to avoid GitHub rate limits
- Auto-Archive: Tech debt issue auto-archives when approaching 65k character limit
Improvements
- Simplified Phase 1 setup (reduced from ~55 to ~22 lines)
- Parallel execution of synthesis phase (3 agents run simultaneously)
- Cleaner separation of concerns
Installation
npx devflow-kit initLinks
- npm: https://www.npmjs.com/package/devflow-kit
- Changelog: https://github.com/dean0x/devflow/blob/main/CHANGELOG.md
🤖 Generated with Claude Code
v0.7.0 - Enhanced Commands with Brainstorm/Design Workflow
DevFlow Kit v0.7.0
Major enhancement of commands focusing on structured planning and deliberate decision-making.
Highlights
New Workflow Commands
/brainstorm- Explore design decisions and architectural approaches/design- Create detailed implementation plans with integration points/breakdown- Quick task decomposition (replaces /plan-next-steps)
Redesigned Commands
/plan- Deliberate issue triage: implement now, defer to GitHub issue, or skip/commit- Execute immediately without user confirmation/implement- Streamlined from 507 to ~100 lines
Architectural Improvements
- Commands follow orchestration principle (delegate, don't do heavy work)
- Standardized documentation framework with YYYY-MM-DD_HHMM timestamps
- Research skill updated to use brainstorm agent
Breaking Changes
/plan-next-stepsrenamed to/breakdown/researchcommand removed (use/brainstorm+/design)/planbehavior completely changed (triage vs batch selection)
Installation
npx devflow-kit initLinks
- npm: https://www.npmjs.com/package/devflow-kit
- Changelog: https://github.com/dean0x/devflow/blob/main/CHANGELOG.md
- PR: #19
🤖 Generated with Claude Code
v0.6.1 - Skills Auto-Discovery Fix
DevFlow Kit v0.6.1
Critical bug fix release that enables skill auto-discovery.
🐛 What Was Broken
In v0.6.0, skills were installed but not discoverable by Claude Code. They existed on disk but were never activated because they were in the wrong directory structure.
✅ What's Fixed
Skills Auto-Discovery
Skills are now installed in the correct flat structure that Claude Code expects:
Before (broken):
~/.claude/skills/devflow/pattern-check/SKILL.md ❌
After (working):
~/.claude/skills/pattern-check/SKILL.md ✅
Affected Skills (Now Working)
All 7 skills are now properly discovered and auto-activate:
pattern-check- Architectural pattern validationtest-design- Test quality enforcementcode-smell- Anti-pattern detectionresearch- Pre-implementation planningdebug- Systematic debugginginput-validation- Boundary validationerror-handling- Result type consistency
Automatic Migration
When upgrading to v0.6.1:
- Old nested structure is automatically cleaned up
- Skills are reinstalled in correct flat structure
- No manual intervention needed
Uninstall Fixed
The uninstall command now correctly removes individual skill directories instead of attempting to remove the non-existent nested structure.
📦 Upgrade Instructions
npx devflow-kit initThat's it! The installer handles the migration automatically.
🔍 Verification
After upgrading, verify skills are discovered by asking Claude:
"What skills are available?"
You should see all 7 DevFlow skills listed.
📝 Changes
Fixed
- Skills installation structure for auto-discovery
- Uninstall command now correctly removes skill directories
- Migration cleanup for users upgrading from nested structure
🔗 Links
- npm: https://www.npmjs.com/package/devflow-kit/v/0.6.1
- Changelog: https://github.com/dean0x/devflow/blob/main/CHANGELOG.md#061---2025-11-04
- Previous Release: https://github.com/dean0x/devflow/releases/tag/v0.6.0
Impact: This fix unblocks the core value proposition of DevFlow's quality enforcement system. If you installed v0.6.0, please upgrade to v0.6.1 immediately to enable skill auto-activation.
v0.6.0 - Complete PR Workflow Commands
DevFlow Kit v0.6.0
This release introduces a complete PR workflow system with intelligent commands for planning, creating, and resolving pull requests.
🎯 Highlights
Complete PR Workflow Commands
Three new slash commands that work together seamlessly:
/plan - Smart implementation planning
- Analyzes tasks and breaks them into steps
- Generates atomic commit strategy
- Creates structured implementation roadmap
/pull-request - Intelligent PR creation
- Analyzes all commits and changes
- Generates comprehensive PR descriptions
- Detects breaking changes automatically
- Assesses PR size and suggests splits
/resolve-comments - Systematic feedback resolution
- Fetches and triages PR review comments
- Implements requested changes with user guidance
- Posts replies to reviewers
- Tracks resolution progress
Enhanced Audit System
Three-Category Reporting:
- 🚨 Blocking Issues - Must fix before merge (security, critical bugs)
⚠️ Should Fix - Important improvements (performance, architecture)- 💡 Informational - Nice-to-haves (suggestions, optimizations)
Code Review Rewrite:
- Parallel agent execution (9 specialized audits)
- Comprehensive review summaries
- Actionable recommendations with file/line references
📝 Changes
Added
/plancommand for implementation planning/pull-requestcommand with auto-description generation/resolve-commentscommand for PR feedback workflow- Three-category audit reporting system
- Parallel code review agent execution
- PR size assessment and split recommendations
Changed
- Code review command rewritten for better analysis
- Audit output format improved with severity levels
- Enhanced documentation with workflow examples
Fixed
- Type safety: Replaced
error: anywith proper type guards in init.ts - Documentation: Fixed CLI command examples in README (
devflow→npx devflow-kit) - Statusline: Container-specific CPU and memory metrics
📦 Installation
npx devflow-kit init🔗 Links
v0.5.0 - Installation Scopes & Smart Uninstall
DevFlow Kit v0.5.0
Major release introducing flexible installation scopes and intelligent uninstall detection, making DevFlow suitable for both personal and team projects.
Highlights
Two-Tier Installation Strategy
Choose how DevFlow integrates with your workflow:
- User scope (default): Install once, use everywhere (
~/.claude/) - Local scope: Project-specific installation for team projects (
<git-root>/.claude/) - Interactive prompt guides you through the choice
- Perfect for teams wanting version-controlled DevFlow configuration
Smart Uninstall
Intelligent scope detection makes cleanup effortless:
- Auto-detects which scopes have DevFlow installed
- Removes from all detected scopes by default
- Manual override available:
--scope <user|local> - Clear feedback showing what's being uninstalled
Code Quality Improvements
Significant refactoring for maintainability:
- Extracted shared utilities (
paths.ts,git.ts) - Eliminated 65+ lines of code duplication
- Cached git operations for better performance
- Single source of truth for path resolution
Changes
Added
Installation Scope Support
- Two-tier installation strategy (user-wide and project-specific)
- Interactive scope selection prompt
- CLI flag:
devflow init --scope <user|local> - Automatic .gitignore updates for local scope
- Clear descriptions for each scope option
Smart Uninstall
- Auto-detection of installed scopes
- Removes from all detected scopes by default
- Manual scope targeting with
--scopeflag - Clear feedback on uninstall operations
Changed
Code Quality
- Extracted
src/cli/utils/paths.tsfor path resolution - Extracted
src/cli/utils/git.tsfor git operations - Reduced duplication by ~65 lines
- Single source of truth for shared logic
Performance
- Cached git root detection (no redundant
git rev-parsecalls) - Faster installation in large repositories
Fixed
CI/CD Compatibility
- TTY detection for interactive prompts
- Falls back to user scope in non-interactive environments
- Clear messaging when running in CI/CD
- Explicit flag instructions for automation
Security
- Environment variable path validation
- Absolute path requirement for custom directories
- Path traversal attack prevention
- Warning for paths outside home directory
Documentation
- Installation Scopes section in README
- Updated CLI commands table
- Migration guide for existing users
- .gitignore patterns for local scope
Installation
# User scope (default) - once for all projects
npx devflow-kit init
# Local scope - project-specific installation
npx devflow-kit init --scope local
# Interactive - choose during installation
npx devflow-kit initMigration Guide
Existing installations continue working unchanged:
- Default scope is
userfor backward compatibility - No action required for current users
- Run
devflow init --scope localto convert to project-specific
Links
- npm: https://www.npmjs.com/package/devflow-kit/v/0.5.0
- Changelog: https://github.com/dean0x/devflow/blob/main/CHANGELOG.md
- Documentation: https://github.com/dean0x/devflow/blob/main/README.md
- Previous Release: https://github.com/dean0x/devflow/releases/tag/v0.4.0
Generated with DevFlow release automation
v0.4.0 - Skills Infrastructure & Smart Implementation
DevFlow Kit v0.4.0
Major release introducing auto-activating skills system, smart interactive commands, and enhanced dual-mode architecture for intelligent development workflows.
🎯 Highlights
Skills Infrastructure
Auto-activating skills system that intelligently activates based on conversation context:
- 7 new skills: research, debug, devlog, test-generation, api-integration, data-migration, refactoring-assistant
- Skills replace standalone commands with intelligent activation patterns
- Installed to
~/.claude/skills/devflow/directory - Displayed on init with clear descriptions
Smart Interactive Commands
/implement command - Orchestrated workflow for guided feature implementation:
- Interactive planning, research, and execution phases
- Integrates with project-state agent for context gathering
- Prevents blind coding by requiring user approval at each stage
- Guides through research, design, implementation, and testing
Command→Agent→Skill Architecture
Dual-mode pattern for both explicit and automatic activation:
- Commands:
/research,/debugfor explicit user requests - Skills: Auto-activated versions when conversation context matches
- Clear separation of concerns and activation modes
📝 Changes
Added
Skills Infrastructure
- Auto-activating skills system with intelligent context-aware capabilities
- 7 new skills covering research, debugging, devlog, testing, API integration, data migration, and refactoring
- Skills displayed on devflow init with clear descriptions
- Automatic activation based on conversation context
Smart Interactive Commands
/implementcommand - Orchestrator for guided feature implementation- Interactive workflow with project-state agent integration
- Guides through research, design, implementation, and testing phases
- Prevents blind coding with user approval at each stage
Command→Agent→Skill Architecture
- Dual-mode pattern for explicit invocation and auto-activation
- Commands for explicit user requests
- Skills for automatic context-based activation
- Documented pattern for extending DevFlow functionality
Enhanced /devlog Command
- Orchestrator pattern using project-state agent
- Cleaner separation of orchestration vs analysis logic
- More maintainable and extensible architecture
- Comprehensive session documentation with context gathering
Changed
- Skills-first approach - research and debug migrated to dual-mode (command + skill)
- Commands remain for explicit invocation
- Skills provide automatic activation based on context
- No loss of functionality, enhanced discoverability
Fixed
-
Security vulnerability - Added input validation for execSync to prevent command injection
- Validates all user input before shell execution
- Proper escaping and sanitization
- Security hardening in CLI commands
-
Uninstall bug - Fixed cleanup issue and refactored CLI to namespace pattern
- Proper cleanup of all installed assets
- Consistent namespace pattern across CLI
- Improved error handling and user feedback
Documentation
-
Comprehensive skills guide - Added to README and CLAUDE.md
- Detailed explanation of skills infrastructure
- How to create new skills
- When to use skills vs commands
- Auto-activation patterns and best practices
-
Development guide updates - Enhanced CLAUDE.md for contributors
- Skills development patterns
- Command→Agent→Skill architecture explanation
- Testing guidelines for dual-mode functionality
-
Documentation gap fixes - Addressed critical gaps from code review
- Improved clarity and completeness
- Fixed missing examples and use cases
- Better organization and navigation
📦 Installation
npx devflow-kit initOr upgrade existing installation:
npx devflow-kit init --force🔗 Links
- npm: https://www.npmjs.com/package/devflow-kit
- Changelog: https://github.com/dean0x/devflow/blob/main/CHANGELOG.md
- Previous Release: https://github.com/dean0x/devflow/releases/tag/v0.3.3
🤖 Generated with Claude Code
v0.3.3 - Release Automation & Agent Architecture
DevFlow Kit v0.3.3
This release introduces comprehensive release automation capabilities and establishes DevFlow as a complete release management toolkit for any programming language or ecosystem.
🎯 Highlights
🤖 Universal Release Automation Agent
- Multi-Language Support: Automatic detection and handling for Node.js, Rust, Python, Go, Ruby, PHP, Java (Maven/Gradle), Swift, and generic projects
- Intelligent Versioning: Analyzes commit history to suggest appropriate version bumps (major/minor/patch)
- Automated Changelog: Generates structured changelog entries from git commit messages following Keep a Changelog format
- Safe Workflows: Comprehensive pre-publish verification, build testing, and rollback instructions
🏗️ Professional Release Management
- Quality Gates: Enforces clean working directory, successful builds, and passing tests before publication
- Platform Integration: Native support for GitHub and GitLab release creation via CLI tools
- Package Publishing: Automated publishing to npm, crates.io, PyPI, RubyGems, Packagist, and more
- Error Recovery: Clear rollback instructions and step-by-step recovery guidance for failed releases
🔧 Developer Experience Improvements
- Project Detection: Automatically identifies project type and configuration from manifest files
- Version Bump Suggestions: Analyzes breaking changes, features, and fixes to recommend appropriate version increments
- Change Analysis: Categorizes commits by type to provide release insights
- Release Verification: Post-publish verification checklist and next steps
📝 Changes
Added
- New
/releasecommand for guided release automation - Universal release workflow supporting 10+ programming languages/ecosystems
- Automatic project type detection from manifest files (package.json, Cargo.toml, pyproject.toml, etc.)
- Intelligent semantic version bump suggestions based on commit analysis
- Automated changelog generation following Keep a Changelog format
- Comprehensive release verification and quality gates
- Platform-specific release creation (GitHub/GitLab)
- Safe rollback procedures for failed releases
- Dedicated release automation specialist agent
Changed
- Enhanced agent architecture documentation
- Improved error handling patterns across all agents
- Clarified token optimization strategies
Documentation
- Added comprehensive release automation workflow documentation
- Documented universal release steps (13 stages)
- Added project detection and configuration guide
- Documented safety rules and quality gates
- Added error recovery procedures
📦 Installation
npx devflow-kit init🚀 Quick Start
After installation, create a release:
/releaseThe release agent will:
- Detect your project type automatically
- Analyze changes since last release
- Suggest appropriate version bump
- Generate changelog from commits
- Run tests and build
- Guide you through publication
- Create git tags and GitHub/GitLab releases
🔗 Links
- npm: https://www.npmjs.com/package/devflow-kit
- Changelog: https://github.com/dean0x/devflow/blob/main/CHANGELOG.md
- Previous Release: https://github.com/dean0x/devflow/releases/tag/v0.3.2
- Documentation: https://github.com/dean0x/devflow#readme
v0.3.2 - UX Improvements
DevFlow Kit v0.3.2
UX improvements and code simplification patch release.
🎯 Highlights
Simplified Init Command Output
- 70-85% reduction in installation output (60-80 lines → 10-15 lines)
- Removed verbose sections while preserving essential information
- Better signal-to-noise ratio for cleaner user experience
Unified Review Commands
- Consolidated
/pre-commit+/pre-pr→/code-review - Single command handles both uncommitted changes and full branch reviews
- Reduced cognitive overhead (8 commands instead of 9)
Streamlined Statusline
- 28% code reduction (115 lines → 83 lines)
- Removed cost tracking, API metrics, session duration
- Added model name, CPU usage, memory usage (cross-platform)
- Cleaner aesthetic with double-space separators
📝 Changes
Changed
- Simplified init command output - Reduced installation output from ~60-80 lines to ~10-15 lines
- Unified review commands - Consolidated /pre-commit and /pre-pr into single /code-review command
- Streamlined statusline - Removed cost/API metrics, added CPU/memory monitoring (28% code reduction)
Improved
- Replaced /catch-up suggestion with comprehensive commands reference for better initial UX
📦 Installation
```bash
npx devflow-kit init
```