@leeovery/claude-technical-workflows 2.0.50 → 2.0.51

package/commands/workflow/start-planning.md

@@ -70,6 +70,7 @@ This outputs structured YAML. Parse it to understand:
 **From `plans` section:**
 - `exists` - whether any plans exist
 - `files` - each plan's name, format, status, and plan_id (if present)
+- `common_format` - the output format if all existing plans share the same one; empty string otherwise
 
 **From `state` section:**
 - `scenario` - one of: `"no_specs"`, `"nothing_actionable"`, `"has_options"`
@@ -255,6 +256,7 @@ Planning session for: {topic}
 Specification: docs/workflow/specification/{topic}.md
 Additional context: {summary of user's answers from Step 5}
 Cross-cutting references: {list of applicable cross-cutting specs with brief summaries, or "none"}
+Recommended output format: {common_format from discovery if non-empty, otherwise "none"}
 
 Invoke the technical-planning skill.
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leeovery/claude-technical-workflows",
-  "version": "2.0.50",
+  "version": "2.0.51",
   "description": "Technical workflow skills & commands for Claude Code",
   "license": "MIT",
   "author": "Lee Overy <me@leeovery.com>",

package/scripts/discovery-for-planning.sh

@@ -139,6 +139,9 @@ echo ""
 #
 echo "plans:"
 
+plan_format_seen=""
+plan_format_unanimous="true"
+
 if [ -d "$PLAN_DIR" ] && [ -n "$(ls -A "$PLAN_DIR" 2>/dev/null)" ]; then
     echo "  exists: true"
     echo "  files:"
@@ -149,6 +152,15 @@ if [ -d "$PLAN_DIR" ] && [ -n "$(ls -A "$PLAN_DIR" 2>/dev/null)" ]; then
         name=$(basename "$file" .md)
         format=$(extract_field "$file" "format")
         format=${format:-"MISSING"}
+
+        if [ "$format" != "MISSING" ]; then
+            if [ -z "$plan_format_seen" ]; then
+                plan_format_seen="$format"
+            elif [ "$plan_format_seen" != "$format" ]; then
+                plan_format_unanimous="false"
+            fi
+        fi
+
         status=$(extract_field "$file" "status")
         status=${status:-"unknown"}
         plan_id=$(extract_field "$file" "plan_id")
@@ -160,9 +172,16 @@ if [ -d "$PLAN_DIR" ] && [ -n "$(ls -A "$PLAN_DIR" 2>/dev/null)" ]; then
             echo "      plan_id: \"$plan_id\""
         fi
     done
+
+    if [ "$plan_format_unanimous" = "true" ] && [ -n "$plan_format_seen" ]; then
+        echo "  common_format: \"$plan_format_seen\""
+    else
+        echo "  common_format: \"\""
+    fi
 else
     echo "  exists: false"
     echo "  files: []"
+    echo "  common_format: \"\""
 fi
 
 echo ""

package/skills/technical-planning/SKILL.md

@@ -22,6 +22,7 @@ Either way: Transform specifications into actionable phases, tasks, and acceptan
 - **Specification content** (required) - The validated decisions and requirements to plan from
 - **Topic name** (optional) - Will derive from specification if not provided
 - **Output format preference** (optional) - Will ask if not specified
+- **Recommended output format** (optional) - A format suggestion for consistency with existing plans
 - **Cross-cutting references** (optional) - Cross-cutting specifications that inform technical decisions in this plan
 
 **Before proceeding**, verify the required input is available and unambiguous. If anything is missing or unclear, **STOP** — do not proceed until resolved.
@@ -97,7 +98,21 @@ Read **[output-formats.md](references/output-formats.md)**, find the entry match
 
 #### If no Plan Index File exists
 
-First, choose the Output Format. Present the formats from **[output-formats.md](references/output-formats.md)** to the user — including description, pros, cons, and "best for". Number each format and ask the user to pick.
+First, choose the Output Format.
+
+**If a recommended output format was provided** (non-empty, not "none"):
+
+Present the recommendation:
+
+> "Existing plans use **{format}**. Use the same format for consistency?
+> - **yes** — use {format}
+> - **no** — see all available formats"
+
+**STOP.** Wait for user choice. If declined, fall through to the full list below.
+
+**If no recommendation, or user declined:**
+
+Present the formats from **[output-formats.md](references/output-formats.md)** to the user — including description, pros, cons, and "best for". Number each format and ask the user to pick.
 
 **STOP.** Wait for the user to choose.