v1.6.1

Added

• --dry-run flag for devflow uninstall — preview removal plan without deleting anything

Fixed

• Ambient skill loading — removed allowed-tools restriction from ambient-router so skills actually load via the Skill tool
• Ambient hook preamble — explicit Skill tool instruction ensures models invoke skills rather than responding directly
• Init wizard — hide devflow-ambient from plugin multiselect (auto-included via ambient prompt)
• Working memory — replaced broken --resume with transcript-based background updater

v1.6.0

Added

• Ambient agent orchestration: ORCHESTRATED tier spawns agent pipelines for IMPLEMENT, DEBUG, PLAN intents
• Orchestration skills: implementation-orchestration, debug-orchestration, plan-orchestration for ambient agent pipelines
• knowledge-persistence skill (#145) — extraction procedure, lock protocol, loading instructions for project knowledge
• Knowledge loading phase (#145) — /debug, /specify, /self-review now load project knowledge at startup
• Pitfall recording phase (#145) — /code-review, /resolve record pitfalls to .memory/knowledge/pitfalls.md
• Knowledge directory (#145) — .memory/knowledge/ with decisions.md (ADR-NNN, append-only) and pitfalls.md (area-specific gotchas)

Changed

• Ambient mode: Three depth tiers (QUICK/GUIDED/ORCHESTRATED) replacing old QUICK/GUIDED/ELEVATE
• Ambient mode: GUIDED tier for small-scope IMPLEMENT (≤2 files), simple DEBUG, focused PLAN, and REVIEW — main session with skills + Simplifier
• Ambient mode: BUILD intent renamed to IMPLEMENT for clarity
• Coder agent: Added test-driven-development and search-first to permanent skills
• Command phase numbering (#145) — renumbered fractional phases to sequential integers across 12 command files

Fixed

• Agent metadata (#146) — fixed subagent_type in debug, added missing YAML frontmatter
• Plugin count (#146) — corrected to "8 core + 9 optional"
• Skills catalog (#146) — cataloged 3 missing skills in reference
• Debug command (#147) — removed non-standard name= parameter
• Plugin descriptions (#147, #148) — synced across plugin.json, plugins.ts, marketplace.json
• Simplifier agent (#148) — added Output/Boundaries sections
• Plugin metadata (#148) — added homepage/repository/license/keywords to 3 plugins

Removed

• /ambient command: Ambient mode is now hook-only. Use devflow ambient --enable to activate.

Behavioral Changes

• EXPLORE intent now always classifies as QUICK (was split QUICK/GUIDED)
• Simple text edits ("Update the README") classify as QUICK (was BUILD/GUIDED)
• Debug agent budget cap removed — agents scale to investigation needs

v1.5.0

Added

• Search-first skill (#111) — New skill enforcing research before building custom utility code. 4-phase loop: Need Analysis → Search (via Explore subagent) → Evaluate → Decide (Adopt/Extend/Compose/Build)
• Reviewer confidence thresholds (#113) — Each review finding now includes a visible confidence score (0-100%). Only ≥80% findings appear in main sections; lower-confidence items go to a capped Suggestions section. Adds consolidation rules to group similar issues and skip stylistic preferences
• Version manifest (#91) — Tracks installed version, plugins, and features in manifest.json. Enables upgrade detection during devflow init and shows install status in devflow list

Fixed

• Synthesizer review glob — Fixed ${REVIEW_BASE_DIR}/*-report.*.md glob that matched zero reviewer files; now uses ${REVIEW_BASE_DIR}/*.md with self-exclusion

v1.4.0

Added

• Smart branch naming — /implement #42 auto-derives branch names from issue labels and title (e.g., feature/42-add-jwt-auth); free-text tasks infer type from keywords (e.g., /implement fix login bug → fix/login-bug)

Fixed

• Code review file detection — Corrected file detection and skill check logic in /code-review

Changed

• Author standardization — Unified author name to Dean0x across marketplace and plugin manifests

v1.3.3

Changed

• Sudo trust prompt — Managed settings now shows a clear explanation, a copy-pasteable verification prompt, and an explicit fallback option before any password prompt

Added

• Managed settings test coverage — Unit tests for installManagedSettings two-stage write logic

v1.3.2

Changed

• Init prompt improvements — Agent Teams marked as experimental with recommendation to disable; ambient mode now defaults to enabled (recommended)
• Init flags documented — Added --ambient/--no-ambient and --memory/--no-memory to README

v1.3.1

Fixed

• Background memory updater silent Write failures — Added Read permission for memory files (Claude Code enforces Read-before-Write), read-only git commands for fresh context, mtime validation to detect silent failures, and stdout logging for debugging

v1.3.0

Added

• Skill shadowing — devflow skills shadow <name> copies a skill for personal overrides
  • devflow skills unshadow <name> restores the original
  • devflow skills list-shadowed shows active overrides
  • Shadowed skills are preserved during devflow init (not overwritten)
  • Uninstall warns about remaining shadow files
• Cross-platform hook wrapper — run-hook polyglot entry point for Windows compatibility
  • Discovers bash on Windows (Git Bash, WSL, MSYS2) via standard paths
  • All hook scripts renamed to drop .sh extension
• Ambient skill injection at session start — session-start-memory hook injects ambient-router SKILL.md directly into context
  • Eliminates the need for a Read tool call to load the ambient router
  • Only activates when ambient mode is enabled
• Skill activation integration tests — vitest.integration.config.ts + helpers for live classification tests
  • Separate npm run test:integration for tests requiring claude CLI

Changed

• Ambient depth labels renamed — STANDARD→GUIDED, ESCALATE→ELEVATE for clarity
  • GUIDED: skills guide the response; ELEVATE: elevate to a full workflow
• Hook commands use run-hook dispatch — Settings template and CLI now register hooks via run-hook <name> instead of direct .sh paths
• devflow init auto-upgrades hook format — Removes old .sh-style hooks before re-adding, ensuring existing installs migrate seamlessly
• Skill descriptions audited — All 12 review-only skills updated to trigger-format ("This skill should be used when...")
• Skills architecture docs — Added description rules section with good/bad examples
• chmod skipped on Windows — chmodRecursive no longer runs on win32 platform

Fixed

• Ambient preamble missing skill path — Hook now tells Claude to Read skills from ~/.claude/skills/<name>/SKILL.md
• Ambient --status hook path parsing — Handles run-hook <name> format instead of assuming direct .sh path

v1.2.0 - Polyglot Language Skills

DevFlow Kit v1.2.0

Polyglot language support with Go, Java, Python, and Rust skill plugins, plus optional plugin architecture for selective installation.

Highlights

• 4 new language skills — Go, Java, Python, Rust with comprehensive patterns and references
• Optional plugin architecture — Language plugins install selectively (devflow init --plugin=go)
• Dynamic skill loading — Coder agent reads language skills at runtime based on project type
• Conditional reviews — /code-review spawns language-specific reviewers when matching files are in the diff

Changes

Added

• Go skill plugin (error handling, interfaces, concurrency)
• Java skill plugin (records, sealed classes, streams, composition)
• Python skill plugin (type hints, protocols, dataclasses, async)
• Rust skill plugin (ownership, error handling, type system, concurrency)
• Optional plugin architecture (optional: true flag)
• Conditional language reviews in /code-review
• Dynamic skill loading in Coder agent

Changed

• devflow-core-skills no longer bundles typescript, react, accessibility, frontend-design (moved to optional plugins)
• Coder agent frontmatter trimmed to 6 core skills

Fixed

• Deprecated grpc.WithInsecure() in Go examples
• Deprecated datetime.utcnow in Python examples
• SQL injection in Python async streaming example
• Deprecated <Context.Provider> in React examples (React 19+)
• Deprecated useRef<T>() without argument (React 19+)
• Non-portable NodeJS.Timeout in TypeScript patterns
• Unsafe Function type in TypeScript type guard

Install / Upgrade

npx devflow-kit init
# With language plugins:
npx devflow-kit init --plugin=go --plugin=python

Links

• npm: https://www.npmjs.com/package/devflow-kit
• Changelog: https://github.com/dean0x/devflow/blob/main/CHANGELOG.md

v1.1.0 — Ambient Mode & Memory Enhancements

What's New

Added

• Ambient mode — New devflow-ambient plugin with /ambient command for proportional quality enforcement
  • Intent classification (BUILD/DEBUG/REVIEW/PLAN/EXPLORE/CHAT) auto-loads relevant skills
  • Three depth tiers: QUICK (zero overhead), STANDARD (2-3 skills), ESCALATE (nudge to workflows)
  • Always-on mode via devflow ambient --enable or devflow init --ambient
  • New ambient-router skill for intent/depth classification
  • New test-driven-development skill (auto-activates for BUILD tasks)
  • Skills: 24 → 26, Plugins: 8 → 9
• Working memory enhancements — Structured cross-session context preservation
  • Structured sections: Now, Progress, Decisions, Modified Files, Context, Session Log
  • Toggleable via devflow memory --enable/--disable/--status or devflow init --memory/--no-memory
  • PROJECT-PATTERNS.md extraction — background hook accumulates patterns across sessions
  • Directory separation: .memory/ (session state) vs .docs/ (reviews/design artifacts)
  • Auto-migration from .docs/ to .memory/ with no-clobber semantics
  • Auto-adds .memory/ and .docs/ to .gitignore on first hook run

Changed

• Background agent permissions — Replaced --dangerously-skip-permissions with --tools "Write" + --allowedTools for restricted file access in memory update hooks
• Safe-delete auto-upgrade — devflow init now detects outdated safe-delete blocks and silently upgrades them; no manual uninstall/reinstall needed

Fixed

• Ambient depth classification — Intent now drives depth exclusively; removed 20-word threshold that silently downgraded ~32% of BUILD/DEBUG prompts to QUICK (#73)
• Safe-delete file existence — Filter non-existent files before calling trash in bash/zsh, fish, and PowerShell Unix blocks; prevents noisy trash: file doesn't exist errors on rm -f of missing files (#74)
• Safe-delete deny list — Expanded rm deny patterns from 8 to 21, covering rm -r, rm -fr, and rm -f flag variations that could bypass the rm -rf-only patterns (#74)

---

Installation

# Fresh install
npx devflow-kit@1.1.0 init

# With ambient mode + working memory
npx devflow-kit@1.1.0 init --ambient --memory

# Upgrade existing installation
npx devflow-kit@1.1.0 init

Full changelog: v1.0.0...v1.1.0