feat(v2): track3 ambient refinements — skill renames, detection-only preamble

.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "devflow",
-  "description": "DevFlow - Agentic Development Toolkit for Claude Code",
+  "description": "Devflow - Agentic Development Toolkit for Claude Code",
   "owner": {
     "name": "Dean0x"
   },
@@ -80,7 +80,7 @@
     {
       "name": "devflow-core-skills",
       "source": "./plugins/devflow-core-skills",
-      "description": "Auto-activating quality enforcement skills - foundation layer for all DevFlow plugins",
+      "description": "Auto-activating quality enforcement skills - foundation layer for all Devflow plugins",
       "version": "1.8.3",
       "keywords": [
         "skills",

.claudeignore

@@ -1,5 +1,5 @@
-# DevFlow .claudeignore - Protects against sensitive files and context pollution
-# Generated by DevFlow - Edit as needed for your project
+# Devflow .claudeignore - Protects against sensitive files and context pollution
+# Generated by Devflow - Edit as needed for your project
 
 # === SECURITY: Sensitive Files ===
 # Environment and secrets

.gitignore

@@ -1,4 +1,4 @@
-# DevFlow .gitignore
+# Devflow .gitignore
 
 # Node.js
 node_modules/
@@ -60,7 +60,7 @@ commands/local-*
 
 # Installation logs
 install.log
-# DevFlow local scope installation (use --scope local)
+# Devflow local scope installation (use --scope local)
 .claude/
 .devflow/
 

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-All notable changes to DevFlow will be documented in this file.
+All notable changes to Devflow will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
@@ -29,6 +29,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.0.0] - 2026-04-05
+
+### Added
+- **EXPLORE depth classification** (GUIDED/ORCHESTRATED) with skimmer-based codebase analysis
+- **`devflow:explore`** orchestration skill for ambient EXPLORE intent
+- **TDD enforcement**: `test-driven-development` skill auto-loads for IMPLEMENT, PLAN, and CODER intents
+- **Stale skill name detector** in tests covers all renamed/deleted skills
+
+### Changed
+- **Orchestration skills**: 7 skills renamed with `:orch` suffix — `implement:orch`, `explore:orch`, `debug:orch`, `plan:orch`, `review:orch`, `resolve:orch`, `pipeline:orch`
+- **`self-review` skill** renamed to `quality-gates`
+- **`ambient-router` skill** renamed to `router`
+- **Preamble**: simplified to detection-only; skill mappings moved to router skill
+- **Output branding**: standardized to `DevFlow: INTENT/DEPTH` across all ambient outputs
+- **Integration test `hasRequiredSkills()`**: uses bounded matching instead of substring
+
+### Removed
+- **`implementation-patterns` skill** (merged into `patterns`)
+- **`search-first` skill** (merged into `research`)
+- **Dead `isFirstToolASkill()` function** from integration test helpers
+
+---
+
 ## [1.8.3] - 2026-03-22
 
 ### Fixed
@@ -612,11 +635,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Interactive prompt with clear descriptions when `--scope` flag not provided
   - CLI flag: `devflow init --scope <user|local>`
   - Automatic .gitignore updates for local scope (excludes `.claude/` and `.devflow/`)
-  - Perfect for team projects where DevFlow should be project-specific
+  - Perfect for team projects where Devflow should be project-specific
 
 #### Smart Uninstall with Scope Detection
-- **Auto-detection of installed scopes** - Intelligently finds and removes DevFlow installations
-  - Automatically detects which scopes have DevFlow installed (user and/or local)
+- **Auto-detection of installed scopes** - Intelligently finds and removes Devflow installations
+  - Automatically detects which scopes have Devflow installed (user and/or local)
   - Default behavior: Remove from all detected scopes
   - Manual override: `--scope <user|local>` to target specific scope
   - Clear feedback showing which scopes are being uninstalled
@@ -685,7 +708,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Commands: `/research`, `/debug` for explicit user requests
   - Skills: Auto-activated versions when conversation context matches
   - Clear separation of concerns and activation modes
-  - Documented pattern for extending DevFlow functionality
+  - Documented pattern for extending Devflow functionality
 
 #### Enhanced /devlog Command
 - **Orchestrator pattern** - Refactored to use project-state agent
@@ -961,7 +984,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### 🎉 Initial Release
 
-DevFlow is an Agentic Development Toolkit designed to enhance Claude Code with intelligent commands and workflows for AI-assisted development.
+Devflow is an Agentic Development Toolkit designed to enhance Claude Code with intelligent commands and workflows for AI-assisted development.
 
 ### Added
 

CLAUDE.md

@@ -1,10 +1,10 @@
-# DevFlow Development Guide
+# Devflow Development Guide
 
-Instructions for developers and AI agents working on DevFlow. For user docs, see README.md.
+Instructions for developers and AI agents working on Devflow. For user docs, see README.md.
 
 ## Purpose
 
-DevFlow enhances Claude Code with intelligent development workflows. Modifications must:
+Devflow enhances Claude Code with intelligent development workflows. Modifications must:
 - Maintain brutal honesty in review outputs (no sycophancy)
 - Preserve context across sessions
 - Enhance developer empowerment without replacing judgment
@@ -50,12 +50,12 @@ Commands with Teams Variant ship as `{name}.md` (parallel subagents) and `{name}
 
 ```
 devflow/
-├── shared/skills/          # 38 skills (single source of truth)
+├── shared/skills/          # 39 skills (single source of truth)
 ├── shared/agents/          # 11 shared agents (single source of truth)
 ├── plugins/devflow-*/      # 17 plugins (8 core + 9 optional language/ecosystem)
 ├── docs/reference/         # Detailed reference documentation
 ├── scripts/                # Helper scripts (statusline, docs-helpers)
-│   └── hooks/              # Working Memory + ambient + learning hooks (stop, session-start, pre-compact, ambient-prompt, session-end-learning, stop-update-learning [deprecated], background-learning)
+│   └── hooks/              # Working Memory + ambient + learning hooks (stop, session-start, pre-compact, preamble, session-end-learning, stop-update-learning [deprecated], background-learning)
 ├── src/cli/                # TypeScript CLI (init, list, uninstall, ambient, learn, flags)
 ├── .claude-plugin/         # Marketplace registry
 ├── .docs/                  # Project docs (reviews, design) — per-project
@@ -126,7 +126,7 @@ Working memory files live in a dedicated `.memory/` directory:
 
 **Incremental Reviews**: `/code-review` writes reports into timestamped subdirectories (`YYYY-MM-DD_HHMM`) and tracks HEAD SHA in `.last-review-head` for incremental diffs. Second review only diffs from last reviewed commit. `/resolve` defaults to latest timestamped directory. Both commands auto-discover git worktrees and process all reviewable branches in parallel.
 
-**Coder Handoff Artifact**: Sequential Coder phases write `.docs/handoff.md` after each phase. Survives context compaction (unlike PRIOR_PHASE_SUMMARY). Every Coder reads it on startup. Deleted by implementation-orchestration after pipeline completes.
+**Coder Handoff Artifact**: Sequential Coder phases write `.docs/handoff.md` after each phase. Survives context compaction (unlike PRIOR_PHASE_SUMMARY). Every Coder reads it on startup. Deleted by implement:orch orchestration skill after pipeline completes.
 
 **Universal Skill Installation**: All skills from all plugins are always installed, regardless of plugin selection. Skills are tiny markdown files installed as `~/.claude/skills/devflow:{name}/` (namespaced to avoid collisions with other plugin ecosystems). Source directories in `shared/skills/` stay unprefixed — the `devflow:` prefix is applied at install-time only. Shadow overrides live at `~/.devflow/skills/{name}/` (unprefixed); when shadowed, the installer copies the user's version to the prefixed install target. Only commands and agents remain plugin-specific.
 
@@ -147,7 +147,7 @@ Working memory files live in a dedicated `.memory/` directory:
 
 **Plugin-specific agents** (1): claude-md-auditor
 
-**Ambient orchestration skills** (6): implementation-orchestration, debug-orchestration, plan-orchestration, review-orchestration, resolve-orchestration, pipeline-orchestration. These enable the same agent pipelines as slash commands but triggered via ambient intent classification.
+**Orchestration skills** (7): implement:orch, explore:orch, debug:orch, plan:orch, review:orch, resolve:orch, pipeline:orch. These enable the same agent pipelines as slash commands but triggered via ambient intent classification.
 
 **Agent Teams**: 5 commands use Agent Teams (`/code-review`, `/implement`, `/debug`, `/specify`, `/resolve`). One-team-per-session constraint — must TeamDelete before creating next team.
 
@@ -158,7 +158,7 @@ Working memory files live in a dedicated `.memory/` directory:
 - 3-tier system: Foundation (shared patterns), Specialized (auto-activate), Domain (language/framework)
 - Each skill has one non-negotiable **Iron Law** in its `SKILL.md`
 - Target: ~120-150 lines per SKILL.md with progressive disclosure to `references/`
-- Skills default to read-only (`allowed-tools: Read, Grep, Glob`); exceptions: git/review skills add `Bash`, interactive skills add `AskUserQuestion`, `knowledge-persistence`/`self-review` add `Write` for state persistence, and `ambient-router` omits `allowed-tools` entirely (unrestricted, as the main-session orchestrator)
+- Skills default to read-only (`allowed-tools: Read, Grep, Glob`); exceptions: git/review skills add `Bash`, interactive skills add `AskUserQuestion`, `knowledge-persistence`/`quality-gates` add `Write` for state persistence, and `router` omits `allowed-tools` entirely (unrestricted, as the main-session orchestrator)
 - All skills live in `shared/skills/` — add to plugin `plugin.json` `skills` array, then `npm run build`
 
 ### Agents

CONTRIBUTING.md

@@ -1,6 +1,6 @@
-# Contributing to DevFlow
+# Contributing to Devflow
 
-Thanks for your interest in contributing to DevFlow! This guide covers everything you need to get started.
+Thanks for your interest in contributing to Devflow! This guide covers everything you need to get started.
 
 ## Prerequisites
 
@@ -18,14 +18,14 @@ npm run build
 node dist/cli.js init
 ```
 
-After setup, DevFlow commands (`/code-review`, `/implement`, etc.) are available in Claude Code.
+After setup, Devflow commands (`/code-review`, `/implement`, etc.) are available in Claude Code.
 
 ## Project Structure
 
 ```
 devflow/
-├── shared/skills/       # 37 skills (single source of truth)
-├── shared/agents/       # 10 shared agents (single source of truth)
+├── shared/skills/       # 39 skills (single source of truth)
+├── shared/agents/       # 11 shared agents (single source of truth)
 ├── plugins/devflow-*/   # 17 plugins (8 core + 9 optional)
 ├── scripts/hooks/       # Working Memory hooks
 ├── src/cli/             # TypeScript CLI (init, list, uninstall)

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025-2026 DevFlow Contributors
+Copyright (c) 2025-2026 Devflow Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,4 +1,4 @@
-# DevFlow
+# Devflow
 
 [![npm version](https://img.shields.io/npm/v/devflow-kit)](https://www.npmjs.com/package/devflow-kit)
 [![CI](https://github.com/dean0x/devflow/actions/workflows/ci.yml/badge.svg)](https://github.com/dean0x/devflow/actions/workflows/ci.yml)
@@ -7,14 +7,14 @@
 [![Website](https://img.shields.io/badge/Website-dean0x.github.io%2Fx%2Fdevflow-blue)](https://dean0x.github.io/x/devflow/)
 
 <p align="center">
-  <img src=".github/assets/devflow-init.gif" alt="DevFlow init demo" width="720" />
+  <img src=".github/assets/devflow-init.gif" alt="Devflow init demo" width="720" />
 </p>
 
 ## The problem with AI-assisted development
 
 Claude Code is powerful. But every session starts from scratch. Context evaporates between conversations. Code reviews are single-pass and shallow. Quality depends entirely on what you remember to ask for.
 
-DevFlow fixes this. Install once, forget about it. Your code gets better automatically.
+Devflow fixes this. Install once, forget about it. Your code gets better automatically.
 
 It watches every prompt, classifies intent, and orchestrates the right workflow — plan, implement, review, debug — loading the relevant skills. Simple questions get zero overhead. Complex tasks get an advanced TDD and EDD harness with quality gates at every step.
 
@@ -23,7 +23,7 @@ It watches every prompt, classifies intent, and orchestrates the right workflow
 ```
 you: add rate limiting to the /api/upload endpoint
 
-DevFlow: Ambient: IMPLEMENT/ORCHESTRATED
+Devflow: IMPLEMENT/ORCHESTRATED
          → Created branch feat/42-rate-limit-upload
          → Exploring codebase... Planning... Coding...
          → Validator: build ✓ typecheck ✓ lint ✓ tests ✓
@@ -40,15 +40,15 @@ DevFlow: Ambient: IMPLEMENT/ORCHESTRATED
 
 ## What you get
 
-**Ambient intelligence.** DevFlow classifies every prompt into three tiers — QUICK (zero overhead), GUIDED (skill loading + main session), ORCHESTRATED (full agent pipelines). You never invoke it manually. Init and forget.
+**Ambient intelligence.** Devflow classifies every prompt into three tiers — QUICK (zero overhead), GUIDED (skill loading + main session), ORCHESTRATED (full agent pipelines). You never invoke it manually. Init and forget.
 
 **Memory that persists.** Session context survives restarts, `/clear`, and context compaction. Your AI picks up exactly where it left off. Architectural decisions and known pitfalls accumulate in `.memory/knowledge/` and inform every future session. No manual bookkeeping.
 
 **It learns how you work.** A self-learning mechanism detects repeated workflows and procedural patterns across sessions, then creates reusable slash commands and skills automatically.
 
 **18 parallel code reviewers.** Security, architecture, performance, complexity, consistency, regression, testing, and more. Each produces findings with severity, confidence scoring, and concrete fixes. Conditional reviewers activate when relevant (TypeScript for `.ts` files, database for schema changes). Every finding gets validated and resolved automatically.
 
-**38 skills grounded in expert material.** Every skill is backed by peer-reviewed papers, canonical books, and industry standards — security (OWASP, Shostack), architecture (Parnas, Evans, Fowler), performance (Brendan Gregg), testing (Beck, Meszaros), design (Wlaschin, Hickey). 200+ sources total.
+**39 skills grounded in expert material.** Every skill is backed by peer-reviewed papers, canonical books, and industry standards — security (OWASP, Shostack), architecture (Parnas, Evans, Fowler), performance (Brendan Gregg), testing (Beck, Meszaros), design (Wlaschin, Hickey). 200+ sources total.
 
 **Skill shadowing.** Override any built-in skill with your own version. Drop a file into `~/.devflow/skills/{name}/` and the installer uses yours instead of the default — same activation, your rules.
 
@@ -61,7 +61,7 @@ DevFlow: Ambient: IMPLEMENT/ORCHESTRATED
 ```
 devflow · feat/auth-middleware* · 3↑ · v1.8.3 +5 · 12 files · +234 -56
 Current Session ████░░░░ 42% · Session 5h ██░░░░░░ 18% · 7d █░░░░░░░ 8%
-Opus 4.6 [1m] · 23m · $1.24 · 2 CLAUDE.md · 4 MCPs · 8 hooks · 38 skills
+Opus 4.6 [1m] · 23m · $1.24 · 2 CLAUDE.md · 4 MCPs · 8 hooks · 39 skills
 ```
 
 **Security.** Deny lists block dangerous tool patterns out of the box — configurable during init.
@@ -97,7 +97,7 @@ npx devflow-kit init --plugin=typescript,react
 
 ## How it works
 
-DevFlow is a plugin system for Claude Code. Each plugin installs commands, agents, and skills into your Claude Code environment. Skills are tiny markdown files that activate automatically based on context. Agents are specialized workers (reviewer, coder, resolver, etc.) with explicit model assignments — Opus for analysis, Sonnet for execution, Haiku for I/O. Commands orchestrate agent pipelines.
+Devflow is a plugin system for Claude Code. Each plugin installs commands, agents, and skills into your Claude Code environment. Skills are tiny markdown files that activate automatically based on context. Agents are specialized workers (reviewer, coder, resolver, etc.) with explicit model assignments — Opus for analysis, Sonnet for execution, Haiku for I/O. Commands orchestrate agent pipelines.
 
 For deep dives: [Working Memory](docs/working-memory.md) | [Self-Learning](docs/self-learning.md) | [CLI Reference](docs/cli-reference.md) | [Commands](docs/commands.md)
 
@@ -109,7 +109,7 @@ npx devflow-kit init --plugin=implement # Install specific plugin
 npx devflow-kit list                    # List available plugins
 npx devflow-kit ambient --enable        # Toggle ambient mode
 npx devflow-kit learn --enable          # Toggle self-learning
-npx devflow-kit uninstall               # Remove DevFlow
+npx devflow-kit uninstall               # Remove Devflow
 ```
 
 See [docs/cli-reference.md](docs/cli-reference.md) for all options.
@@ -119,7 +119,7 @@ See [docs/cli-reference.md](docs/cli-reference.md) for all options.
 | Tool | Role | What It Does |
 |------|------|-------------|
 | **[Skim](https://github.com/dean0x/skim)** | Context Optimization | Code-aware AST parsing, command rewriting, output compression |
-| **DevFlow** | Quality Orchestration | Parallel reviewers, working memory, self-learning, composable plugins |
+| **Devflow** | Quality Orchestration | Parallel reviewers, working memory, self-learning, composable plugins |
 | **[Backbeat](https://github.com/dean0x/backbeat)** | Agent Orchestration | Karpathy optimization loops, multi-agent pipelines, DAG dependencies |
 
 ## Building from Source

docs/cli-reference.md

@@ -92,7 +92,7 @@ npx devflow-kit hud --no-detail      # Hide tool/agent descriptions
 
 ## Skill Shadowing
 
-Override any DevFlow skill with your own version. Shadowed skills survive `devflow init` — your version is installed instead of DevFlow's.
+Override any Devflow skill with your own version. Shadowed skills survive `devflow init` — your version is installed instead of Devflow's.
 
 ```bash
 npx devflow-kit skills shadow software-design    # Create override (copies current as reference)

docs/commands.md

@@ -1,6 +1,6 @@
 # Commands
 
-DevFlow provides six commands that orchestrate specialized agents. Commands spawn agents — they never do the work themselves.
+Devflow provides six commands that orchestrate specialized agents. Commands spawn agents — they never do the work themselves.
 
 ## /specify