autoworkflow 3.8.4 → 3.9.1

package/.claude/hooks/phase-transition.sh

@@ -53,6 +53,48 @@ get_task_type() {
     fi
 }
 
+# Reflection prompts (Serena-inspired)
+# These prompt Claude to self-assess before proceeding
+output_reflection_prompt() {
+    local phase="$1"
+
+    echo ""
+    echo -e "${CYAN}━━━ REFLECTION CHECK ━━━${NC}"
+
+    case "$phase" in
+        PLAN)
+            echo -e "${DIM}Before proceeding to PLAN, verify:${NC}"
+            echo "  • Have you read ALL relevant files?"
+            echo "  • Do you understand the existing patterns?"
+            echo "  • Have you checked BLUEPRINT.md for requirements?"
+            echo "  • Are there edge cases you haven't considered?"
+            ;;
+        IMPLEMENT)
+            echo -e "${DIM}Before proceeding to IMPLEMENT, verify:${NC}"
+            echo "  • Does this plan match the original request?"
+            echo "  • Have you considered all affected files?"
+            echo "  • Are there simpler alternatives?"
+            echo "  • Will this introduce breaking changes?"
+            ;;
+        VERIFY)
+            echo -e "${DIM}Before proceeding to VERIFY, verify:${NC}"
+            echo "  • Is the implementation complete?"
+            echo "  • Have you handled all edge cases?"
+            echo "  • Are there TODO/FIXME comments left?"
+            echo "  • Did you test the happy path mentally?"
+            ;;
+        COMMIT)
+            echo -e "${DIM}Before proceeding to COMMIT, verify:${NC}"
+            echo "  • Is this work truly complete?"
+            echo "  • Would you be confident shipping this?"
+            echo "  • Have you updated BLUEPRINT.md if needed?"
+            echo "  • Does the commit message accurately describe changes?"
+            ;;
+    esac
+    echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+}
+
 # Check analyze gate
 check_analyze_gate() {
     echo ""
@@ -198,6 +240,13 @@ transition() {
     echo ""
     echo -e "${GREEN}✅ Gate passed - Now in ${BOLD}$to${NC} phase"
     echo ""
+
+    # Output reflection prompt for the new phase
+    output_reflection_prompt "$to"
+
+    # Prompt to update memories based on completed phase
+    prompt_memory_update "$from"
+
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     echo ""
 
@@ -240,6 +289,125 @@ reset_workflow() {
     echo ""
 }
 
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# MEMORY SYSTEM v2 (Serena-inspired)
+# Claude edits files directly + hooks prompt at key moments
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+MEMORY_DIR="$STATE_DIR/memories"
+mkdir -p "$MEMORY_DIR"
+
+# Prompt Claude to update memories (called at phase transitions)
+prompt_memory_update() {
+    local phase="$1"
+    local memory_type=""
+    local prompt_text=""
+
+    case "$phase" in
+        PLAN|CONFIRM)
+            memory_type="decisions"
+            prompt_text="If you made any architectural or implementation decisions, update .claude/.autoworkflow/memories/decisions.md"
+            ;;
+        IMPLEMENT|VERIFY)
+            memory_type="patterns"
+            prompt_text="If you discovered any codebase patterns, update .claude/.autoworkflow/memories/patterns.md"
+            ;;
+        COMMIT)
+            memory_type="context"
+            prompt_text="Update .claude/.autoworkflow/memories/context.md with session summary for continuity"
+            ;;
+    esac
+
+    if [ -n "$memory_type" ]; then
+        echo ""
+        echo -e "${CYAN}━━━ MEMORY UPDATE ━━━${NC}"
+        echo -e "${DIM}$prompt_text${NC}"
+        echo ""
+        echo -e "${DIM}Format: Add a new ## Section with date and details${NC}"
+        echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo ""
+    fi
+}
+
+# Prompt to record a blocker (called when errors occur)
+prompt_blocker_update() {
+    local error_context="$1"
+    echo ""
+    echo -e "${YELLOW}━━━ BLOCKER DETECTED ━━━${NC}"
+    echo -e "${DIM}Consider recording this in .claude/.autoworkflow/memories/blockers.md${NC}"
+    echo ""
+    echo -e "${DIM}Include: Issue, Symptoms, Workaround, Status${NC}"
+    echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+}
+
+# Load and display memories at session start
+load_memories_summary() {
+    echo ""
+    echo -e "${CYAN}━━━ PROJECT MEMORIES ━━━${NC}"
+
+    local has_memories=false
+
+    # Check decisions
+    if [ -f "$MEMORY_DIR/decisions.md" ]; then
+        local decision_count=$(grep -c "^## " "$MEMORY_DIR/decisions.md" 2>/dev/null || echo "0")
+        if [ "$decision_count" -gt 1 ]; then  # More than template
+            echo -e "  ${GREEN}●${NC} Decisions: $((decision_count - 1)) recorded"
+            has_memories=true
+        fi
+    fi
+
+    # Check patterns
+    if [ -f "$MEMORY_DIR/patterns.md" ]; then
+        local pattern_count=$(grep -c "^## " "$MEMORY_DIR/patterns.md" 2>/dev/null || echo "0")
+        if [ "$pattern_count" -gt 1 ]; then
+            echo -e "  ${GREEN}●${NC} Patterns: $((pattern_count - 1)) recorded"
+            has_memories=true
+        fi
+    fi
+
+    # Check blockers
+    if [ -f "$MEMORY_DIR/blockers.md" ]; then
+        local blocker_count=$(grep -c "^## " "$MEMORY_DIR/blockers.md" 2>/dev/null || echo "0")
+        if [ "$blocker_count" -gt 1 ]; then
+            echo -e "  ${YELLOW}●${NC} Blockers: $((blocker_count - 1)) recorded"
+            has_memories=true
+        fi
+    fi
+
+    if [ "$has_memories" = false ]; then
+        echo -e "  ${DIM}No memories recorded yet${NC}"
+    fi
+
+    echo ""
+    echo -e "${DIM}Read with: Read tool on .claude/.autoworkflow/memories/*.md${NC}"
+    echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+}
+
+# Load context summary (for session resume)
+load_context() {
+    local context_file="$MEMORY_DIR/context.md"
+
+    if [ -f "$context_file" ]; then
+        echo ""
+        echo -e "${CYAN}━━━ PREVIOUS SESSION CONTEXT ━━━${NC}"
+        # Show just the key sections
+        if grep -q "## What Was Done" "$context_file"; then
+            echo -e "${BOLD}What Was Done:${NC}"
+            sed -n '/## What Was Done/,/## /p' "$context_file" | head -8 | tail -n +2
+        fi
+        if grep -q "## What Remains" "$context_file"; then
+            echo -e "${BOLD}What Remains:${NC}"
+            sed -n '/## What Remains/,/## /p' "$context_file" | head -8 | tail -n +2
+        fi
+        echo ""
+        echo -e "${DIM}Full context: .claude/.autoworkflow/memories/context.md${NC}"
+        echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo ""
+    fi
+}
+
 # Main command dispatcher
 case "$1" in
     transition)
@@ -269,6 +437,19 @@ case "$1" in
         fi
         echo ""
         ;;
+    # Memory commands v2 (Claude edits files directly)
+    memories)
+        load_memories_summary
+        ;;
+    context)
+        load_context
+        ;;
+    blocker)
+        prompt_blocker_update "$2"
+        ;;
+    reflect)
+        output_reflection_prompt "$2"
+        ;;
     *)
         echo "Usage: phase-transition.sh <command> [args]"
         echo ""
@@ -278,5 +459,17 @@ case "$1" in
         echo "  reject                  - Record plan rejection"
         echo "  reset                   - Reset workflow state"
         echo "  status                  - Show current state"
+        echo ""
+        echo "Memory Commands (Claude edits files directly):"
+        echo "  memories                - Show memory summary"
+        echo "  context                 - Load previous session context"
+        echo "  blocker                 - Prompt to record a blocker"
+        echo "  reflect <phase>         - Show reflection prompts"
+        echo ""
+        echo "Memory Files (edit directly with Claude):"
+        echo "  .claude/.autoworkflow/memories/decisions.md"
+        echo "  .claude/.autoworkflow/memories/patterns.md"
+        echo "  .claude/.autoworkflow/memories/blockers.md"
+        echo "  .claude/.autoworkflow/memories/context.md"
         ;;
 esac

package/.claude/hooks/pre-tool-router.sh

@@ -1,12 +1,21 @@
 #!/bin/bash
 # AutoWorkflow Pre-Tool Router
 # Runs on: PreToolUse for Bash tool
-# Purpose: Route commands to appropriate checks
+# Purpose: Route commands to appropriate checks + Mode restrictions (Serena-inspired)
 #
 # This router determines what checks to run based on the command being executed
+# It also enforces task-type-aware restrictions (similar to Serena's mode switching)
 
 TOOL_INPUT="$1"
 
+# Colors
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+DIM='\033[2m'
+NC='\033[0m'
+
 # Project directory (use env var if set, otherwise current directory)
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
 
@@ -14,6 +23,135 @@ PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
 STATE_DIR="$PROJECT_DIR/.claude/.autoworkflow"
 mkdir -p "$STATE_DIR"
 
+# Get current task type
+get_task_type() {
+    if [ -f "$STATE_DIR/task-type" ]; then
+        cat "$STATE_DIR/task-type"
+    else
+        echo "unknown"
+    fi
+}
+
+# Get current phase
+get_phase() {
+    if [ -f "$STATE_DIR/phase" ]; then
+        cat "$STATE_DIR/phase"
+    else
+        echo "IDLE"
+    fi
+}
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# MODE RESTRICTIONS (Serena-inspired)
+# Different task types have different allowed operations
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# Check if command creates new files
+is_file_creation() {
+    echo "$TOOL_INPUT" | grep -qE "(touch|mkdir|>|tee|cp.*-r)"
+}
+
+# Check if command modifies package dependencies
+is_dependency_change() {
+    echo "$TOOL_INPUT" | grep -qE "(npm install|yarn add|pnpm add|pip install|go get)"
+}
+
+# Check if command runs database migrations
+is_migration() {
+    echo "$TOOL_INPUT" | grep -qE "(migrate|prisma.*push|prisma.*migrate|alembic)"
+}
+
+# Check mode restrictions based on task type
+check_mode_restrictions() {
+    local task_type=$(get_task_type)
+    local phase=$(get_phase)
+
+    case "$task_type" in
+        docs)
+            # Docs mode: Only allow documentation-related operations
+            if is_file_creation && ! echo "$TOOL_INPUT" | grep -qE "\.(md|txt|rst)"; then
+                echo ""
+                echo -e "${YELLOW}━━━ MODE RESTRICTION: docs ━━━${NC}"
+                echo ""
+                echo -e "Task type is ${BOLD}docs${NC} - creating non-documentation files requires approval."
+                echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+                echo ""
+                echo "If this is intentional, confirm with the user."
+                echo ""
+                # Warn but don't block
+            fi
+            ;;
+        fix)
+            # Fix mode: Warn on new file creation (fixes usually modify existing files)
+            if is_file_creation; then
+                echo ""
+                echo -e "${YELLOW}━━━ MODE RESTRICTION: fix ━━━${NC}"
+                echo ""
+                echo -e "Task type is ${BOLD}fix${NC} - creating new files is unusual for bug fixes."
+                echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+                echo ""
+                echo "Consider: Is this truly a fix, or should this be classified as a feature?"
+                echo ""
+            fi
+            if is_dependency_change; then
+                echo ""
+                echo -e "${YELLOW}━━━ MODE RESTRICTION: fix ━━━${NC}"
+                echo ""
+                echo -e "Task type is ${BOLD}fix${NC} - adding dependencies for a fix is unusual."
+                echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+                echo ""
+                echo "Confirm this dependency is necessary for the fix."
+                echo ""
+            fi
+            ;;
+        refactor)
+            # Refactor mode: Warn on behavior-changing operations
+            if is_migration; then
+                echo ""
+                echo -e "${YELLOW}━━━ MODE RESTRICTION: refactor ━━━${NC}"
+                echo ""
+                echo -e "Task type is ${BOLD}refactor${NC} - migrations may change behavior."
+                echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+                echo ""
+                echo "Refactoring should preserve existing behavior."
+                echo "Confirm this migration is safe."
+                echo ""
+            fi
+            ;;
+        query)
+            # Query mode: Read-only, warn on any modifications
+            if is_file_creation || is_dependency_change || is_migration; then
+                echo ""
+                echo -e "${YELLOW}━━━ MODE RESTRICTION: query ━━━${NC}"
+                echo ""
+                echo -e "Task type is ${BOLD}query${NC} - this should be read-only."
+                echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+                echo ""
+                echo "Queries should not modify the codebase."
+                echo "If modifications are needed, reclassify the task."
+                echo ""
+            fi
+            ;;
+    esac
+
+    # Phase-based restrictions
+    if [ "$phase" = "ANALYZE" ] || [ "$phase" = "PLAN" ]; then
+        if is_file_creation || is_dependency_change; then
+            echo ""
+            echo -e "${YELLOW}━━━ PHASE RESTRICTION ━━━${NC}"
+            echo ""
+            echo -e "Current phase is ${BOLD}$phase${NC} - modifications should wait for IMPLEMENT phase."
+            echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+            echo ""
+            echo "Complete planning and get approval before making changes."
+            echo ""
+        fi
+    fi
+}
+
+# Run mode restriction checks
+check_mode_restrictions
+
 # Check if this is a git commit command
 is_git_commit() {
     echo "$TOOL_INPUT" | grep -qE "git\s+commit|git\s+.*commit"

package/.claude/hooks/session-check.sh

@@ -5,7 +5,7 @@
 #
 # This hook implements:
 # - on:conversation_start trigger
-# - on:blueprint_missing trigger (AUTO-RUN audit)
+# - on:blueprint_missing trigger (prompt user for documentation)
 # - on:init_needed trigger
 # - on:task_received trigger (task classification)
 
@@ -37,6 +37,41 @@ SESSION_RESUMED_FILE="$STATE_DIR/session-resumed"
 CURRENT_TURN_EDITS_FILE="$STATE_DIR/current-turn-edits"
 SUGGESTIONS_SHOWN_FILE="$STATE_DIR/suggestions-shown"
 
+# Memory system (Serena-inspired)
+MEMORY_DIR="$STATE_DIR/memories"
+CONTEXT_FILE="$MEMORY_DIR/context.md"
+
+# Load previous context if available (Serena-inspired)
+load_previous_context() {
+    if [ -f "$CONTEXT_FILE" ]; then
+        echo ""
+        echo -e "${CYAN}━━━ PREVIOUS SESSION CONTEXT ━━━${NC}"
+        echo ""
+        # Extract key sections from context file
+        if grep -q "## What Was Done" "$CONTEXT_FILE"; then
+            echo -e "${BOLD}What Was Done:${NC}"
+            sed -n '/## What Was Done/,/## /p' "$CONTEXT_FILE" | head -10 | tail -n +2
+            echo ""
+        fi
+        if grep -q "## What Remains" "$CONTEXT_FILE"; then
+            echo -e "${BOLD}What Remains:${NC}"
+            sed -n '/## What Remains/,/## /p' "$CONTEXT_FILE" | head -10 | tail -n +2
+            echo ""
+        fi
+        if grep -q "## Key Decisions Made" "$CONTEXT_FILE"; then
+            echo -e "${BOLD}Key Decisions:${NC}"
+            sed -n '/## Key Decisions Made/,/## /p' "$CONTEXT_FILE" | head -5 | tail -n +2
+            echo ""
+        fi
+        echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo ""
+        echo -e "${DIM}Full context: .claude/.autoworkflow/memories/context.md${NC}"
+        echo ""
+        return 0
+    fi
+    return 1
+}
+
 # Check for resumable session state
 check_session_resume() {
     # Only show resume prompt once per session
@@ -97,6 +132,9 @@ check_session_resume() {
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
             echo ""
 
+            # Load previous context if available
+            load_previous_context
+
             # Mark that we've shown the resume prompt
             touch "$SESSION_RESUMED_FILE"
             return 0
@@ -162,7 +200,7 @@ check_init_needed() {
     return 1
 }
 
-# Check for missing BLUEPRINT.md - triggers AUTO audit
+# Check for project documentation - ask user to provide their docs
 check_blueprint() {
     # Only check once per session
     if [ -f "$BLUEPRINT_CHECK_FILE" ]; then
@@ -175,31 +213,47 @@ check_blueprint() {
     if [ ! -f "instructions/BLUEPRINT.md" ]; then
         echo ""
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-        echo -e "${RED}${BOLD}⚠️  AUTOWORKFLOW TRIGGER: BLUEPRINT_MISSING${NC}"
+        echo -e "${YELLOW}${BOLD}📋 AUTOWORKFLOW: PROJECT DOCUMENTATION NEEDED${NC}"
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
         echo ""
-        echo "instructions/BLUEPRINT.md does not exist."
+        echo "No project documentation found."
+        echo ""
+        echo -e "${BOLD}Please provide your project documentation:${NC}"
+        echo ""
+        echo "  ${CYAN}Option 1:${NC} Point to existing docs"
+        echo "    • PRD (Product Requirements Document)"
+        echo "    • Specification document"
+        echo "    • Userflow document"
+        echo "    • Implementation guide"
+        echo "    • Any design/architecture docs"
+        echo ""
+        echo "  ${CYAN}Option 2:${NC} Describe your project"
+        echo "    • What does this project do?"
+        echo "    • What are the main features?"
+        echo "    • What's the tech stack?"
         echo ""
-        echo -e "${BOLD}ACTION: RUN PROJECT AUDIT IMMEDIATELY${NC}"
+        echo "  ${CYAN}Option 3:${NC} Interactive"
+        echo "    • Say: \"Help me define my project\""
+        echo "    • I'll ask questions to understand your project"
         echo ""
-        echo "Do NOT ask permission to start. Just run these commands now:"
+        echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
         echo ""
-        echo -e "${CYAN}1.${NC} cat package.json | head -50     ${DIM}# Detect tech stack${NC}"
-        echo -e "${CYAN}2.${NC} ls -la                          ${DIM}# See project structure${NC}"
-        echo -e "${CYAN}3.${NC} ls src/ 2>/dev/null || ls app/  ${DIM}# Find source directory${NC}"
-        echo -e "${CYAN}4.${NC} find . -name '*.ts' -o -name '*.tsx' | head -20"
+        echo -e "${BOLD}When you provide documentation:${NC}"
         echo ""
-        echo "Then generate:"
-        echo "  - instructions/AI_RULES.md (tech stack, file structure)"
-        echo "  - instructions/BLUEPRINT.md (features, routes, APIs)"
+        echo "  Your document = ${GREEN}SINGLE SOURCE OF TRUTH${NC}"
         echo ""
-        echo -e "${YELLOW}Only ask user approval to SAVE, not to start scanning.${NC}"
+        echo "  • I will read and understand it"
+        echo "  • I will reference it for all tasks"
+        echo "  • No transformation or format conversion"
+        echo ""
+        echo -e "${DIM}Your document structure is preserved exactly as-is.${NC}"
+        echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
         echo ""
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
         echo ""
 
-        # Set phase to indicate audit is needed
-        set_phase "AUDIT_REQUIRED"
+        # Set phase to indicate documentation is needed
+        set_phase "DOCS_REQUIRED"
         return 1
     fi
 
@@ -367,7 +421,9 @@ output_classification() {
 
     # Instructions for this phase
     echo -e "${DIM}Read relevant files and understand the codebase.${NC}"
-    echo -e "${DIM}Check instructions/BLUEPRINT.md for requirements.${NC}"
+    echo -e "${DIM}Reference user's documentation for requirements.${NC}"
+    echo ""
+    echo -e "${DIM}💡 Tip: Use 'phase-transition.sh memory-save decisions <key> <value>' to record decisions.${NC}"
     echo ""
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     echo ""
@@ -406,6 +462,47 @@ reset_turn_state() {
     echo "0" > "$CURRENT_TURN_EDITS_FILE"
 }
 
+# Load and display memories summary (for context awareness)
+show_memories_summary() {
+    local has_memories=false
+
+    # Check if any memories exist (beyond templates)
+    for file in "$MEMORY_DIR/decisions.md" "$MEMORY_DIR/patterns.md" "$MEMORY_DIR/blockers.md"; do
+        if [ -f "$file" ]; then
+            local count=$(grep -c "^## " "$file" 2>/dev/null || echo "0")
+            if [ "$count" -gt 1 ]; then
+                has_memories=true
+                break
+            fi
+        fi
+    done
+
+    if [ "$has_memories" = true ]; then
+        echo ""
+        echo -e "${CYAN}━━━ PROJECT MEMORIES ━━━${NC}"
+
+        if [ -f "$MEMORY_DIR/decisions.md" ]; then
+            local count=$(grep -c "^## " "$MEMORY_DIR/decisions.md" 2>/dev/null || echo "0")
+            [ "$count" -gt 1 ] && echo -e "  ${GREEN}●${NC} Decisions: $((count - 1)) recorded"
+        fi
+
+        if [ -f "$MEMORY_DIR/patterns.md" ]; then
+            local count=$(grep -c "^## " "$MEMORY_DIR/patterns.md" 2>/dev/null || echo "0")
+            [ "$count" -gt 1 ] && echo -e "  ${GREEN}●${NC} Patterns: $((count - 1)) recorded"
+        fi
+
+        if [ -f "$MEMORY_DIR/blockers.md" ]; then
+            local count=$(grep -c "^## " "$MEMORY_DIR/blockers.md" 2>/dev/null || echo "0")
+            [ "$count" -gt 1 ] && echo -e "  ${YELLOW}●${NC} Blockers: $((count - 1)) recorded"
+        fi
+
+        echo ""
+        echo -e "${DIM}Read: .claude/.autoworkflow/memories/*.md${NC}"
+        echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo ""
+    fi
+}
+
 # Main execution
 main() {
     local is_new_session=false
@@ -428,9 +525,12 @@ main() {
         check_session_resume
     fi
 
-    # Check for missing blueprint (triggers auto-audit)
+    # Check for missing blueprint (prompts user for documentation)
     check_blueprint
 
+    # Show memories summary (if any exist)
+    show_memories_summary
+
     # Show current state if not idle
     show_state
 }

package/.claude/settings.json

@@ -107,7 +107,7 @@
     "→ THEN execute the audit with this knowledge loaded",
     "",
     "### Auto-Triggers (Hooks enforce these)",
-    "1. **SESSION START**: If instructions/BLUEPRINT.md missing → AUTO-RUN audit (no permission needed)",
+    "1. **SESSION START**: If no documentation provided → Prompt user for project documentation",
     "2. **AFTER CODE CHANGES**: Run `npm run verify` automatically. Fix errors until passing (max 10 iterations)",
     "3. **BEFORE COMMIT**: All 7 gates must pass or commit is BLOCKED:",
     "   - TypeScript errors = 0",
@@ -135,7 +135,7 @@
     "",
     "### Required Files",
     "- Read instructions/AI_RULES.md for coding standards",
-    "- Read instructions/BLUEPRINT.md for project state",
+    "- Reference user's documentation (single source of truth)",
     "- Read system/router.md to classify task type",
     "- Read system/gates.md for blocking rules",
     "",
@@ -144,7 +144,16 @@
     "- phase: Current phase (ANALYZE, PLAN, etc.)",
     "- task-type: Classified task type",
     "- verify-iteration: Current verify loop count",
-    "- gate-status: Last gate check result"
+    "- gate-status: Last gate check result",
+    "",
+    "### Memory System (Persistent Context)",
+    "Edit these files directly using the Edit tool:",
+    "- `.claude/.autoworkflow/memories/decisions.md` - After PLAN: record architectural choices",
+    "- `.claude/.autoworkflow/memories/patterns.md` - After IMPLEMENT: record discovered patterns",
+    "- `.claude/.autoworkflow/memories/blockers.md` - When errors: record issues and workarounds",
+    "- `.claude/.autoworkflow/memories/context.md` - Before COMMIT: update session summary",
+    "",
+    "Format: ## Title, *Date*, Content, ---"
   ],
 
   "workflow": {

package/.claude/settings.local.json

@@ -19,7 +19,13 @@
       "Bash(npm view:*)",
       "Bash(env)",
       "Bash(npx autoworkflow update)",
-      "Bash(grep:*)"
+      "Bash(grep:*)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:medium.com)",
+      "WebFetch(domain:apidog.com)",
+      "WebFetch(domain:mcpservers.org)",
+      "WebFetch(domain:oraios.github.io)",
+      "Bash(bash:*)"
     ]
   }
 }