specweave 1.0.263 → 1.0.265

package/plugins/specweave/scripts/read-progress.sh

@@ -38,7 +38,8 @@ if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
 fi
 
 CACHE_FILE="$PROJECT_ROOT/.specweave/state/dashboard.json"
-SCRIPTS_DIR="$PROJECT_ROOT/plugins/specweave/scripts"
+# Resolve scripts dir relative to this script (works in both dev and plugin cache)
+SCRIPTS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # Check if jq is available, fall back to Node if not
 if ! command -v jq >/dev/null 2>&1; then
@@ -60,6 +61,36 @@ elif ! jq -e '.' "$CACHE_FILE" >/dev/null 2>&1; then
   NEED_REBUILD=true
 fi
 
+# Staleness check: if any increment file is newer than cache, rebuild
+if [[ "$NEED_REBUILD" == "false" ]] && [[ -f "$CACHE_FILE" ]]; then
+  CACHE_MTIME=0
+  if [[ "$(uname)" == "Darwin" ]]; then
+    CACHE_MTIME=$(stat -f "%m" "$CACHE_FILE" 2>/dev/null || echo "0")
+  else
+    CACHE_MTIME=$(stat -c "%Y" "$CACHE_FILE" 2>/dev/null || echo "0")
+  fi
+
+  INC_DIR="$PROJECT_ROOT/.specweave/increments"
+  if [[ -d "$INC_DIR" ]]; then
+    for d in "$INC_DIR"/[0-9]*/; do
+      [[ -d "$d" ]] || continue
+      for f in "$d"metadata.json "$d"tasks.md "$d"spec.md; do
+        [[ -f "$f" ]] || continue
+        FILE_MTIME=0
+        if [[ "$(uname)" == "Darwin" ]]; then
+          FILE_MTIME=$(stat -f "%m" "$f" 2>/dev/null || echo "0")
+        else
+          FILE_MTIME=$(stat -c "%Y" "$f" 2>/dev/null || echo "0")
+        fi
+        if [[ "$FILE_MTIME" -gt "$CACHE_MTIME" ]]; then
+          NEED_REBUILD=true
+          break 2
+        fi
+      done
+    done
+  fi
+fi
+
 if [[ "$NEED_REBUILD" == "true" ]]; then
   bash "$SCRIPTS_DIR/rebuild-dashboard-cache.sh" --quiet 2>/dev/null || true
 fi
@@ -170,7 +201,9 @@ if [[ -n "$INCREMENT_ID" ]]; then
   echo "Priority: $PRIORITY_FMT"
   echo ""
   echo "Tasks:    $COMPLETED/$TOTAL ($TASK_PCT%) $BAR"
-  echo "ACs:      $AC_COMPLETED/$AC_TOTAL ($AC_PCT%)"
+  if [[ "$AC_TOTAL" -gt 0 ]]; then
+    echo "ACs:      $AC_COMPLETED/$AC_TOTAL ($AC_PCT%)"
+  fi
   exit 0
 fi
 
@@ -179,17 +212,39 @@ echo ""
 echo "📊 Increment Progress"
 echo ""
 
-# Get ready_for_review increments FIRST (needs attention!)
+# ── Section 1: Needs Closure (100% done but still active/planning) ──
+NEEDS_CLOSURE=$(jq -r '
+  [.increments | to_entries[] |
+   select((.value.status == "active" or .value.status == "planning" or .value.status == "planned") and
+          .value.tasks.total > 0 and
+          .value.tasks.completed == .value.tasks.total)] |
+  sort_by(.value.lastActivityEpoch // 0) | reverse | .[] |
+  .key
+' "$CACHE_FILE" 2>/dev/null)
+
+CLOSURE_COUNT=0
+if [[ -n "$NEEDS_CLOSURE" ]]; then
+  echo "⚠️  Needs Closure (100% tasks done):"
+  while IFS= read -r id; do
+    [[ -z "$id" ]] && continue
+    CLOSURE_COUNT=$((CLOSURE_COUNT + 1))
+    echo "  $id → /sw:done $id"
+  done <<< "$NEEDS_CLOSURE"
+  echo ""
+fi
+
+# ── Section 2: Ready for Review ──
 READY_FOR_REVIEW=$(jq -r '
-  .increments | to_entries[] |
-  select(.value.status == "ready_for_review") |
-  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)|\(.value.acs.completed)|\(.value.acs.total)|\(.value.priority)|\(.value.type)"
+  [.increments | to_entries[] |
+   select(.value.status == "ready_for_review")] |
+  sort_by(.value.lastActivityEpoch // 0) | reverse | .[] |
+  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)|\(.value.acs.completed)|\(.value.acs.total)|\(.value.priority)"
 ' "$CACHE_FILE" 2>/dev/null)
 
 REVIEW_COUNT=0
 if [[ -n "$READY_FOR_REVIEW" ]]; then
   echo "👀 Ready for Review:"
-  while IFS='|' read -r id completed total ac_completed ac_total priority inc_type; do
+  while IFS='|' read -r id completed total ac_completed ac_total priority; do
     [[ -z "$id" ]] && continue
     REVIEW_COUNT=$((REVIEW_COUNT + 1))
     if [[ "$total" -gt 0 ]]; then
@@ -197,34 +252,36 @@ if [[ -n "$READY_FOR_REVIEW" ]]; then
     else
       pct=0
     fi
-    if [[ "$ac_total" -gt 0 ]]; then
-      ac_pct=$((ac_completed * 100 / ac_total))
-    else
-      ac_pct=0
-    fi
     bar=$(progress_bar "$pct" 12)
-    # Format priority badge
     pri_badge=""
     case "$priority" in P0|critical) pri_badge="🔴" ;; P1|high) pri_badge="🟠" ;; esac
+    ac_info=""
+    if [[ "$ac_total" -gt 0 ]]; then
+      ac_pct=$((ac_completed * 100 / ac_total))
+      ac_info=" | $ac_completed/$ac_total ACs ($ac_pct%)"
+    fi
     echo "  $pri_badge $id"
-    echo "     $bar $completed/$total tasks | $ac_completed/$ac_total ACs ($ac_pct%)"
+    echo "     $bar $completed/$total tasks$ac_info"
     echo "     → /sw:done $id"
   done <<< "$READY_FOR_REVIEW"
   echo ""
 fi
 
-# Get active increments (excluding ready_for_review and backlog)
-# Note: "planned" is a legacy typo for "planning" - support both for backwards compatibility
+# ── Section 3: Active (with real work, not 100% done, not empty) ──
+# Excludes: 100%-done (shown in Needs Closure), 0-tasks-0-ACs (shown in Planning)
 ACTIVE=$(jq -r '
-  .increments | to_entries[] |
-  select(.value.status == "active" or .value.status == "planning" or .value.status == "planned") |
-  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)|\(.value.acs.completed)|\(.value.acs.total)|\(.value.status)|\(.value.priority)|\(.value.type)"
+  [.increments | to_entries[] |
+   select((.value.status == "active" or .value.status == "planning" or .value.status == "planned") and
+          (.value.tasks.total > 0 or .value.acs.total > 0) and
+          ((.value.tasks.total == 0) or (.value.tasks.completed < .value.tasks.total)))] |
+  sort_by(.value.lastActivityEpoch // 0) | reverse | .[] |
+  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)|\(.value.acs.completed)|\(.value.acs.total)|\(.value.status)|\(.value.priority)"
 ' "$CACHE_FILE" 2>/dev/null)
 
 ACTIVE_COUNT=0
 if [[ -n "$ACTIVE" ]]; then
   echo "🔄 Active:"
-  while IFS='|' read -r id completed total ac_completed ac_total inc_status priority inc_type; do
+  while IFS='|' read -r id completed total ac_completed ac_total inc_status priority; do
     [[ -z "$id" ]] && continue
     ACTIVE_COUNT=$((ACTIVE_COUNT + 1))
     if [[ "$total" -gt 0 ]]; then
@@ -232,37 +289,57 @@ if [[ -n "$ACTIVE" ]]; then
     else
       pct=0
     fi
-    if [[ "$ac_total" -gt 0 ]]; then
-      ac_pct=$((ac_completed * 100 / ac_total))
-    else
-      ac_pct=0
-    fi
     bar=$(progress_bar "$pct" 12)
-    # Format priority badge
     pri_badge=""
     case "$priority" in P0|critical) pri_badge="🔴" ;; P1|high) pri_badge="🟠" ;; esac
-    # Show status indicator if planning
     status_indicator=""
     case "$inc_status" in
       planning|planned) status_indicator=" (📝 planning)" ;;
     esac
+    ac_info=""
+    if [[ "$ac_total" -gt 0 ]]; then
+      ac_pct=$((ac_completed * 100 / ac_total))
+      ac_info=" | $ac_completed/$ac_total ACs ($ac_pct%)"
+    fi
     echo "  $pri_badge $id$status_indicator"
-    echo "     $bar $completed/$total tasks | $ac_completed/$ac_total ACs ($ac_pct%)"
+    echo "     $bar $completed/$total tasks$ac_info"
   done <<< "$ACTIVE"
   echo ""
 fi
 
-# Get backlog increments (separate from active)
-BACKLOG=$(jq -r '
+# ── Section 4: Planning (no tasks yet) — collapsed single line ──
+EMPTY_ACTIVE=$(jq -r '
   .increments | to_entries[] |
-  select(.value.status == "backlog") |
-  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)|\(.value.acs.completed)|\(.value.acs.total)|\(.value.priority)"
+  select((.value.status == "active" or .value.status == "planning" or .value.status == "planned") and
+         .value.tasks.total == 0 and .value.acs.total == 0) |
+  .key
+' "$CACHE_FILE" 2>/dev/null)
+
+EMPTY_COUNT=0
+if [[ -n "$EMPTY_ACTIVE" ]]; then
+  EMPTY_LIST=""
+  while IFS= read -r id; do
+    [[ -z "$id" ]] && continue
+    EMPTY_COUNT=$((EMPTY_COUNT + 1))
+    [[ -n "$EMPTY_LIST" ]] && EMPTY_LIST="$EMPTY_LIST, "
+    EMPTY_LIST="$EMPTY_LIST$id"
+  done <<< "$EMPTY_ACTIVE"
+  echo "📝 Planning (no tasks): $EMPTY_LIST"
+  echo ""
+fi
+
+# ── Section 5: Backlog ──
+BACKLOG=$(jq -r '
+  [.increments | to_entries[] |
+   select(.value.status == "backlog")] |
+  sort_by(.value.lastActivityEpoch // 0) | reverse | .[] |
+  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)|\(.value.priority)"
 ' "$CACHE_FILE" 2>/dev/null)
 
 BACKLOG_COUNT=0
 if [[ -n "$BACKLOG" ]]; then
   echo "📋 Backlog:"
-  while IFS='|' read -r id completed total ac_completed ac_total priority; do
+  while IFS='|' read -r id completed total priority; do
     [[ -z "$id" ]] && continue
     BACKLOG_COUNT=$((BACKLOG_COUNT + 1))
     if [[ "$total" -gt 0 ]]; then
@@ -270,7 +347,6 @@ if [[ -n "$BACKLOG" ]]; then
     else
       pct=0
     fi
-    # Format priority badge
     pri_badge=""
     case "$priority" in P0|critical) pri_badge="🔴" ;; P1|high) pri_badge="🟠" ;; esac
     echo "  $pri_badge $id - $pct% planned"
@@ -278,48 +354,46 @@ if [[ -n "$BACKLOG" ]]; then
   echo ""
 fi
 
-# Get paused increments
+# ── Section 6: Paused ──
 PAUSED=$(jq -r '
   .increments | to_entries[] |
   select(.value.status == "paused") |
-  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)|\(.value.acs.completed)|\(.value.acs.total)"
+  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)"
 ' "$CACHE_FILE" 2>/dev/null)
 
+PAUSED_COUNT=0
 if [[ -n "$PAUSED" ]]; then
-  PAUSED_COUNT=$(echo "$PAUSED" | wc -l | tr -d ' ')
+  while IFS='|' read -r id completed total; do
+    [[ -z "$id" ]] && continue
+    PAUSED_COUNT=$((PAUSED_COUNT + 1))
+  done <<< "$PAUSED"
   echo "⏸️  Paused ($PAUSED_COUNT):"
-  while IFS='|' read -r id completed total ac_completed ac_total; do
+  while IFS='|' read -r id completed total; do
     [[ -z "$id" ]] && continue
     if [[ "$total" -gt 0 ]]; then
       pct=$((completed * 100 / total))
     else
       pct=0
     fi
-    if [[ "$ac_total" -gt 0 ]]; then
-      ac_pct=$((ac_completed * 100 / ac_total))
-    else
-      ac_pct=0
-    fi
-    echo "  $id - $pct% tasks | $ac_pct% ACs"
+    echo "  $id - $pct% tasks"
   done <<< "$PAUSED"
   echo ""
 fi
 
-# Summary section
-if [[ "$REVIEW_COUNT" -gt 0 ]] || [[ "$ACTIVE_COUNT" -gt 0 ]] || [[ "$BACKLOG_COUNT" -gt 0 ]] || [[ -n "$PAUSED" ]]; then
-  # Has work - show summary
+# ── Summary ──
+TOTAL_ACTIONABLE=$((CLOSURE_COUNT + REVIEW_COUNT + ACTIVE_COUNT + EMPTY_COUNT + BACKLOG_COUNT + PAUSED_COUNT))
+if [[ "$TOTAL_ACTIONABLE" -gt 0 ]]; then
   echo "────────────────────────────────────────"
   SUMMARY_PARTS=()
+  [[ "$CLOSURE_COUNT" -gt 0 ]] && SUMMARY_PARTS+=("$CLOSURE_COUNT needs closure")
   [[ "$REVIEW_COUNT" -gt 0 ]] && SUMMARY_PARTS+=("$REVIEW_COUNT ready for review")
   [[ "$ACTIVE_COUNT" -gt 0 ]] && SUMMARY_PARTS+=("$ACTIVE_COUNT active")
+  [[ "$EMPTY_COUNT" -gt 0 ]] && SUMMARY_PARTS+=("$EMPTY_COUNT planning")
   [[ "$BACKLOG_COUNT" -gt 0 ]] && SUMMARY_PARTS+=("$BACKLOG_COUNT backlog")
-  PAUSED_COUNT=0
-  [[ -n "$PAUSED" ]] && PAUSED_COUNT=$(echo "$PAUSED" | grep -c '|' || echo 0)
   [[ "$PAUSED_COUNT" -gt 0 ]] && SUMMARY_PARTS+=("$PAUSED_COUNT paused")
 
   IFS=', '; echo "Summary: ${SUMMARY_PARTS[*]}"
 else
-  # No work in progress
   echo "No active increments."
   COMPLETED_COUNT=$(jq '.summary.completed // 0' "$CACHE_FILE")
   if [[ "$COMPLETED_COUNT" -gt 0 ]]; then
@@ -328,9 +402,11 @@ else
 fi
 
 echo ""
-if [[ "$REVIEW_COUNT" -gt 0 ]]; then
+if [[ "$CLOSURE_COUNT" -gt 0 ]]; then
+  echo "💡 Run /sw:done <id> to close completed increments"
+elif [[ "$REVIEW_COUNT" -gt 0 ]]; then
   echo "💡 Run /sw:done <id> to close reviewed increments"
-elif [[ "$ACTIVE_COUNT" -eq 0 ]]; then
+elif [[ "$ACTIVE_COUNT" -eq 0 ]] && [[ "$EMPTY_COUNT" -eq 0 ]]; then
   echo "💡 Run /sw:increment to start new work"
 else
   echo "💡 For details: /sw:progress <incrementId>"

package/plugins/specweave/scripts/rebuild-dashboard-cache.sh

@@ -151,12 +151,30 @@ for increment_dir in "$INCREMENTS_DIR"/[0-9]*/; do
     completed_acs="${completed_acs:-0}"
   fi
 
-  # Get last activity from file mtime
+  # Collect file mtimes for stale detection and lastActivity
+  meta_mtime=0
+  tasks_mtime=0
+  spec_mtime=0
+  if [[ "$(uname)" == "Darwin" ]]; then
+    [[ -f "$metadata_file" ]] && meta_mtime=$(stat -f "%m" "$metadata_file" 2>/dev/null || echo "0")
+    [[ -f "$tasks_file" ]] && tasks_mtime=$(stat -f "%m" "$tasks_file" 2>/dev/null || echo "0")
+    [[ -f "$spec_file" ]] && spec_mtime=$(stat -f "%m" "$spec_file" 2>/dev/null || echo "0")
+  else
+    [[ -f "$metadata_file" ]] && meta_mtime=$(stat -c "%Y" "$metadata_file" 2>/dev/null || echo "0")
+    [[ -f "$tasks_file" ]] && tasks_mtime=$(stat -c "%Y" "$tasks_file" 2>/dev/null || echo "0")
+    [[ -f "$spec_file" ]] && spec_mtime=$(stat -c "%Y" "$spec_file" 2>/dev/null || echo "0")
+  fi
+
+  # Derive lastActivity from MAX of all file mtimes (not just metadata.json)
+  max_mtime="$meta_mtime"
+  [[ "$tasks_mtime" -gt "$max_mtime" ]] && max_mtime="$tasks_mtime"
+  [[ "$spec_mtime" -gt "$max_mtime" ]] && max_mtime="$spec_mtime"
+
   last_activity=""
   if [[ "$(uname)" == "Darwin" ]]; then
-    last_activity=$(stat -f "%Sm" -t "%Y-%m-%dT%H:%M:%SZ" "$metadata_file" 2>/dev/null || echo "")
+    last_activity=$(date -u -r "$max_mtime" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || echo "")
   else
-    last_activity=$(stat -c "%y" "$metadata_file" 2>/dev/null | sed 's/ /T/' | cut -d. -f1)Z || echo ""
+    last_activity=$(date -u -d "@$max_mtime" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || echo "")
   fi
 
   # Build increment JSON
@@ -172,6 +190,7 @@ for increment_dir in "$INCREMENTS_DIR"/[0-9]*/; do
     --argjson completed_acs "$completed_acs" \
     --arg created_at "$created_at" \
     --arg last_activity "$last_activity" \
+    --argjson last_activity_epoch "$max_mtime" \
     --argjson user_stories "$user_stories" \
     '{
       status: $status,
@@ -183,26 +202,13 @@ for increment_dir in "$INCREMENTS_DIR"/[0-9]*/; do
       acs: { total: $total_acs, completed: $completed_acs },
       createdAt: $created_at,
       lastActivity: $last_activity,
+      lastActivityEpoch: $last_activity_epoch,
       userStories: $user_stories
     }')
 
   # Add to increments object
   increments_json=$(echo "$increments_json" | jq --arg id "$increment_id" --argjson inc "$increment_json" '.[$id] = $inc')
 
-  # Collect mtimes for stale detection
-  meta_mtime=0
-  tasks_mtime=0
-  spec_mtime=0
-  if [[ "$(uname)" == "Darwin" ]]; then
-    [[ -f "$metadata_file" ]] && meta_mtime=$(stat -f "%m" "$metadata_file" 2>/dev/null || echo "0")
-    [[ -f "$tasks_file" ]] && tasks_mtime=$(stat -f "%m" "$tasks_file" 2>/dev/null || echo "0")
-    [[ -f "$spec_file" ]] && spec_mtime=$(stat -f "%m" "$spec_file" 2>/dev/null || echo "0")
-  else
-    [[ -f "$metadata_file" ]] && meta_mtime=$(stat -c "%Y" "$metadata_file" 2>/dev/null || echo "0")
-    [[ -f "$tasks_file" ]] && tasks_mtime=$(stat -c "%Y" "$tasks_file" 2>/dev/null || echo "0")
-    [[ -f "$spec_file" ]] && spec_mtime=$(stat -c "%Y" "$spec_file" 2>/dev/null || echo "0")
-  fi
-
   mtimes_json=$(echo "$mtimes_json" | jq --arg id "$increment_id" \
     --argjson meta "$meta_mtime" \
     --argjson tasks "$tasks_mtime" \

package/plugins/specweave/skills/done/SKILL.md

@@ -43,10 +43,11 @@ If closing a SpecWeave framework increment, show post-closure reminders: update
 
 ### Step 3: Judge LLM Validation (MANDATORY)
 
-1. Invoke `Skill({ skill: "sw:judge-llm" })` with `--last-commit` (or `--staged`)
-2. Uses ultrathink extended thinking via separate Opus API call
-3. **APPROVED** -> continue | **CONCERNS** -> show, allow continuation | **REJECTED** -> STOP closure
-4. No ANTHROPIC_API_KEY -> falls back to pattern matching, does not block
+1. **Consent check first**: Judge-LLM uses the Anthropic API (costs extra). Check `externalModels` in config. If consent not granted, ask user or skip to pattern matching fallback. See `/sw:judge-llm` consent section for full flow.
+2. Invoke `Skill({ skill: "sw:judge-llm" })` with `--last-commit` (or `--staged`)
+3. Uses ultrathink extended thinking via separate Opus API call
+4. **APPROVED** -> continue | **CONCERNS** -> show, allow continuation | **REJECTED** -> STOP closure
+5. No ANTHROPIC_API_KEY or consent denied -> falls back to pattern matching, does not block
 
 ### Step 4: Status Validation
 

package/plugins/specweave/skills/judge-llm/SKILL.md

@@ -53,6 +53,24 @@ allowed-tools: Read, Grep, Glob, Bash
 /sw:judge-llm src/file.ts --verbose  # Show progress to console
 ```
 
+## External API Cost Consent (MANDATORY)
+
+**This skill uses the Anthropic API directly (NOT your Claude Code subscription).** Each evaluation costs approximately $0.01-0.05 depending on code size.
+
+**Before invoking the Anthropic API, you MUST check consent:**
+
+1. Read `.specweave/config.json` → check `externalModels.consent` field
+2. If `"always-allow"` → proceed silently
+3. If `"never"` → skip API call, use in-session ultrathink evaluation instead
+4. If `"ask"` (default):
+   - Check if `"anthropic"` is in `externalModels.allowedProviders`
+   - If YES → proceed silently (standing permission)
+   - If NO → **ASK USER**: "Judge-LLM will call the Anthropic API using your ANTHROPIC_API_KEY. This costs ~$0.01-0.05 per evaluation. Proceed? (yes/no/always)"
+     - "yes" → proceed this time only
+     - "no" → skip API call, use in-session ultrathink instead
+     - "always" → run: `grantStandingConsent('anthropic', projectRoot)` from `src/core/llm/consent.ts`, then proceed
+5. No `ANTHROPIC_API_KEY` set → falls back to pattern matching automatically (no cost, no consent needed)
+
 ## Workflow
 
 ### Step 1: Gather Input

package/plugins/specweave/skills/progress/SKILL.md

@@ -9,18 +9,16 @@ argument-hint: "[incrementId]"
 
 !`s="progress"; for d in .specweave/skill-memories .claude/skill-memories "$HOME/.claude/skill-memories"; do p="$d/$s.md"; [ -f "$p" ] && awk '/^## Learnings$/{ok=1;next}/^## /{ok=0}ok' "$p" && break; done 2>/dev/null; true`
 
-Shows detailed progress information for active increments including:
-- **Task completion** with progress bars
-- **Acceptance Criteria (AC)** completion percentages
-- **Priority** indicators (P0/P1/P2)
-- **Type** badges (feature/bug/hotfix/refactor)
-- **Status** grouping (ready for review → active → paused)
-
 ## Hook Execution (Default)
 
 This command is intercepted by the **UserPromptSubmit hook** for instant execution (<10ms). The hook reads from `.specweave/state/dashboard.json` cache.
 
-**No action needed** - the hook output appears automatically in `<system-reminder>` tags.
+**CRITICAL**: The hook output in `<system-reminder>` is ALREADY FORMATTED for the user. You MUST:
+1. Present the hook output VERBATIM — copy it exactly as-is
+2. Do NOT reformat into a markdown table
+3. Do NOT re-summarize or paraphrase the data
+4. Do NOT add interpretation unless the user asks a follow-up question
+5. If the user asks "what should I work on next?" THEN add recommendations
 
 ## CLI Fallback
 
@@ -30,24 +28,12 @@ If hook output isn't displayed (rare), execute:
 specweave status --verbose
 ```
 
-Note: The CLI command is `specweave status` (with `progress` as an alias).
-
 ## Arguments
 
 - `/sw:progress` - Show all active increments
 - `/sw:progress 0042` - Show specific increment details (partial ID match supported)
 
-## Data Shown
-
-| Field | Description |
-|-------|-------------|
-| Tasks | `X/Y (Z%)` with progress bar |
-| ACs | `A/B (C%)` acceptance criteria completion |
-| Priority | P0 (critical), P1 (high), P2 (normal) |
-| Type | feature, bug, hotfix, refactor, experiment |
-| Status | ready_for_review, active, planning, paused |
-
 ## Related Commands
 
-- `/sw:status` - Macro view (all increments grouped by status)
 - `/sw:done <id>` - Close increment after review
+- `/sw:increment` - Start new work