autoworkflow 3.9.0 → 3.9.1

package/.claude/.autoworkflow/memories/blockers.md

@@ -1,23 +1,15 @@
-# Blockers Memory
+# Blockers
 
-> Document known issues, workarounds, and gotchas.
-> Saves time by not rediscovering the same problems.
+> Known issues and workarounds. Claude edits directly.
 
 ---
 
-## Template Entry
-
-*Recorded: YYYY-MM-DD HH:MM:SS*
+## Template
+*YYYY-MM-DD*
 
 **Issue:** What is the problem?
-
-**Symptoms:** How does it manifest?
-
-**Root Cause:** Why does this happen? (if known)
-
 **Workaround:** How to work around it?
-
-**Status:** Open / Resolved / Won't Fix
+**Status:** Open / Resolved
 
 ---
 

package/.claude/.autoworkflow/memories/decisions.md

@@ -1,22 +1,14 @@
-# Decisions Memory
+# Decisions
 
-> Document important architectural and implementation decisions here.
-> This helps maintain context across sessions and explains "why" for future reference.
+> Architectural and implementation choices. Claude edits directly.
 
 ---
 
-## Template Entry
-
-*Recorded: YYYY-MM-DD HH:MM:SS*
-
-**Context:** What was the situation or requirement?
-
-**Options Considered:**
-1. Option A - pros/cons
-2. Option B - pros/cons
+## Template
+*YYYY-MM-DD*
 
+**Context:** What was the situation?
 **Decision:** What was chosen and why?
-
 **Implications:** What does this mean going forward?
 
 ---

package/.claude/.autoworkflow/memories/patterns.md

@@ -1,24 +1,15 @@
-# Patterns Memory
+# Patterns
 
-> Document discovered patterns in this codebase.
-> Helps maintain consistency and avoid reinventing solutions.
+> Discovered codebase patterns. Claude edits directly.
 
 ---
 
-## Template Entry
+## Template
+*YYYY-MM-DD*
 
-*Recorded: YYYY-MM-DD HH:MM:SS*
-
-**Pattern Name:** What is this pattern called?
-
-**Where Used:** Which files/components use this?
-
-**How It Works:**
-```
-// Code example or description
-```
-
-**When to Use:** What situations call for this pattern?
+**Pattern:** What is this pattern?
+**Where:** Which files/components use it?
+**Usage:** When and how to use it?
 
 ---
 

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

@@ -244,6 +244,9 @@ transition() {
     # 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 ""
 
@@ -287,127 +290,119 @@ reset_workflow() {
 }
 
 # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-# MEMORY SYSTEM (Serena-inspired)
-# Persistent context that survives across sessions
+# MEMORY SYSTEM v2 (Serena-inspired)
+# Claude edits files directly + hooks prompt at key moments
 # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 MEMORY_DIR="$STATE_DIR/memories"
 mkdir -p "$MEMORY_DIR"
 
-# Save a memory (key-value with optional category)
-save_memory() {
-    local category="$1"
-    local key="$2"
-    local value="$3"
-    local timestamp=$(date +"%Y-%m-%d %H:%M:%S")
-
-    local memory_file="$MEMORY_DIR/${category}.md"
-
-    # Create file with header if it doesn't exist
-    if [ ! -f "$memory_file" ]; then
-        cat > "$memory_file" << EOF
-# ${category^} Memory
-
-> Auto-generated memory store. Add entries as you work.
-
----
-
-EOF
-    fi
-
-    # Append new memory entry
-    cat >> "$memory_file" << EOF
-## $key
-*Recorded: $timestamp*
-
-$value
-
----
-
-EOF
-
-    echo -e "${GREEN}✅${NC} Memory saved: $category/$key"
-}
+# Prompt Claude to update memories (called at phase transitions)
+prompt_memory_update() {
+    local phase="$1"
+    local memory_type=""
+    local prompt_text=""
 
-# Read memories for a category
-read_memories() {
-    local category="$1"
-    local memory_file="$MEMORY_DIR/${category}.md"
+    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 [ -f "$memory_file" ]; then
-        cat "$memory_file"
-    else
-        echo "No memories found for category: $category"
+    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
 }
 
-# List all memory categories
-list_memories() {
+# Prompt to record a blocker (called when errors occur)
+prompt_blocker_update() {
+    local error_context="$1"
     echo ""
-    echo -e "${CYAN}Available Memory Categories:${NC}"
+    echo -e "${YELLOW}━━━ BLOCKER DETECTED ━━━${NC}"
+    echo -e "${DIM}Consider recording this in .claude/.autoworkflow/memories/blockers.md${NC}"
     echo ""
-
-    if [ -d "$MEMORY_DIR" ]; then
-        for file in "$MEMORY_DIR"/*.md; do
-            if [ -f "$file" ]; then
-                local category=$(basename "$file" .md)
-                local count=$(grep -c "^## " "$file" 2>/dev/null || echo "0")
-                echo "  - $category ($count entries)"
-            fi
-        done
-    else
-        echo "  No memories stored yet."
-    fi
+    echo -e "${DIM}Include: Issue, Symptoms, Workaround, Status${NC}"
+    echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
     echo ""
 }
 
-# Save context for session continuity
-save_context() {
-    local task_description="$1"
-    local current_phase=$(get_phase)
-    local task_type=$(get_task_type)
-    local timestamp=$(date +"%Y-%m-%d %H:%M:%S")
-
-    local context_file="$MEMORY_DIR/context.md"
-
-    cat > "$context_file" << EOF
-# Session Context
-
-> Last updated: $timestamp
-
-## Current State
-- **Phase:** $current_phase
-- **Task Type:** $task_type
-- **Description:** $task_description
-
-## What Was Done
-<!-- Claude should update this section as work progresses -->
+# Load and display memories at session start
+load_memories_summary() {
+    echo ""
+    echo -e "${CYAN}━━━ PROJECT MEMORIES ━━━${NC}"
 
-## What Remains
-<!-- Claude should update this section -->
+    local has_memories=false
 
-## Key Decisions Made
-<!-- Document important choices and their rationale -->
+    # 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
 
-## Files Modified
-$(cat "$STATE_DIR/changed-files" 2>/dev/null || echo "None yet")
+    # 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
 
-*Use this context to resume work in a new session.*
-EOF
+    if [ "$has_memories" = false ]; then
+        echo -e "  ${DIM}No memories recorded yet${NC}"
+    fi
 
-    echo -e "${GREEN}✅${NC} Context saved for session continuity"
+    echo ""
+    echo -e "${DIM}Read with: Read tool on .claude/.autoworkflow/memories/*.md${NC}"
+    echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
 }
 
-# Load context summary
+# 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}"
-        cat "$context_file"
+        # 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
@@ -442,22 +437,16 @@ case "$1" in
         fi
         echo ""
         ;;
-    # Memory commands (Serena-inspired)
-    memory-save)
-        save_memory "$2" "$3" "$4"
-        ;;
-    memory-read)
-        read_memories "$2"
-        ;;
-    memory-list)
-        list_memories
+    # Memory commands v2 (Claude edits files directly)
+    memories)
+        load_memories_summary
         ;;
-    context-save)
-        save_context "$2"
-        ;;
-    context-load)
+    context)
         load_context
         ;;
+    blocker)
+        prompt_blocker_update "$2"
+        ;;
     reflect)
         output_reflection_prompt "$2"
         ;;
@@ -471,12 +460,16 @@ case "$1" in
         echo "  reset                   - Reset workflow state"
         echo "  status                  - Show current state"
         echo ""
-        echo "Memory Commands (Serena-inspired):"
-        echo "  memory-save <category> <key> <value>  - Save a memory"
-        echo "  memory-read <category>                - Read memories"
-        echo "  memory-list                           - List all categories"
-        echo "  context-save <description>            - Save session context"
-        echo "  context-load                          - Load previous context"
-        echo "  reflect <phase>                       - Show reflection prompts"
+        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/session-check.sh

@@ -462,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
@@ -487,6 +528,9 @@ main() {
     # 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

@@ -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.md

@@ -126,33 +126,40 @@ All state stored in `.claude/.autoworkflow/`:
 
 ## Memory System (Serena-inspired)
 
-Persistent context that survives across sessions. Stored in `.claude/.autoworkflow/memories/`.
+Persistent context that survives across sessions. **Claude edits files directly** + hooks prompt at key moments.
 
-| File | Purpose |
-|------|---------|
-| `decisions.md` | Document architectural/implementation choices |
-| `patterns.md` | Record discovered codebase patterns |
-| `blockers.md` | Track known issues and workarounds |
-| `context.md` | Session continuity (auto-generated) |
-
-**Memory Commands:**
-```bash
-# Save a decision
-.claude/hooks/phase-transition.sh memory-save decisions "auth-approach" "Chose JWT over sessions for stateless API"
+**Memory Files:** `.claude/.autoworkflow/memories/`
+| File | Purpose | When to Update |
+|------|---------|----------------|
+| `decisions.md` | Architectural/implementation choices | After PLAN phase |
+| `patterns.md` | Discovered codebase patterns | After IMPLEMENT |
+| `blockers.md` | Known issues and workarounds | When hitting errors |
+| `context.md` | Session continuity | Before COMMIT |
 
-# Read memories
-.claude/hooks/phase-transition.sh memory-read decisions
+**How it works:**
+1. **Session Start** → Memories summary displayed automatically
+2. **Phase Transitions** → Hooks prompt to update relevant memory
+3. **Claude Edits Directly** → Use Edit tool on memory files
+4. **No Shell Commands** → Just read and edit the markdown files
 
-# List all categories
-.claude/hooks/phase-transition.sh memory-list
+**Memory Format:**
+```markdown
+## [Entry Title]
+*[Date]*
 
-# Save context for next session
-.claude/hooks/phase-transition.sh context-save "Implementing user auth"
+[Content - decisions made, patterns found, blockers hit]
 
-# Load previous context
-.claude/hooks/phase-transition.sh context-load
+---
 ```
 
+**Automated Prompts:**
+| Trigger | Memory Prompt |
+|---------|---------------|
+| After PLAN | "Record any decisions made" |
+| After IMPLEMENT | "Record any patterns discovered" |
+| Before COMMIT | "Update context for next session" |
+| Error encountered | "Consider recording this blocker" |
+
 ---
 
 ## Reflection Prompts (Serena-inspired)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoworkflow",
-  "version": "3.9.0",
+  "version": "3.9.1",
   "description": "Automated workflow enforcement for Claude Code via hooks and system prompts",
   "type": "module",
   "bin": {