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 validation
• test-design - Test quality enforcement
• code-smell - Anti-pattern detection
• research - Pre-implementation planning
• debug - Systematic debugging
• input-validation - Boundary validation
• error-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 init

That'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

• /plan command for implementation planning
• /pull-request command with auto-description generation
• /resolve-comments command 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: any with 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

• 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.5.0

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 --scope flag
• Clear feedback on uninstall operations

Changed

Code Quality

• Extracted src/cli/utils/paths.ts for path resolution
• Extracted src/cli/utils/git.ts for git operations
• Reduced duplication by ~65 lines
• Single source of truth for shared logic

Performance

• Cached git root detection (no redundant git rev-parse calls)
• 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 init

Migration Guide

Existing installations continue working unchanged:

• Default scope is user for backward compatibility
• No action required for current users
• Run devflow init --scope local to 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, /debug for 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

• /implement command - 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 init

Or 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 /release command 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:

/release

The release agent will:

1. Detect your project type automatically
2. Analyze changes since last release
3. Suggest appropriate version bump
4. Generate changelog from commits
5. Run tests and build
6. Guide you through publication
7. 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
```

🔗 Links

• npm: https://www.npmjs.com/package/devflow-kit/v/0.3.2
• Changelog: https://github.com/dean0x/devflow/blob/main/CHANGELOG.md
• Previous Release: https://github.com/dean0x/devflow/releases/tag/v0.3.1

v0.3.1 - Critical Crash Fix

DevFlow Kit v0.3.1

Critical stability fix for the catch-up agent that prevented Claude Code session crashes in large codebases.

Fixed

Catch-Up Agent Crash Prevention

• Replaced expensive full-project scans with surgical git diff --name-only HEAD~1 for targeted analysis
• Removed automatic test execution that caused timeout crashes on large test suites
• Removed automatic build execution that exhausted system resources
• Scoped TODO/FIXME search to recently modified files only (git-based)
• Maintains user-preferred 5 status document limit for concise summaries
• Cleaner code with reduced safety comment overhead
• Critical fix for large codebases that caused Claude Code to hang or crash

This release ensures /catch-up works reliably across projects of any size without risking session stability.

Installation

npx devflow-kit init

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.0

v0.3.0 - Language-Agnostic Excellence & Release Automation

DevFlow Kit v0.3.0

Major release introducing language-agnostic global engineering principles, smart CLAUDE.md installation, TypeScript-specific auditing, and comprehensive release automation.

Highlights

Language-Agnostic Global CLAUDE.md

Universal engineering principles that work across all programming languages:

• Strips language-specific syntax, focuses on concepts (Result types, DI, immutability, pure functions)
• Critical anti-patterns enforcement (NO FAKE SOLUTIONS, FAIL HONESTLY, BE TRANSPARENT)
• Code quality enforcement (root cause analysis over workarounds)
• Architecture documentation standards (document patterns, boundaries, exceptions)
• Type safety best practices, security requirements, naming conventions
• ~330 lines of precise, non-bloated global instructions

Smart CLAUDE.md Installation

Intelligent mounting logic that preserves user's existing configuration:

• Fresh install: Directly installs CLAUDE.md (no conflicts)
• Existing CLAUDE.md: Preserves user file, creates CLAUDE.devflow.md with merge instructions
• --force flag: Prompts for confirmation, backs up to .backup before override
• -y flag: Auto-approves prompts for automation/CI/CD workflows
• Never overwrites without explicit permission

TypeScript Auditor Sub-Agent

Specialized TypeScript code quality and type safety auditor:

• Conditional execution: Runs only if .ts/.tsx files changed OR tsconfig.json exists
• Built-in detection logic (gracefully skips non-TypeScript projects)
• Comprehensive audits: type safety config, any usage, type assertions, branded types
• Advanced patterns: discriminated unions, immutability, Result types
• Code quality: naming conventions, dependency injection, pure functions
• Severity-based reporting (CRITICAL/HIGH/MEDIUM/LOW) with file:line references
• Integrated into /pre-commit and /pre-pr workflows

Release Automation

Project-agnostic release automation for professional releases:

• Multi-step interactive workflow with user confirmations
• Preview changes before committing, pushing, or publishing
• 10+ ecosystems supported: Node.js, Rust, Python, Go, Ruby, PHP, Java (Maven/Gradle), Swift, Generic
• Intelligent version bumping based on conventional commit analysis
• Auto-generated changelogs from git history
• Built-in safety checks (clean directory, builds, tests)
• Platform integration (creates GitHub/GitLab releases via gh/glab)
• Clear rollback instructions if any step fails

Changes

Added

• Language-agnostic global CLAUDE.md with universal engineering principles
• Smart CLAUDE.md installation with 3-tier backup strategy
• TypeScript auditor sub-agent (audit-typescript)
• /release command for release automation
• release sub-agent for safe, automated release management
• Support for 10+ release ecosystems

Changed

• Pre-commit workflow: Integrated audit-typescript into 5-agent review
• Pre-PR workflow: Integrated audit-typescript into comprehensive review

Documentation

• Added /release command to README commands table
• Added release and audit-typescript sub-agents to README
• Created "Creating a Release" workflow section
• Documented smart CLAUDE.md installation behavior

Installation

npx devflow-kit@0.3.0 init

Or update existing installation:

npx devflow-kit@latest init

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.2.0

---

Generated with Claude Code - DevFlow Kit

v0.2.0 - Documentation Agent & Language-Agnostic Improvements

DevFlow Kit v0.2.0

Major feature release enhancing DevFlow with documentation tracking, surgical test execution, and universal language support.

🎯 Highlights

📚 Documentation Audit Agent

New audit-documentation sub-agent ensures docs stay in sync with code:

• Validates README accuracy (installation, usage, examples)
• Checks API documentation matches actual function signatures
• Detects stale code comments and zombie code
• Verifies code examples actually work
• Language-agnostic documentation pattern detection
• Severity-based reporting (CRITICAL/HIGH/MEDIUM/LOW)

🧪 Surgical Test Execution

Prevents Claude Code session crashes with smart test execution:

• Static analysis by default - 80% value, 0% crash risk
• Smart test selection based on git changes
• Individual test file execution with 30s timeouts
• Max 10 test files per run with resource limits
• Early termination on repeated error patterns

🌍 Language-Agnostic Agents

All agents now work with any programming language/ecosystem:

• Auto-detection for 9+ package managers
• Universal ORM and database patterns
• Smart test command detection from manifests
• Generic file search patterns for all ecosystems

⚙️ Smart Settings Management

3-tier backup strategy prevents data loss:

• First install: Direct installation
• Existing settings: Backup to managed-settings.json
• Both exist: Save as settings.devflow.json with clear instructions
• User maintains full control of configuration

📝 Changes

Added

• audit-documentation sub-agent for docs-code alignment
• Smart settings.json management with 3-tier backup strategy
• Surgical test execution prevents session crashes
• Language-agnostic agents work with any programming language

Changed

• Pre-commit strategy - Lightweight 5-agent review (30-60s)
  • Core audits: Security, Performance, Architecture, Tests, Complexity
  • Additional audits available on explicit request
• Pre-pr strategy - Comprehensive 7-8 agent review (2-3 min)
  • All core audits plus Dependencies and Documentation
  • Conditional Database audit (only if DB files changed)
• Path handling - No longer assumes HOME environment variable
  • Uses Node.js homedir() as fallback
  • Environment variable overrides: CLAUDE_CODE_DIR, DEVFLOW_DIR

Fixed

• Git lock file conflicts - Wait-based prevention instead of deletion
  • Implemented wait_for_lock_release() with 10s timeout
  • Explicit wait commands after each git operation
  • Prevents zombie process lock file issues
• Settings overwrite issue - User settings preserved with backup strategy
• Hardcoded path assumptions - Proper fallbacks and environment overrides

📦 Installation

```bash
npx devflow-kit init
```

🔗 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.1.2

v0.1.2 - Research Command

DevFlow Kit v0.1.2

Add comprehensive pre-implementation research capabilities to your development workflow.

🎯 Highlights

New /research Command

Research implementation approaches before writing code. The research agent follows a systematic 10-step workflow:

1. Problem Analysis - Extract core requirements and constraints
2. Approach Evaluation - Compare 3-5 different solutions with pros/cons
3. Documentation Study - Find official docs, code examples, best practices
4. Codebase Review - Analyze existing patterns, conventions, reusable code
5. Integration Design - Plan file changes with specific paths and line numbers
6. Risk Identification - Honest assessment of challenges and trade-offs
7. Implementation Plan - Concrete, actionable steps ready for development
8. Todo Checklist - TodoWrite integration for progress tracking
9. Clear Recommendation - Opinionated choice with rationale
10. Research Report - Saved to .docs/research/ for reference

Philosophy: Research must be actionable, not academic. Every finding translates to concrete implementation steps.

📝 Changes

Added

• /research [topic] - Pre-implementation research and planning command
• research sub-agent - Specialized implementation planning specialist
  • Analyzes multiple implementation approaches
  • Studies official documentation and code examples
  • Reviews existing codebase patterns and conventions
  • Designs integration strategy with specific file paths
  • Identifies risks and creates actionable plans
  • Saves comprehensive reports to .docs/research/

Documentation

• Updated README.md with research command in workflow
• Added research sub-agent to sub-agents table
• Updated integration examples

📦 Installation

npx devflow-kit init

💡 Usage Examples

# Research before implementing
/research "add JWT authentication"
/research "implement real-time notifications"
/research "migrate from REST to GraphQL"

# Then implement with confidence
/pre-commit
/commit

🔗 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.1.1