@leeovery/claude-technical-workflows 2.1.24 → 2.1.26

package/skills/status/scripts/discovery.sh

@@ -0,0 +1,420 @@
+#!/bin/bash
+#
+# Discovers the full workflow state across all phases
+# for the /status command.
+#
+# Outputs structured YAML that the command can consume directly.
+#
+
+set -eo pipefail
+
+RESEARCH_DIR="docs/workflow/research"
+DISCUSSION_DIR="docs/workflow/discussion"
+SPEC_DIR="docs/workflow/specification"
+PLAN_DIR="docs/workflow/planning"
+IMPL_DIR="docs/workflow/implementation"
+
+# Helper: Extract a frontmatter field value from a file
+# Usage: extract_field <file> <field_name>
+extract_field() {
+    local file="$1"
+    local field="$2"
+    local value=""
+
+    if head -1 "$file" 2>/dev/null | grep -q "^---$"; then
+        value=$(sed -n '2,/^---$/p' "$file" 2>/dev/null | \
+            grep -i -m1 "^${field}:" | \
+            sed -E "s/^${field}:[[:space:]]*//i" || true)
+    fi
+
+    echo "$value"
+}
+
+# Helper: Extract frontmatter content (between first pair of --- delimiters)
+extract_frontmatter() {
+    local file="$1"
+    awk 'BEGIN{c=0} /^---$/{c++; if(c==2) exit; next} c==1{print}' "$file" 2>/dev/null
+}
+
+# Helper: Extract sources from specification frontmatter
+# Outputs: name|status per line (object format only; legacy converted by migration 004)
+extract_sources() {
+    local file="$1"
+    local in_sources=false
+    local current_name=""
+    local current_status=""
+
+    while IFS= read -r line; do
+        if [[ "$line" =~ ^sources: ]]; then
+            in_sources=true
+            continue
+        fi
+
+        if $in_sources && [[ "$line" =~ ^[a-z_]+: ]] && [[ ! "$line" =~ ^[[:space:]] ]]; then
+            if [ -n "$current_name" ]; then
+                echo "${current_name}|${current_status:-incorporated}"
+            fi
+            break
+        fi
+
+        if $in_sources; then
+            if [[ "$line" =~ ^[[:space:]]*-[[:space:]]*name:[[:space:]]*(.+)$ ]]; then
+                if [ -n "$current_name" ]; then
+                    echo "${current_name}|${current_status:-incorporated}"
+                fi
+                current_name="${BASH_REMATCH[1]}"
+                current_name=$(echo "$current_name" | sed 's/^"//' | sed 's/"$//' | xargs)
+                current_status=""
+            elif [[ "$line" =~ ^[[:space:]]*status:[[:space:]]*(.+)$ ]]; then
+                current_status="${BASH_REMATCH[1]}"
+                current_status=$(echo "$current_status" | sed 's/^"//' | sed 's/"$//' | xargs)
+            fi
+        fi
+    done < <(extract_frontmatter "$file")
+
+    if [ -n "$current_name" ]; then
+        echo "${current_name}|${current_status:-incorporated}"
+    fi
+}
+
+# Helper: Extract external_dependencies from plan frontmatter
+# Outputs: topic|state|task_id per line
+extract_external_deps() {
+    local file="$1"
+    local frontmatter
+    frontmatter=$(extract_frontmatter "$file")
+
+    if ! echo "$frontmatter" | grep -q "^external_dependencies:" 2>/dev/null; then
+        return 0
+    fi
+
+    if echo "$frontmatter" | grep -q "^external_dependencies:[[:space:]]*\[\]" 2>/dev/null; then
+        return 0
+    fi
+
+    echo "$frontmatter" | awk '
+/^external_dependencies:/ { in_block=1; next }
+in_block && /^[a-z_]+:/ && !/^[[:space:]]/ { exit }
+in_block && /^[[:space:]]*- topic:/ {
+    if (topic != "") print topic "|" state "|" task_id
+    line=$0; gsub(/^[[:space:]]*- topic:[[:space:]]*/, "", line)
+    topic=line; state=""; task_id=""
+    next
+}
+in_block && /^[[:space:]]*state:/ {
+    line=$0; gsub(/^[[:space:]]*state:[[:space:]]*/, "", line)
+    state=line; next
+}
+in_block && /^[[:space:]]*task_id:/ {
+    line=$0; gsub(/^[[:space:]]*task_id:[[:space:]]*/, "", line)
+    task_id=line; next
+}
+END { if (topic != "") print topic "|" state "|" task_id }
+'
+}
+
+# Helper: Count completed tasks from implementation tracking
+count_completed_tasks() {
+    local file="$1"
+    local frontmatter
+    frontmatter=$(extract_frontmatter "$file")
+
+    if echo "$frontmatter" | grep -q "^completed_tasks:[[:space:]]*\[\]" 2>/dev/null; then
+        echo 0
+        return
+    fi
+
+    local count
+    count=$(echo "$frontmatter" | awk '
+/^completed_tasks:/ { in_block=1; next }
+in_block && /^[a-z_]+:/ { exit }
+in_block && /^[[:space:]]*-[[:space:]]/ { c++ }
+END { print c+0 }
+')
+    echo "$count"
+}
+
+# Helper: Count completed phases from implementation tracking
+count_completed_phases() {
+    local file="$1"
+    local frontmatter
+    frontmatter=$(extract_frontmatter "$file")
+
+    # Handle inline array format: [1, 2, 3]
+    local inline
+    inline=$(echo "$frontmatter" | grep "^completed_phases:" | sed 's/^completed_phases:[[:space:]]*//' || true)
+    if echo "$inline" | grep -q '^\['; then
+        local items
+        items=$(echo "$inline" | tr -d '[]' | tr ',' '\n' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//' | grep -v '^$')
+        if [ -n "$items" ]; then
+            echo "$items" | wc -l | tr -d ' '
+        else
+            echo 0
+        fi
+        return
+    fi
+
+    if echo "$frontmatter" | grep -q "^completed_phases:[[:space:]]*\[\]" 2>/dev/null; then
+        echo 0
+        return
+    fi
+
+    local count
+    count=$(echo "$frontmatter" | awk '
+/^completed_phases:/ { in_block=1; next }
+in_block && /^[a-z_]+:/ { exit }
+in_block && /^[[:space:]]*-[[:space:]]/ { c++ }
+END { print c+0 }
+')
+    echo "$count"
+}
+
+
+# Start YAML output
+echo "# Workflow Status Discovery"
+echo "# Generated: $(date -Iseconds)"
+echo ""
+
+#
+# RESEARCH
+#
+echo "research:"
+
+research_count=0
+if [ -d "$RESEARCH_DIR" ] && [ -n "$(ls -A "$RESEARCH_DIR" 2>/dev/null)" ]; then
+    echo "  exists: true"
+    echo "  files:"
+    for file in "$RESEARCH_DIR"/*; do
+        [ -f "$file" ] || continue
+        name=$(basename "$file" .md)
+        echo "    - \"$name\""
+        research_count=$((research_count + 1))
+    done
+    echo "  count: $research_count"
+else
+    echo "  exists: false"
+    echo "  files: []"
+    echo "  count: 0"
+fi
+
+echo ""
+
+#
+# DISCUSSIONS
+#
+echo "discussions:"
+
+disc_count=0
+disc_concluded=0
+disc_in_progress=0
+
+if [ -d "$DISCUSSION_DIR" ] && [ -n "$(ls -A "$DISCUSSION_DIR" 2>/dev/null)" ]; then
+    echo "  exists: true"
+    echo "  files:"
+    for file in "$DISCUSSION_DIR"/*.md; do
+        [ -f "$file" ] || continue
+        name=$(basename "$file" .md)
+        status=$(extract_field "$file" "status")
+        status=${status:-"unknown"}
+
+        echo "    - name: \"$name\""
+        echo "      status: \"$status\""
+
+        disc_count=$((disc_count + 1))
+        [ "$status" = "concluded" ] && disc_concluded=$((disc_concluded + 1))
+        [ "$status" = "in-progress" ] && disc_in_progress=$((disc_in_progress + 1))
+    done
+    echo "  count: $disc_count"
+    echo "  concluded: $disc_concluded"
+    echo "  in_progress: $disc_in_progress"
+else
+    echo "  exists: false"
+    echo "  files: []"
+    echo "  count: 0"
+    echo "  concluded: 0"
+    echo "  in_progress: 0"
+fi
+
+echo ""
+
+#
+# SPECIFICATIONS
+#
+echo "specifications:"
+
+spec_count=0
+spec_active=0
+spec_superseded=0
+spec_feature=0
+spec_crosscutting=0
+
+if [ -d "$SPEC_DIR" ] && [ -n "$(ls -A "$SPEC_DIR" 2>/dev/null)" ]; then
+    echo "  exists: true"
+    echo "  files:"
+    for file in "$SPEC_DIR"/*.md; do
+        [ -f "$file" ] || continue
+        name=$(basename "$file" .md)
+        status=$(extract_field "$file" "status")
+        status=${status:-"in-progress"}
+        spec_type=$(extract_field "$file" "type")
+        spec_type=${spec_type:-"feature"}
+        superseded_by=$(extract_field "$file" "superseded_by")
+
+        echo "    - name: \"$name\""
+        echo "      status: \"$status\""
+        echo "      type: \"$spec_type\""
+        [ -n "$superseded_by" ] && echo "      superseded_by: \"$superseded_by\""
+
+        # Sources
+        sources_output=$(extract_sources "$file")
+        if [ -n "$sources_output" ]; then
+            echo "      sources:"
+            while IFS='|' read -r src_name src_status; do
+                [ -z "$src_name" ] && continue
+                echo "        - name: \"$src_name\""
+                echo "          status: \"$src_status\""
+            done <<< "$sources_output"
+        else
+            echo "      sources: []"
+        fi
+
+        spec_count=$((spec_count + 1))
+        if [ "$status" = "superseded" ]; then
+            spec_superseded=$((spec_superseded + 1))
+        else
+            spec_active=$((spec_active + 1))
+            [ "$spec_type" = "cross-cutting" ] && spec_crosscutting=$((spec_crosscutting + 1))
+            [ "$spec_type" != "cross-cutting" ] && spec_feature=$((spec_feature + 1))
+        fi
+    done
+    echo "  count: $spec_count"
+    echo "  active: $spec_active"
+    echo "  superseded: $spec_superseded"
+    echo "  feature: $spec_feature"
+    echo "  crosscutting: $spec_crosscutting"
+else
+    echo "  exists: false"
+    echo "  files: []"
+    echo "  count: 0"
+    echo "  active: 0"
+    echo "  superseded: 0"
+    echo "  feature: 0"
+    echo "  crosscutting: 0"
+fi
+
+echo ""
+
+#
+# PLANS
+#
+echo "plans:"
+
+plan_count=0
+plan_concluded=0
+plan_in_progress=0
+
+if [ -d "$PLAN_DIR" ] && [ -n "$(ls -A "$PLAN_DIR" 2>/dev/null)" ]; then
+    echo "  exists: true"
+    echo "  files:"
+    for file in "$PLAN_DIR"/*.md; do
+        [ -f "$file" ] || continue
+        name=$(basename "$file" .md)
+        status=$(extract_field "$file" "status")
+        status=${status:-"unknown"}
+        format=$(extract_field "$file" "format")
+        format=${format:-"unknown"}
+        specification=$(extract_field "$file" "specification")
+        specification=${specification:-"${name}.md"}
+
+        echo "    - name: \"$name\""
+        echo "      status: \"$status\""
+        echo "      format: \"$format\""
+        echo "      specification: \"$specification\""
+
+        # External dependencies
+        deps_output=$(extract_external_deps "$file")
+        has_unresolved="false"
+        if [ -n "$deps_output" ]; then
+            echo "      external_deps:"
+            while IFS='|' read -r dep_topic dep_state dep_task_id; do
+                [ -z "$dep_topic" ] && continue
+                echo "        - topic: \"$dep_topic\""
+                echo "          state: \"$dep_state\""
+                [ -n "$dep_task_id" ] && echo "          task_id: \"$dep_task_id\""
+                [ "$dep_state" = "unresolved" ] && has_unresolved="true"
+            done <<< "$deps_output"
+        else
+            echo "      external_deps: []"
+        fi
+        echo "      has_unresolved_deps: $has_unresolved"
+
+        plan_count=$((plan_count + 1))
+        [ "$status" = "concluded" ] && plan_concluded=$((plan_concluded + 1))
+        { [ "$status" = "planning" ] || [ "$status" = "in-progress" ]; } && plan_in_progress=$((plan_in_progress + 1))
+    done
+    echo "  count: $plan_count"
+    echo "  concluded: $plan_concluded"
+    echo "  in_progress: $plan_in_progress"
+else
+    echo "  exists: false"
+    echo "  files: []"
+    echo "  count: 0"
+    echo "  concluded: 0"
+    echo "  in_progress: 0"
+fi
+
+echo ""
+
+#
+# IMPLEMENTATION
+#
+echo "implementation:"
+
+impl_count=0
+impl_completed=0
+impl_in_progress=0
+
+if [ -d "$IMPL_DIR" ] && [ -n "$(ls -A "$IMPL_DIR" 2>/dev/null)" ]; then
+    echo "  exists: true"
+    echo "  files:"
+    for file in "$IMPL_DIR"/*/tracking.md; do
+        [ -f "$file" ] || continue
+        topic=$(basename "$(dirname "$file")")
+        status=$(extract_field "$file" "status")
+        status=${status:-"unknown"}
+        current_phase=$(extract_field "$file" "current_phase")
+
+        completed_tasks=$(count_completed_tasks "$file")
+        completed_phases=$(count_completed_phases "$file")
+
+        # Count total tasks from plan directory (local-markdown format)
+        total_tasks=0
+        plan_file="$PLAN_DIR/${topic}.md"
+        if [ -f "$plan_file" ]; then
+            plan_format=$(extract_field "$plan_file" "format")
+            if [ "$plan_format" = "local-markdown" ] && [ -d "$PLAN_DIR/${topic}" ]; then
+                total_tasks=$(ls -1 "$PLAN_DIR/${topic}/"*.md 2>/dev/null | wc -l | tr -d ' ')
+            fi
+        fi
+
+        echo "    - topic: \"$topic\""
+        echo "      status: \"$status\""
+        [ -n "$current_phase" ] && [ "$current_phase" != "~" ] && echo "      current_phase: $current_phase"
+        echo "      completed_tasks: $completed_tasks"
+        echo "      completed_phases: $completed_phases"
+        echo "      total_tasks: $total_tasks"
+
+        impl_count=$((impl_count + 1))
+        [ "$status" = "completed" ] && impl_completed=$((impl_completed + 1))
+        [ "$status" = "in-progress" ] && impl_in_progress=$((impl_in_progress + 1))
+    done
+    echo "  count: $impl_count"
+    echo "  completed: $impl_completed"
+    echo "  in_progress: $impl_in_progress"
+else
+    echo "  exists: false"
+    echo "  files: []"
+    echo "  count: 0"
+    echo "  completed: 0"
+    echo "  in_progress: 0"
+fi

package/skills/technical-implementation/SKILL.md

@@ -166,6 +166,9 @@ Commit: `impl({topic}): start implementation`
 
 Present the existing configuration for confirmation:
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 Previous session used these project skills:
 - `{skill-name}` — {path}
 - ...
@@ -174,8 +177,7 @@ Previous session used these project skills:
 - **`y`/`yes`** — Keep these, proceed
 - **`c`/`change`** — Re-discover and choose skills
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user choice.
 
@@ -184,6 +186,8 @@ Previous session used these project skills:
 
 #### If `.claude/skills/` does not exist or is empty
 
+> *Output the next fenced block as a code block:*
+
 ```
 No project skills found. Proceeding without project-specific conventions.
 ```
@@ -194,6 +198,9 @@ No project skills found. Proceeding without project-specific conventions.
 
 Scan `.claude/skills/` for project-specific skill directories. Present findings:
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 Found these project skills that may be relevant to implementation:
 - `{skill-name}` — {brief description}
 - `{skill-name}` — {brief description}
@@ -204,8 +211,7 @@ Found these project skills that may be relevant to implementation:
 - **`n`/`none`** — Skip project skills
 - **Or list the ones you want** — e.g. "golang-pro, react-patterns"
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user to confirm which skills are relevant.
 
@@ -223,6 +229,9 @@ If `linters` is already populated in the tracking file, present the existing con
 
 Otherwise, present discovery findings to the user:
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 **Linter discovery:**
 - {tool} — `{command}` (installed / not installed)
 - ...
@@ -234,8 +243,7 @@ Recommendations: {any suggested tools with install commands}
 - **`c`/`change`** — Modify the linter list
 - **`s`/`skip`** — Skip linter setup (no linting during TDD)
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user choice.
 

package/skills/technical-implementation/references/steps/analysis-loop.md

@@ -32,12 +32,14 @@ If `analysis_cycle > 3`:
 
 Analysis has run {N-1} times so far. You can continue (recommended if issues were still found last cycle) or skip to completion.
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 - **`p`/`proceed`** — Continue analysis *(default)*
 - **`s`/`skip`** — Skip analysis, proceed to completion
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user choice. You MUST NOT choose on the user's behalf.
 
@@ -61,13 +63,15 @@ If there are unstaged changes or untracked files, categorize them:
 - `{file}` ({status: modified/untracked})
 - ...
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 - **`y`/`yes`** — Include all in the checkpoint commit
 - **`s`/`skip`** — Exclude unexpected files, commit only implementation files
 - **Comment** — Specify which to include
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user choice.
 
@@ -145,13 +149,15 @@ Sources: {sources}
 **Tests**:
 {tests}
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 - **`a`/`approve`** — Approve this task
 - **`s`/`skip`** — Skip this task
 - **Comment** — Revise based on feedback
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user input.
 

package/skills/technical-implementation/references/steps/task-loop.md

@@ -44,13 +44,15 @@ Present the executor's ISSUES to the user:
 
 {executor's ISSUES content}
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 - **`r`/`retry`** — Re-invoke the executor with your comments (provide below)
 - **`s`/`skip`** — Skip this task and move to the next
 - **`t`/`stop`** — Stop implementation entirely
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user choice.
 
@@ -103,14 +105,16 @@ Present the reviewer's findings and fix analysis to the user:
 Notes (non-blocking):
 {NOTES from reviewer}
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 - **`y`/`yes`** — Accept the review and fix analysis, pass to executor
 - **`a`/`auto`** — Accept and auto-approve future fix analyses
 - **`s`/`skip`** — Override the reviewer and proceed as-is
 - **Comment** — Any commentary, adjustments, alternative approaches, or questions before passing to executor
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user choice.
 
@@ -134,14 +138,16 @@ Present a summary and wait for user input:
 Phase: {phase number} — {phase name}
 {executor's SUMMARY — brief commentary, decisions, implementation notes}
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 **Options:**
 - **`y`/`yes`** — Approve, commit, continue to next task
 - **`a`/`auto`** — Approve this and all future reviewer-approved tasks automatically
 - **Comment** — Feedback the reviewer missed (triggers a fix round)
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user input.
 

package/skills/technical-planning/SKILL.md

@@ -84,12 +84,14 @@ Found existing plan for **{topic}** (previously reached phase {N}, task {M}).
 
 {spec change summary from spec-change-detection.md}
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 - **`c`/`continue`** — Walk through the plan from the start. You can review, amend, or navigate at any point — including straight to the leading edge.
 - **`r`/`restart`** — Erase all planning work for this topic and start fresh. This deletes the Plan Index File and any Authored Tasks. Other topics are unaffected.
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user response.
 
@@ -128,12 +130,14 @@ Present the recommendation:
 
 Existing plans use **{format}**. Use the same format for consistency?
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 - **`y`/`yes`** — Use {format}
 - **`n`/`no`** — See all available formats
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for user choice. If declined, fall through to the full list below.
 

package/skills/technical-planning/references/steps/analyze-task-graph.md

@@ -38,13 +38,15 @@ The natural task order is already correct. Present as rendered markdown (not in
 
 {notes from agent output}"
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 **To proceed:**
 - **`y`/`yes`** — Confirmed.
 - **Or tell me what to change.**
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for the user's response.
 
@@ -74,13 +76,15 @@ Dependencies and priorities have already been written to the task files. Present
 
 {any notes from agent output}"
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 **To proceed:**
 - **`y`/`yes`** — Approved.
 - **Or tell me what to change.**
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for the user's response.
 

package/skills/technical-planning/references/steps/author-tasks.md

@@ -31,14 +31,16 @@ After presenting, ask:
 
 **Task {M} of {total}: {Task Name}**
 
+> *Output the next fenced block as markdown (not a code block):*
+
+```
 · · · · · · · · · · · ·
 **To proceed:**
 - **`y`/`yes`** — Approved. I'll log it to the plan.
 - **Or tell me what to change.**
 - **Or navigate** — a different phase or task, or the leading edge.
 · · · · · · · · · · · ·
-
-**Do not wrap the above in a code block** — output as raw markdown so bold styling renders.
+```
 
 **STOP.** Wait for the user's response.