devflow-kit 1.6.0 → 1.6.1

package/CHANGELOG.md

@@ -5,6 +5,19 @@ 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).
 
+## [1.6.1] - 2026-03-20
+
+### 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
+
+---
+
 ## [1.6.0] - 2026-03-19
 
 ### Added
@@ -902,6 +915,7 @@ devflow init
 ---
 
 [Unreleased]: https://github.com/dean0x/devflow/compare/v1.4.0...HEAD
+[1.6.1]: https://github.com/dean0x/devflow/compare/v1.6.0...v1.6.1
 [1.6.0]: https://github.com/dean0x/devflow/compare/v1.5.0...v1.6.0
 [1.5.0]: https://github.com/dean0x/devflow/compare/v1.4.0...v1.5.0
 [1.4.0]: https://github.com/dean0x/devflow/compare/v1.3.3...v1.4.0

package/README.md

@@ -197,7 +197,6 @@ DevFlow creates project documentation in `.docs/` and working memory in `.memory
 
 .memory/
 ├── WORKING-MEMORY.md         # Auto-maintained by Stop hook
-├── PROJECT-PATTERNS.md       # Accumulated patterns across sessions
 ├── backup.json               # Pre-compact git state snapshot
 └── knowledge/
     ├── decisions.md           # Architectural decisions (ADR-NNN, append-only)
@@ -255,7 +254,10 @@ Session context is saved and restored automatically via Working Memory hooks —
 | Option | Description |
 |--------|-------------|
 | `--scope <user\|local>` | Uninstall scope (default: user) |
+| `--plugin <names>` | Comma-separated plugin names to uninstall selectively |
 | `--keep-docs` | Preserve .docs/ directory |
+| `--dry-run` | Show what would be removed without deleting anything |
+| `--verbose` | Show detailed uninstall output |
 
 ## Building from Source
 

package/dist/commands/init.js

@@ -121,14 +121,14 @@ export const initCommand = new Command('init')
     }
     else if (process.stdin.isTTY) {
         const choices = DEVFLOW_PLUGINS
-            .filter(pl => pl.name !== 'devflow-core-skills')
+            .filter(pl => pl.name !== 'devflow-core-skills' && pl.name !== 'devflow-ambient')
             .map(pl => ({
             value: pl.name,
             label: pl.name.replace('devflow-', ''),
             hint: pl.description + (pl.optional ? ' (optional)' : ''),
         }));
         const preSelected = DEVFLOW_PLUGINS
-            .filter(pl => !pl.optional && pl.name !== 'devflow-core-skills')
+            .filter(pl => !pl.optional && pl.name !== 'devflow-core-skills' && pl.name !== 'devflow-ambient')
             .map(pl => pl.name);
         const pluginSelection = await p.multiselect({
             message: 'Select plugins to install',
@@ -284,6 +284,10 @@ export const initCommand = new Command('init')
     if (pluginsToInstall.length > 0 && coreSkillsPlugin && !pluginsToInstall.includes(coreSkillsPlugin)) {
         pluginsToInstall = [coreSkillsPlugin, ...pluginsToInstall];
     }
+    const ambientPlugin = DEVFLOW_PLUGINS.find(p => p.name === 'devflow-ambient');
+    if (ambientEnabled && ambientPlugin && !pluginsToInstall.includes(ambientPlugin)) {
+        pluginsToInstall.push(ambientPlugin);
+    }
     const { skillsMap, agentsMap } = buildAssetMaps(pluginsToInstall);
     // Install: try native CLI first, fall back to file copy
     const cliAvailable = isClaudeCliAvailable();

package/dist/commands/uninstall.d.ts

@@ -9,5 +9,14 @@ export declare function computeAssetsToRemove(selectedPlugins: PluginDefinition[
     agents: string[];
     commands: string[];
 };
+/**
+ * Format a dry-run plan showing what would be removed.
+ * Pure function — no I/O, fully testable.
+ */
+export declare function formatDryRunPlan(assets: {
+    skills: string[];
+    agents: string[];
+    commands: string[];
+}, extras?: string[]): string;
 export declare const uninstallCommand: Command;
 //# sourceMappingURL=uninstall.d.ts.map

package/dist/commands/uninstall.js

@@ -2,7 +2,7 @@ import { Command } from 'commander';
 import { promises as fs } from 'fs';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
+import { execFileSync } from 'child_process';
 import * as p from '@clack/prompts';
 import color from 'picocolors';
 import { getInstallationPaths, getClaudeDirectory, getDevFlowDirectory, getManagedSettingsPath } from '../utils/paths.js';
@@ -46,13 +46,37 @@ export function computeAssetsToRemove(selectedPlugins, allPlugins) {
     }
     return { skills, agents, commands };
 }
+/**
+ * Format a dry-run plan showing what would be removed.
+ * Pure function — no I/O, fully testable.
+ */
+export function formatDryRunPlan(assets, extras) {
+    const skills = [...new Set(assets.skills)];
+    const agents = [...new Set(assets.agents)];
+    const commands = [...new Set(assets.commands)];
+    const hasAssets = skills.length > 0 || agents.length > 0 || commands.length > 0;
+    const hasExtras = extras && extras.length > 0;
+    if (!hasAssets && !hasExtras) {
+        return 'Nothing to remove.';
+    }
+    const lines = [];
+    if (skills.length > 0)
+        lines.push(`Skills (${skills.length}): ${skills.join(', ')}`);
+    if (agents.length > 0)
+        lines.push(`Agents (${agents.length}): ${agents.join(', ')}`);
+    if (commands.length > 0)
+        lines.push(`Commands (${commands.length}): ${commands.join(', ')}`);
+    if (hasExtras)
+        lines.push(`Extras: ${extras.join(', ')}`);
+    return lines.join('\n');
+}
 /**
  * Uninstall plugin using Claude CLI
  */
 function uninstallPluginViaCli(scope) {
     try {
         const cliScope = scope === 'local' ? 'project' : 'user';
-        execSync(`claude plugin uninstall devflow --scope ${cliScope}`, { stdio: 'inherit' });
+        execFileSync('claude', ['plugin', 'uninstall', 'devflow', '--scope', cliScope], { stdio: 'inherit' });
         return true;
     }
     catch {
@@ -77,8 +101,10 @@ export const uninstallCommand = new Command('uninstall')
     .option('--scope <type>', 'Uninstall from specific scope only (default: auto-detect all)', /^(user|local)$/i)
     .option('--plugin <names>', 'Uninstall specific plugin(s), comma-separated (e.g., implement,review)')
     .option('--verbose', 'Show detailed uninstall output')
+    .option('--dry-run', 'Show what would be removed without actually removing anything')
     .action(async (options) => {
-    p.intro(color.bgRed(color.white(' Uninstalling DevFlow ')));
+    const dryRun = options.dryRun ?? false;
+    p.intro(color.bgRed(color.white(dryRun ? ' DevFlow Uninstall (dry run) ' : ' Uninstalling DevFlow ')));
     const verbose = options.verbose ?? false;
     // Parse plugin selection
     let selectedPluginNames = [];
@@ -121,7 +147,7 @@ export const uninstallCommand = new Command('uninstall')
             p.log.info('Checked user scope (~/.claude/) and local scope (git-root/.claude/)');
             process.exit(1);
         }
-        if (scopesToUninstall.length > 1) {
+        if (scopesToUninstall.length > 1 && !dryRun) {
             if (process.stdin.isTTY) {
                 const scopeChoice = await p.select({
                     message: 'Found DevFlow in multiple scopes. Uninstall from:',
@@ -144,6 +170,36 @@ export const uninstallCommand = new Command('uninstall')
             }
         }
     }
+    // === DRY RUN: show plan and exit ===
+    if (dryRun) {
+        p.log.info(`Scope(s): ${scopesToUninstall.join(', ')} (dry-run shows all detected scopes)`);
+        const assets = isSelectiveUninstall
+            ? computeAssetsToRemove(selectedPlugins, DEVFLOW_PLUGINS)
+            : computeAssetsToRemove(DEVFLOW_PLUGINS, DEVFLOW_PLUGINS);
+        // Detect extras that would be cleaned up (full uninstall only)
+        const extras = [];
+        if (!isSelectiveUninstall) {
+            const docsDir = path.join(process.cwd(), '.docs');
+            const memoryDir = path.join(process.cwd(), '.memory');
+            try {
+                await fs.access(docsDir);
+                extras.push('.docs/');
+            }
+            catch { /* noop */ }
+            try {
+                await fs.access(memoryDir);
+                extras.push('.memory/');
+            }
+            catch { /* noop */ }
+            extras.push('hooks in settings.json', 'scripts in ~/.devflow/');
+        }
+        const plan = formatDryRunPlan(assets, extras.length > 0 ? extras : undefined);
+        for (const line of plan.split('\n')) {
+            p.log.info(line);
+        }
+        p.outro(color.dim('No changes made (dry run)'));
+        return;
+    }
     const cliAvailable = isClaudeCliAvailable();
     // Uninstall from each scope
     for (const scope of scopesToUninstall) {

package/dist/utils/post-install.js

@@ -448,7 +448,6 @@ export async function migrateMemoryFiles(verbose, cwd) {
     const memoryDir = path.join(root, '.memory');
     const migrations = [
         { src: path.join(docsDir, 'WORKING-MEMORY.md'), dest: path.join(memoryDir, 'WORKING-MEMORY.md') },
-        { src: path.join(docsDir, 'patterns.md'), dest: path.join(memoryDir, 'PROJECT-PATTERNS.md') },
         { src: path.join(docsDir, 'working-memory-backup.json'), dest: path.join(memoryDir, 'backup.json') },
     ];
     let migrated = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devflow-kit",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Agentic Development Toolkit for Claude Code - Enhance AI-assisted development with intelligent commands and workflows",
   "type": "module",
   "bin": {

package/plugins/devflow-accessibility/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-ambient/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-ambient/skills/ambient-router/SKILL.md

@@ -2,7 +2,7 @@
 name: ambient-router
 description: This skill should be used when classifying user intent for ambient mode, auto-loading relevant skills without explicit command invocation. Used by the always-on UserPromptSubmit hook.
 user-invocable: false
-allowed-tools: Read, Grep, Glob
+# No allowed-tools: orchestrator requires unrestricted access (Skill, Agent, Edit, Write, Bash)
 ---
 
 # Ambient Router
@@ -89,6 +89,9 @@ When classification is GUIDED or ORCHESTRATED, skill loading is NON-NEGOTIABLE.
 Do not rationalize skipping skills. Do not respond without loading them first.
 BLOCKING REQUIREMENT: Invoke each selected skill using the Skill tool before proceeding.
 For IMPLEMENT intent, enforce TDD: write the failing test before ANY production code.
+NOTE: Skills loaded in the main session via ambient mode are reference patterns only —
+their allowed-tools metadata does NOT restrict your tool access. You retain full access
+to all tools (Edit, Write, Bash, Agent, etc.) for implementation work.
 </IMPORTANT>
 
 - **QUICK:** Respond directly. No preamble, no classification statement.

package/plugins/devflow-audit-claude/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-code-review/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-core-skills/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-core-skills/skills/docs-framework/SKILL.md

@@ -38,7 +38,6 @@ All generated documentation lives under `.docs/` in the project root:
 
 .memory/
 ├── WORKING-MEMORY.md                   # Auto-maintained by Stop hook (overwritten)
-├── PROJECT-PATTERNS.md                 # Accumulated patterns (merged across sessions)
 ├── backup.json                         # Pre-compact git state snapshot
 └── knowledge/
     ├── decisions.md                    # Architectural decisions (ADR-NNN format)

package/plugins/devflow-debug/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-frontend-design/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-go/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-implement/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-java/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-python/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-react/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-resolve/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-rust/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-self-review/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-specify/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/plugins/devflow-typescript/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.6.0",
+  "version": "1.6.1",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",

package/scripts/hooks/ambient-prompt

@@ -25,21 +25,22 @@ if [[ "$PROMPT" == /* ]]; then
 fi
 
 # Skip single-word confirmations (< 2 words)
-WORD_COUNT=$(echo "$PROMPT" | wc -w | tr -d ' ')
+WORD_COUNT=$(printf '%s' "$PROMPT" | wc -w | tr -d ' ')
 if [ "$WORD_COUNT" -lt 2 ]; then
   exit 0
 fi
 
 # Normalize to lowercase for matching
-PROMPT_LOWER=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]')
+PROMPT_LOWER=$(printf '%s' "$PROMPT" | tr '[:upper:]' '[:lower:]')
 
 # Fast-path: git operations are always QUICK — skip preamble
-if echo "$PROMPT_LOWER" | grep -qE '^(commit|push|pull|merge|rebase|cherry-pick|squash|tag|stash)|create (a )?pr|open (a )?pr'; then
+if printf '%s' "$PROMPT_LOWER" | grep -qE '^(commit|push|pull|merge|rebase|cherry-pick|squash|tag|stash)|create (a )?pr|open (a )?pr'; then
   exit 0
 fi
 
 # Inject classification preamble
-PREAMBLE="AMBIENT MODE ACTIVE: Before responding, silently classify this prompt using the ambient-router skill already in your session context. If QUICK, respond normally without stating classification."
+# SYNC: must match tests/integration/helpers.ts AMBIENT_PREAMBLE
+PREAMBLE="AMBIENT MODE ACTIVE: Before responding, silently classify this prompt using the ambient-router skill already in your session context. If QUICK, respond normally without stating classification. If GUIDED or ORCHESTRATED, you MUST load the selected skills using the Skill tool before proceeding."
 
 jq -n --arg ctx "$PREAMBLE" '{
   "hookSpecificOutput": {

package/scripts/hooks/background-memory-update

@@ -2,8 +2,9 @@
 
 # Background Working Memory Updater
 # Called by stop-update-memory as a detached background process.
-# Resumes the parent session headlessly to update .memory/WORKING-MEMORY.md.
-# On failure: logs error, does nothing (no fallback).
+# Reads the last turn from the session transcript, then uses a fresh `claude -p`
+# invocation to update .memory/WORKING-MEMORY.md.
+# On failure: logs error, does nothing (stale memory is better than fake data).
 
 set -e
 
@@ -29,7 +30,7 @@ rotate_log() {
 
 # --- Stale Lock Recovery ---
 
-# Portable mtime in epoch seconds (same pattern as stop-update-memory:35-39)
+# Portable mtime in epoch seconds
 get_mtime() {
   if stat --version &>/dev/null 2>&1; then
     stat -c %Y "$1"
@@ -72,11 +73,65 @@ cleanup() {
 }
 trap cleanup EXIT
 
+# --- Transcript Extraction ---
+
+extract_last_turn() {
+  # Compute transcript path: Claude Code stores transcripts at
+  # ~/.claude/projects/{cwd-with-slashes-replaced-by-hyphens}/{session_id}.jsonl
+  local encoded_cwd
+  encoded_cwd=$(echo "$CWD" | sed 's|^/||' | tr '/' '-')
+  local transcript="$HOME/.claude/projects/-${encoded_cwd}/${SESSION_ID}.jsonl"
+
+  if [ ! -f "$transcript" ]; then
+    log "Transcript not found at $transcript"
+    return 1
+  fi
+
+  # Extract last user and assistant text from JSONL
+  # Each line is a JSON object with "type" field
+  local last_user last_assistant
+
+  last_user=$(grep '"type":"user"' "$transcript" 2>/dev/null \
+    | tail -3 \
+    | jq -r '
+      if .message.content then
+        [.message.content[] | select(.type == "text") | .text] | join("\n")
+      else ""
+      end
+    ' 2>/dev/null \
+    | tail -1)
+
+  last_assistant=$(grep '"type":"assistant"' "$transcript" 2>/dev/null \
+    | tail -3 \
+    | jq -r '
+      if .message.content then
+        [.message.content[] | select(.type == "text") | .text] | join("\n")
+      else ""
+      end
+    ' 2>/dev/null \
+    | tail -1)
+
+  # Truncate to ~4000 chars total to keep token cost low
+  if [ ${#last_user} -gt 2000 ]; then
+    last_user="${last_user:0:2000}... [truncated]"
+  fi
+  if [ ${#last_assistant} -gt 2000 ]; then
+    last_assistant="${last_assistant:0:2000}... [truncated]"
+  fi
+
+  if [ -z "$last_user" ] && [ -z "$last_assistant" ]; then
+    log "No text content found in transcript"
+    return 1
+  fi
+
+  LAST_USER_TEXT="$last_user"
+  LAST_ASSISTANT_TEXT="$last_assistant"
+  return 0
+}
+
 # --- Main ---
 
-# Wait for parent session to flush transcript.
-# 3s provides ~6-10x margin over typical flush times.
-# If --resume shows stale transcripts, bump to 5s.
+# Wait for parent session to flush transcript
 sleep 3
 
 log "Starting update for session $SESSION_ID"
@@ -87,7 +142,6 @@ break_stale_lock
 # Acquire lock (other sessions may be updating concurrently)
 if ! acquire_lock; then
   log "Lock timeout after 90s — skipping update for session $SESSION_ID"
-  # Don't clean up lock we don't own
   trap - EXIT
   exit 0
 fi
@@ -102,97 +156,72 @@ if [ -f "$MEMORY_FILE" ]; then
   PRE_UPDATE_MTIME=$(get_mtime "$MEMORY_FILE")
 fi
 
-# Build instruction
-if [ -n "$EXISTING_MEMORY" ]; then
-  PATTERNS_INSTRUCTION=""
-PATTERNS_FILE="$CWD/.memory/PROJECT-PATTERNS.md"
-EXISTING_PATTERNS=""
-if [ -f "$PATTERNS_FILE" ]; then
-  EXISTING_PATTERNS=$(cat "$PATTERNS_FILE")
-  PATTERNS_INSTRUCTION="
-
-Also update $PATTERNS_FILE by APPENDING any new recurring patterns discovered during this session. Do NOT overwrite existing entries — only add new ones. Skip if no new patterns were observed. Format each entry as: - **Pattern name**: Brief description (discovered: YYYY-MM-DD). Keep patterns.md under 40 entries. When approaching the limit, consolidate related patterns into broader entries rather than adding duplicates.
-
-Existing patterns:
-$EXISTING_PATTERNS"
-else
-  PATTERNS_INSTRUCTION="
-
-If recurring patterns were observed during this session (coding conventions, architectural decisions, team preferences, tooling quirks), create $PATTERNS_FILE with entries formatted as: - **Pattern name**: Brief description (discovered: YYYY-MM-DD). Only create this file if genuine patterns were observed — do not fabricate entries."
+# Gather git state (always available, used as fallback too)
+GIT_STATE=""
+if cd "$CWD" 2>/dev/null && git rev-parse --git-dir >/dev/null 2>&1; then
+  GIT_STATUS=$(git status --short 2>/dev/null | head -20)
+  GIT_LOG=$(git log --oneline -5 2>/dev/null)
+  GIT_DIFF=$(git diff --stat HEAD 2>/dev/null | tail -10)
+  GIT_STATE="Branch: $(git branch --show-current 2>/dev/null || echo 'unknown')
+Recent commits:
+${GIT_LOG}
+Changed files:
+${GIT_STATUS}
+Diff summary:
+${GIT_DIFF}"
 fi
 
-INSTRUCTION="First, Read the file $MEMORY_FILE to satisfy Claude Code's read-before-write requirement. Then update it with working memory from this session. The file already has content — possibly from a concurrent session that just wrote it moments ago. Merge this session's context with the existing content to produce a single unified working memory snapshot. Both this session and the existing content represent fresh, concurrent work — integrate both fully. Working memory captures what's active now, not a changelog. Deduplicate overlapping information. Keep under 120 lines total. Use the same structure: ## Now, ## Progress, ## Decisions, ## Modified Files, ## Context, ## Session Log.
-
-## Progress tracks Done (completed items), Remaining (next steps), and Blockers (if any). Keep each sub-list to 1-3 items. This section reflects current work state, not historical logs.
-
-## Decisions entries must include date and status. Format: - **[Decision]** — [rationale] (YYYY-MM-DD) [ACTIVE|SUPERSEDED]. Mark superseded decisions rather than deleting them.${PATTERNS_INSTRUCTION}
-
-Existing content:
-$EXISTING_MEMORY"
+# Extract last turn from transcript (or fall back to git-only)
+LAST_USER_TEXT=""
+LAST_ASSISTANT_TEXT=""
+EXCHANGE_SECTION=""
+
+if extract_last_turn; then
+  log "--- Extracted user text (${#LAST_USER_TEXT} chars) ---"
+  log "$LAST_USER_TEXT"
+  log "--- Extracted assistant text (${#LAST_ASSISTANT_TEXT} chars) ---"
+  log "$LAST_ASSISTANT_TEXT"
+  log "--- End transcript extraction ---"
+  EXCHANGE_SECTION="Last exchange:
+User: ${LAST_USER_TEXT}
+Assistant: ${LAST_ASSISTANT_TEXT}"
 else
-  PATTERNS_INSTRUCTION=""
-  PATTERNS_FILE="$CWD/.memory/PROJECT-PATTERNS.md"
-  if [ -f "$PATTERNS_FILE" ]; then
-    EXISTING_PATTERNS=$(cat "$PATTERNS_FILE")
-    PATTERNS_INSTRUCTION="
-
-Also update $PATTERNS_FILE by APPENDING any new recurring patterns discovered during this session. Do NOT overwrite existing entries — only add new ones. Skip if no new patterns were observed. Format each entry as: - **Pattern name**: Brief description (discovered: YYYY-MM-DD). Keep patterns.md under 40 entries. When approaching the limit, consolidate related patterns into broader entries rather than adding duplicates.
-
-Existing patterns:
-$EXISTING_PATTERNS"
-  else
-    PATTERNS_INSTRUCTION="
-
-If recurring patterns were observed during this session (coding conventions, architectural decisions, team preferences, tooling quirks), create $PATTERNS_FILE with entries formatted as: - **Pattern name**: Brief description (discovered: YYYY-MM-DD). Only create this file if genuine patterns were observed — do not fabricate entries."
-  fi
-
-  INSTRUCTION="First, Read the file $MEMORY_FILE if it exists (to satisfy Claude Code's read-before-write requirement). Then create it with working memory from this session. Keep under 120 lines. Use this structure:
-
-# Working Memory
-
-## Now
-<!-- Current focus, status, blockers (1-3 bullets) -->
-
-## Progress
-<!-- Done: completed items (1-3). Remaining: next steps (1-3). Blockers: if any. -->
+  log "Falling back to git-state-only context"
+  EXCHANGE_SECTION="(Session transcript not available — using git state only)"
+fi
 
-## Decisions
-<!-- Format: - **[Decision]** — [rationale] (YYYY-MM-DD) [ACTIVE|SUPERSEDED] -->
+# Build prompt for fresh claude -p invocation
+PROMPT="You are a working memory updater. Your ONLY job is to update the file at ${MEMORY_FILE} using the Write tool. Do it immediately — do not ask questions or explain.
 
-## Modified Files
-<!-- File paths only, most recent first -->
+Current working memory:
+${EXISTING_MEMORY:-"(no existing content)"}
 
-## Context
-<!-- Branch, PR, architectural context, open questions -->
+${EXCHANGE_SECTION}
 
-## Session Log
+Git state:
+${GIT_STATE:-"(not a git repo)"}
 
-### Today
-<!-- Chronological summary of work done today (2-5 bullets) -->
+Instructions:
+- Use the Write tool to update ${MEMORY_FILE} immediately
+- Keep under 120 lines
+- Use sections: ## Now, ## Progress, ## Decisions, ## Modified Files, ## Context, ## Session Log
+- Integrate new information with existing content
+- Deduplicate overlapping information
+- ## Progress tracks Done (completed), Remaining (next steps), Blockers (if any)
+- ## Decisions entries: format as - **[Decision]** — [rationale] (YYYY-MM-DD) [ACTIVE|SUPERSEDED]"
 
-### This Week
-<!-- Broader multi-day context if relevant -->${PATTERNS_INSTRUCTION}"
-fi
+log "--- Full prompt being passed to claude -p ---"
+log "$PROMPT"
+log "--- End prompt ---"
 
-# Resume session headlessly to perform the update
-TIMEOUT=120  # Normal runtime 30-60s; 2x margin
+# Run fresh claude -p (no --resume, no conversation confusion)
+TIMEOUT=120
 
-DEVFLOW_BG_UPDATER=1 env -u CLAUDECODE "$CLAUDE_BIN" -p \
-  --resume "$SESSION_ID" \
+DEVFLOW_BG_UPDATER=1 "$CLAUDE_BIN" -p \
   --model haiku \
-  --tools "Read,Write,Bash" \
-  --allowedTools \
-    "Read($CWD/.memory/WORKING-MEMORY.md)" \
-    "Read($CWD/.memory/PROJECT-PATTERNS.md)" \
-    "Write($CWD/.memory/WORKING-MEMORY.md)" \
-    "Write($CWD/.memory/PROJECT-PATTERNS.md)" \
-    "Bash(git status:*)" \
-    "Bash(git log:*)" \
-    "Bash(git diff:*)" \
-    "Bash(git branch:*)" \
-  --no-session-persistence \
+  --dangerously-skip-permissions \
   --output-format text \
-  "$INSTRUCTION" \
+  "$PROMPT" \
   >> "$LOG_FILE" 2>&1 &
 CLAUDE_PID=$!
 

package/scripts/hooks/session-start-memory

@@ -2,7 +2,7 @@
 
 # SessionStart Hook
 # Injects working memory AND ambient skill content as additionalContext.
-# Memory: restores .memory/WORKING-MEMORY.md + patterns + git state + compact recovery.
+# Memory: restores .memory/WORKING-MEMORY.md + git state + compact recovery.
 # Ambient: injects ambient-router SKILL.md so Claude has it in context (no Read call needed).
 # Either section can fire independently — ambient works even without memory files.
 
@@ -27,13 +27,6 @@ MEMORY_FILE="$CWD/.memory/WORKING-MEMORY.md"
 if [ -f "$MEMORY_FILE" ]; then
   MEMORY_CONTENT=$(cat "$MEMORY_FILE")
 
-  # Read accumulated patterns if they exist
-  PATTERNS_FILE="$CWD/.memory/PROJECT-PATTERNS.md"
-  PATTERNS_CONTENT=""
-  if [ -f "$PATTERNS_FILE" ]; then
-    PATTERNS_CONTENT=$(cat "$PATTERNS_FILE")
-  fi
-
   # Compute staleness warning
   if stat --version &>/dev/null 2>&1; then
     FILE_MTIME=$(stat -c %Y "$MEMORY_FILE")
@@ -91,15 +84,6 @@ $BACKUP_MEMORY
 
 ${MEMORY_CONTENT}"
 
-  # Insert accumulated patterns between working memory and git state
-  if [ -n "$PATTERNS_CONTENT" ]; then
-    CONTEXT="${CONTEXT}
-
---- PROJECT PATTERNS (accumulated) ---
-
-${PATTERNS_CONTENT}"
-  fi
-
   CONTEXT="${CONTEXT}
 
 --- CURRENT GIT STATE ---

package/shared/skills/ambient-router/SKILL.md

@@ -2,7 +2,7 @@
 name: ambient-router
 description: This skill should be used when classifying user intent for ambient mode, auto-loading relevant skills without explicit command invocation. Used by the always-on UserPromptSubmit hook.
 user-invocable: false
-allowed-tools: Read, Grep, Glob
+# No allowed-tools: orchestrator requires unrestricted access (Skill, Agent, Edit, Write, Bash)
 ---
 
 # Ambient Router
@@ -89,6 +89,9 @@ When classification is GUIDED or ORCHESTRATED, skill loading is NON-NEGOTIABLE.
 Do not rationalize skipping skills. Do not respond without loading them first.
 BLOCKING REQUIREMENT: Invoke each selected skill using the Skill tool before proceeding.
 For IMPLEMENT intent, enforce TDD: write the failing test before ANY production code.
+NOTE: Skills loaded in the main session via ambient mode are reference patterns only —
+their allowed-tools metadata does NOT restrict your tool access. You retain full access
+to all tools (Edit, Write, Bash, Agent, etc.) for implementation work.
 </IMPORTANT>
 
 - **QUICK:** Respond directly. No preamble, no classification statement.

package/shared/skills/docs-framework/SKILL.md

@@ -38,7 +38,6 @@ All generated documentation lives under `.docs/` in the project root:
 
 .memory/
 ├── WORKING-MEMORY.md                   # Auto-maintained by Stop hook (overwritten)
-├── PROJECT-PATTERNS.md                 # Accumulated patterns (merged across sessions)
 ├── backup.json                         # Pre-compact git state snapshot
 └── knowledge/
     ├── decisions.md                    # Architectural decisions (ADR-NNN format)