@pennyfarthing/core 10.1.0 → 10.3.0

package/pennyfarthing-dist/scripts/misc/statusline.sh

@@ -134,6 +134,39 @@ if [ -n "$config_file" ] && [ -n "$agent_name" ]; then
 fi
 theme_display="$character_display"
 
+# Tandem indicator: detect active backseat agent from observation files
+# Files: .session/{storyId}-tandem-{partner}.md (created by backseat spawn, cleaned on finish)
+tandem_partner=""
+tandem_partner_display=""
+if [ -d "$PROJECT_ROOT/.session" ]; then
+    tandem_file=$(find "$PROJECT_ROOT/.session" -maxdepth 1 -name "*-tandem-*.md" -print 2>/dev/null | head -1)
+    if [ -n "$tandem_file" ]; then
+        # Extract partner name from filename: {storyId}-tandem-{partner}.md
+        tandem_partner=$(basename "$tandem_file" | sed -n 's/.*-tandem-\([a-zA-Z_-]*\)\.md$/\1/p')
+        if [ -n "$tandem_partner" ] && [ -n "$theme_file" ] && [ -f "$theme_file" ]; then
+            # Look up partner's character name from theme
+            partner_full=$(yq ".agents.${tandem_partner}.character" "$theme_file" 2>/dev/null)
+            if [ -n "$partner_full" ] && [ "$partner_full" != "null" ]; then
+                partner_clean=$(echo "$partner_full" | sed 's/ *([^)]*)//g' | xargs)
+                partner_clean=$(echo "$partner_clean" | sed -E 's/^(Captain|Lieutenant|Dr\.|Doc|Mr\.|Mrs\.|Ms\.|Admiral|Commander|Chief|Ensign|Translator|Agent|Colonel|Major|Sergeant|Professor|Lord|Lady|Sir|The) +//i')
+                partner_wc=$(echo "$partner_clean" | wc -w | tr -d ' ')
+                if [ "$partner_wc" -eq 1 ]; then
+                    tandem_partner_display="$partner_clean"
+                else
+                    tandem_partner_display=$(echo "$partner_clean" | awk '{print $NF}')
+                fi
+            fi
+            # Fallback to agent abbreviation if no theme character
+            if [ -z "$tandem_partner_display" ]; then
+                tandem_partner_display=$(get_agent_abbrev "$tandem_partner")
+            fi
+        elif [ -n "$tandem_partner" ]; then
+            # No theme file — use abbreviation
+            tandem_partner_display=$(get_agent_abbrev "$tandem_partner")
+        fi
+    fi
+fi
+
 # ANSI colors
 RESET=$'\033[0m'
 DIM=$'\033[2m'
@@ -214,20 +247,29 @@ repo_fmt=$(printf "%-14s" "$dir_name")
 branch_fmt=$(printf "%-12s" "${branch}${branch_dirty}")
 model_fmt=$(printf "%-10s" "$model")
 
-# Build agent display: [ROLE] Theme (role in reverse text with color)
+# Build tandem suffix: "+ Partner" when backseat agent is active
+tandem_suffix=""
+tandem_suffix_len=0
+if [ -n "$tandem_partner_display" ]; then
+    partner_color=$(get_agent_color "$tandem_partner")
+    tandem_suffix=" ${DIM}+${RESET} ${partner_color}${tandem_partner_display}${RESET}"
+    tandem_suffix_len=$((3 + ${#tandem_partner_display}))  # " + " + name
+fi
+
+# Build agent display: [ROLE] Theme (+ Partner) (role in reverse text with color)
 if [ -n "$agent_abbrev" ]; then
     agent_color=$(get_agent_color "$agent_name")
     # Role in reverse text with color, then theme
     if [ -n "$theme_display" ]; then
-        agent_section="${agent_color}${REVERSE} ${agent_abbrev} ${RESET} ${DIM}${theme_display}${RESET}"
-        # Pad to ~20 chars visual width (abbrev ~3 + spaces ~2 + theme ~10 = ~15, pad to 20)
-        pad_len=$((18 - ${#agent_abbrev} - ${#theme_display}))
+        agent_section="${agent_color}${REVERSE} ${agent_abbrev} ${RESET} ${DIM}${theme_display}${RESET}${tandem_suffix}"
+        # Pad to ~20 chars visual width (abbrev ~3 + spaces ~2 + theme ~10 + tandem = ~15+, pad to 20)
+        pad_len=$((18 - ${#agent_abbrev} - ${#theme_display} - tandem_suffix_len))
         [ "$pad_len" -lt 0 ] && pad_len=0
         padding=$(printf "%${pad_len}s" "")
         agent_section="${agent_section}${padding}"
     else
-        agent_section="${agent_color}${REVERSE} ${agent_abbrev} ${RESET}"
-        pad_len=$((17 - ${#agent_abbrev}))
+        agent_section="${agent_color}${REVERSE} ${agent_abbrev} ${RESET}${tandem_suffix}"
+        pad_len=$((17 - ${#agent_abbrev} - tandem_suffix_len))
         [ "$pad_len" -lt 0 ] && pad_len=0
         padding=$(printf "%${pad_len}s" "")
         agent_section="${agent_section}${padding}"
@@ -235,8 +277,8 @@ if [ -n "$agent_abbrev" ]; then
 else
     # No agent - just show theme if available
     if [ -n "$theme_display" ]; then
-        agent_section="${DIM}${theme_display}${RESET}"
-        pad_len=$((20 - ${#theme_display}))
+        agent_section="${DIM}${theme_display}${RESET}${tandem_suffix}"
+        pad_len=$((20 - ${#theme_display} - tandem_suffix_len))
         [ "$pad_len" -lt 0 ] && pad_len=0
         padding=$(printf "%${pad_len}s" "")
         agent_section="${agent_section}${padding}"

package/pennyfarthing-dist/scripts/portraits/generate-portraits.py

@@ -91,10 +91,10 @@ GUIDANCE_SCALE = 7.5
 # CLIP token limit - prompts are truncated beyond this
 CLIP_MAX_TOKENS = 77
 
-# Role order for the 10 agents
+# Role order for the 11 agents
 ROLES = [
     "orchestrator", "sm", "tea", "dev", "reviewer",
-    "architect", "pm", "tech-writer", "ux-designer", "devops"
+    "architect", "pm", "tech-writer", "ux-designer", "devops", "ba"
 ]
 
 # Default style suffix (visual description comes first for emphasis)

package/pennyfarthing-dist/scripts/validation/validate-agent-schema.sh

@@ -43,6 +43,7 @@ PRIMARY_AGENTS=(
     "devops.md"
     "tech-writer.md"
     "ux-designer.md"
+    "ba.md"
 )
 
 # Subagents (have YAML frontmatter, different schema)

package/pennyfarthing-dist/scripts/workflow/README.md

@@ -6,7 +6,7 @@ Scripts for workflow mechanics, phase transitions, and quality gates.
 
 | Script | Purpose |
 |--------|---------|
-| `finish-story.sh` | Story completion workflow (archive, PR merge, Jira transition) |
+| `finish-story.sh` | **DEPRECATED** — forwards to `pf sprint story finish` |
 | `fix-session-phase.sh` | Repair session file phase state |
 | `check.sh` | Quality gates runner (lint, type check, tests) |
 | `list-workflows.sh` | List available workflows |
@@ -18,7 +18,7 @@ Scripts for workflow mechanics, phase transitions, and quality gates.
 ## Usage
 
 ```bash
-.pennyfarthing/scripts/workflow/finish-story.sh MSSCI-12345
+pf sprint story finish MSSCI-12345
 .pennyfarthing/scripts/workflow/start-workflow.sh prd --mode create
 ```
 

package/pennyfarthing-dist/scripts/workflow/finish-story.sh

@@ -1,199 +1,20 @@
 #!/bin/bash
-# Finish a story: archive, merge PR, transition Jira, update sprint YAML
-# Usage: finish-story.sh <story-id> [--dry-run]
-#
-# Example: finish-story.sh MSSCI-12052
-#          finish-story.sh MSSCI-12052 --dry-run
+# DEPRECATED: Use `pf sprint story finish` instead.
 #
-# Prerequisites:
-# - Session file exists at .session/{story-id}-session.md
-# - PR is approved and mergeable
-# - Reviewer has approved (phase: finish in session)
+# This shell script had a bug where yq paths targeted .epics[].stories[]
+# but the sprint YAML uses sharded epic files with .stories[] at root.
+# The Python implementation (pennyfarthing_scripts.sprint.story_finish)
+# correctly handles sharded YAML via read_sprint/write_sprint.
 #
-# This script performs:
-# 1. Archive session file to sprint/archive/{jira-key}-session.md
-# 2. Squash merge PR and delete remote branch
-# 3. Transition Jira to Done
-# 4. Update sprint YAML (status: done, completed date)
-# 5. Archive completed epics (if last story in epic was just finished)
-# 6. Clean up local branch and session file
+# Usage: finish-story.sh <story-id> [--dry-run]
 
 set -euo pipefail
 
-STORY_ID="${1:-}"
-DRY_RUN=false
+echo "DEPRECATED: finish-story.sh is deprecated. Forwarding to 'pf sprint story finish'." >&2
 
-# Parse options
+ARGS=()
 for arg in "$@"; do
-  case $arg in
-    --dry-run)
-      DRY_RUN=true
-      shift
-      ;;
-  esac
+  ARGS+=("$arg")
 done
 
-if [[ -z "$STORY_ID" ]]; then
-  echo "Usage: finish-story.sh <story-id> [--dry-run]"
-  echo ""
-  echo "Options:"
-  echo "  --dry-run    Show what would be done without executing"
-  exit 1
-fi
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-ARCHIVE_DIR="$PROJECT_ROOT/sprint/archive"
-
-# Ensure archive directory exists
-mkdir -p "$ARCHIVE_DIR"
-
-# Resolve session file: prefer Jira key, fall back to numeric story ID
-SESSION_FILE="$PROJECT_ROOT/.session/${STORY_ID}-session.md"
-if [[ ! -f "$SESSION_FILE" ]]; then
-  # Look up Jira key from sprint YAML and try that
-  _JIRA_LOOKUP=$(pf sprint story field "$STORY_ID" jira 2>/dev/null || echo "")
-  if [[ -n "$_JIRA_LOOKUP" && "$_JIRA_LOOKUP" != "null" ]]; then
-    ALT_SESSION="$PROJECT_ROOT/.session/${_JIRA_LOOKUP}-session.md"
-    if [[ -f "$ALT_SESSION" ]]; then
-      SESSION_FILE="$ALT_SESSION"
-    fi
-  fi
-fi
-
-# Also try the reverse: if called with Jira key, try numeric ID
-if [[ ! -f "$SESSION_FILE" ]]; then
-  # List session files and look for one containing the story ID
-  for f in "$PROJECT_ROOT/.session/"*-session.md; do
-    [[ -f "$f" ]] || continue
-    if grep -q "$STORY_ID" "$f" 2>/dev/null; then
-      SESSION_FILE="$f"
-      break
-    fi
-  done
-fi
-
-# Validate session file exists
-if [[ ! -f "$SESSION_FILE" ]]; then
-  echo "Error: Session file not found for story $STORY_ID"
-  echo "Looked for: $PROJECT_ROOT/.session/${STORY_ID}-session.md"
-  [[ -n "${_JIRA_LOOKUP:-}" ]] && echo "Also tried: $PROJECT_ROOT/.session/${_JIRA_LOOKUP}-session.md"
-  exit 1
-fi
-
-# Extract metadata from session file
-# Try **Jira:** field first (handle both "**Jira:**" and "- **Jira:**", markdown link format)
-JIRA_KEY=$(grep -E '\*\*Jira:\*\*' "$SESSION_FILE" | sed 's/.*\*\*Jira:\*\* //' | sed 's/\[//' | sed 's/\].*//' | tr -d ' ' || echo "")
-
-# Fallback: extract MSSCI key from **ID:** field (format: "MSSCI-14459 (81-2)" or just "MSSCI-14459")
-if [[ -z "$JIRA_KEY" || "$JIRA_KEY" == "null" ]]; then
-  JIRA_KEY=$(grep -E '\*\*ID:\*\*' "$SESSION_FILE" | grep -oE 'MSSCI-[0-9]+' | head -1 || echo "")
-fi
-
-# Fallback: if STORY_ID itself is a Jira key, use it directly
-if [[ -z "$JIRA_KEY" || "$JIRA_KEY" == "null" ]]; then
-  if [[ "$STORY_ID" =~ ^MSSCI-[0-9]+$ ]]; then
-    JIRA_KEY="$STORY_ID"
-  fi
-fi
-
-# Fallback: look up Jira key from sprint YAML via pf CLI
-if [[ -z "$JIRA_KEY" || "$JIRA_KEY" == "null" ]]; then
-  JIRA_KEY=$(pf sprint story field "$STORY_ID" jira 2>/dev/null || echo "")
-fi
-
-if [[ -z "$JIRA_KEY" || "$JIRA_KEY" == "null" ]]; then
-  echo "Error: Could not determine Jira key for story $STORY_ID"
-  echo "Check session file or sprint YAML for jira: field"
-  exit 1
-fi
-
-# Extract branch - strip any trailing annotations like "(pushed)"
-BRANCH=$(grep -E '\*\*Branch:\*\*' "$SESSION_FILE" | sed 's/.*\*\*Branch:\*\* //' | sed 's/ *(.*//' | tr -d ' ' || echo "")
-
-# Try to get PR number from session file first (format: **PR:** #422 - title)
-PR_NUMBER=$(grep -E '\*\*PR:\*\*' "$SESSION_FILE" | sed 's/.*#\([0-9]*\).*/\1/' || echo "")
-
-# Fallback: get PR number from GitHub if not in session file
-if [[ -z "$PR_NUMBER" ]] && [[ -n "$BRANCH" ]]; then
-  PR_NUMBER=$(gh pr list --head "$BRANCH" --json number --jq '.[0].number' 2>/dev/null || echo "")
-fi
-
-TODAY=$(date +%Y-%m-%d)
-
-echo "=== Finish Story: $STORY_ID ==="
-echo "Jira Key: $JIRA_KEY"
-echo "Branch: ${BRANCH:-none}"
-echo "PR: ${PR_NUMBER:-none}"
-echo ""
-
-if $DRY_RUN; then
-  echo "[DRY RUN] Would perform:"
-  echo "  1. Archive session → $ARCHIVE_DIR/${JIRA_KEY}-session.md"
-  if [[ -n "$PR_NUMBER" ]]; then
-    echo "  2. Merge PR #$PR_NUMBER (squash, delete branch)"
-  else
-    echo "  2. No PR to merge"
-  fi
-  echo "  3. Transition $JIRA_KEY to Done"
-  echo "  4. Update sprint YAML (status: done, completed: $TODAY)"
-  echo "  5. Archive any completed epics"
-  echo "  6. Delete local branch: $BRANCH"
-  echo "  7. Remove session file"
-  exit 0
-fi
-
-# Step 1: Archive session file
-echo "1. Archiving session file..."
-cp "$SESSION_FILE" "$ARCHIVE_DIR/${JIRA_KEY}-session.md"
-echo "   → $ARCHIVE_DIR/${JIRA_KEY}-session.md"
-
-# Step 2: Merge PR (if exists)
-if [[ -n "$PR_NUMBER" ]]; then
-  echo "2. Merging PR #$PR_NUMBER..."
-  gh pr merge "$PR_NUMBER" --squash --delete-branch || {
-    echo "   Warning: PR merge failed (may already be merged)"
-  }
-else
-  echo "2. No PR found for branch $BRANCH (skipping merge)"
-fi
-
-# Step 3: Transition Jira to Done
-echo "3. Transitioning Jira to Done..."
-jira issue move "$JIRA_KEY" "Done" 2>/dev/null || {
-  echo "   Warning: Jira transition failed (may already be Done)"
-}
-
-# Step 4: Update sprint YAML
-echo "4. Updating sprint YAML..."
-# Update status to done
-yq eval -i "(.epics[].stories[] | select(.id == \"$STORY_ID\")).status = \"done\"" "$SPRINT_FILE"
-# Add completed date
-yq eval -i "(.epics[].stories[] | select(.id == \"$STORY_ID\")).completed = \"$TODAY\"" "$SPRINT_FILE"
-# Remove assigned_to (no longer in progress)
-yq eval -i "del((.epics[].stories[] | select(.id == \"$STORY_ID\")).assigned_to)" "$SPRINT_FILE"
-echo "   → status: done, completed: $TODAY"
-
-# Step 5: Archive completed epics
-echo "5. Archiving completed epics..."
-pf sprint epic archive 2>/dev/null && echo "   → Checked for completed epics" || echo "   → No epics to archive"
-
-# Step 6: Clean up git
-echo "6. Cleaning up git..."
-git checkout develop 2>/dev/null || git checkout main 2>/dev/null || true
-git pull origin "$(git branch --show-current)" 2>/dev/null || true
-
-if [[ -n "$BRANCH" ]]; then
-  git branch -d "$BRANCH" 2>/dev/null || echo "   Local branch already deleted"
-fi
-
-# Step 7: Remove session file
-echo "7. Removing session file..."
-rm "$SESSION_FILE"
-
-echo ""
-echo "=== Story $STORY_ID Complete ==="
-echo "Archived: sprint/archive/${JIRA_KEY}-session.md"
-echo "Jira: https://1898andco.atlassian.net/browse/$JIRA_KEY"
+exec pf sprint story finish "${ARGS[@]}"

package/pennyfarthing-dist/skills/skill-registry.schema.json

@@ -98,6 +98,14 @@
           "type": "array",
           "items": { "type": "string" },
           "description": "Tools this skill is allowed to use. If omitted, all tools are allowed. Use to restrict read-only skills from writing."
+        },
+        "deprecated": {
+          "type": "boolean",
+          "description": "Whether this skill is deprecated"
+        },
+        "redirect": {
+          "type": "string",
+          "description": "Skill name to redirect to when deprecated"
         }
       },
       "required": ["name", "description", "category", "tags"],

package/pennyfarthing-dist/skills/skill-registry.yaml

@@ -386,7 +386,7 @@ skills:
     anti_patterns:
       - Don't switch workflows mid-story unless requirements fundamentally changed
     related_skills: [sprint]
-    keywords: [tdd, trivial, agent-docs, bdd, architecture, bikelane, stepped, phased]
+    keywords: [tdd, tdd-tandem, trivial, agent-docs, bdd, bdd-tandem, architecture, bikelane, stepped, phased]
 
   yq:
     name: yq

package/pennyfarthing-dist/skills/sprint/skill.md

@@ -293,7 +293,7 @@ pf sprint story add <epic-id> "<title>" <points> [options]
 | `points` | Yes | Story points (1, 2, 3, 5, 8) |
 | `--type` | No | Story type: feature, bug, chore, refactor (default: feature) |
 | `--priority` | No | Priority: P0, P1, P2, P3 (default: P1) |
-| `--workflow` | No | Workflow: tdd, trivial, bdd (default: tdd) |
+| `--workflow` | No | Workflow: tdd, tdd-tandem, trivial, bdd, bdd-tandem (default: tdd) |
 | `--jira` | No | Jira issue key |
 </args>
 
@@ -399,6 +399,28 @@ pf sprint story claim <story-id>
 
 ---
 
+### `/sprint story assign <story-id> <assignee>`
+
+Assign a Jira story to a user. Shortcut for `/jira assign`.
+
+<run>
+pf jira assign <story-id> <assignee>
+</run>
+
+<args>
+| Arg | Required | Description |
+|-----|----------|-------------|
+| `story-id` | Yes | Jira key (e.g., `MSSCI-14552`) |
+| `assignee` | Yes | Email or GitHub username (e.g., `keith.avery@1898andco.io`, `slabgorb`) |
+</args>
+
+<example>
+pf jira assign MSSCI-14552 keith.avery@1898andco.io
+pf jira assign MSSCI-14552 slabgorb
+</example>
+
+---
+
 ### `/sprint epic add <epic-id> <title> [options]`
 
 Add a new epic to the current sprint.
@@ -696,7 +718,7 @@ All gates must pass before handoff:
 | Sprint name | `"TO Sprint YYWW"` (e.g., "TO Sprint 2604") |
 | Story IDs | Jira keys `MSSCI-XXXXX` |
 | Status | `backlog`, `ready`, `in_progress`, `done` |
-| Workflow | `tdd`, `trivial`, `agent-docs`, `bdd` |
+| Workflow | `tdd`, `tdd-tandem`, `trivial`, `agent-docs`, `bdd`, `bdd-tandem` |
 | Priority | `P0`, `P1`, `P2`, `P3` |
 | in_sprint | `true`, `false` - Jira sprint membership |
 
@@ -761,6 +783,7 @@ For Jira integration, see `/jira` skill prerequisites.
 | `/sprint story template` | `pf sprint story template` |
 | `/sprint story finish ID` | `pf sprint story finish ID` |
 | `/sprint story claim ID` | `pf sprint story claim ID` |
+| `/sprint story assign ID USER` | `pf jira assign ID USER` |
 | `/sprint epic show ID` | `pf sprint epic show ID` |
 | `/sprint epic field ID FIELD` | `pf sprint epic field ID FIELD` |
 | `/sprint epic add ...` | `pf sprint epic add ...` |

package/pennyfarthing-dist/skills/theme/skill.md

@@ -181,7 +181,7 @@ Best for: Users who want to pick characters from suggestions.
 4. Preview and confirm
 5. Write theme file
 
-**Agent Order:** orchestrator, sm, tea, dev, reviewer, architect, pm, tech-writer, ux-designer, devops
+**Agent Order:** orchestrator, sm, tea, dev, reviewer, architect, pm, tech-writer, ux-designer, devops, ba
 
 ---
 

package/pennyfarthing-dist/skills/workflow/skill.md

@@ -163,6 +163,18 @@ SM → TEA → Dev → Reviewer → SM
 - Dev implements to make tests pass
 - **Triggers:** `types: [feature, enhancement]`, `points.min: 3`
 
+### TDD-Tandem (TDD with full tandem chain)
+
+```
+setup → red (+Architect) → green (+TEA) → review (+PM) → finish
+SM → TEA (+Architect) → Dev (+TEA) → Reviewer (+PM) → SM
+```
+
+- Full tandem chain: every phase has a backseat observer
+- Architect watches test design, TEA watches implementation, PM watches review
+- For high-stakes features needing cross-role visibility
+- **Triggers:** `tags: [tandem]`, `points.min: 3`
+
 ### Trivial (for 1-2 point fixes)
 
 ```
@@ -196,6 +208,17 @@ SM → UX-Designer → TEA → Dev → Reviewer → SM
 - For UI components and user-facing features
 - **Triggers:** `types: [ui, ux, behavior]`, `tags: [bdd, ux-first]`
 
+### BDD-Tandem (BDD with full tandem chain)
+
+```
+setup → design (+Architect) → red → green (+UX-Designer) → review (+PM) → finish
+SM → UX-Designer (+Architect) → TEA → Dev (+UX-Designer) → Reviewer (+PM) → SM
+```
+
+- Full tandem chain: Architect watches design, UX-Designer watches implementation, PM watches review
+- Everyone shares their cake — cross-role visibility at every phase
+- **Triggers:** `tags: [bdd-tandem, tandem, ux-first]`, `points.min: 3`
+
 ### Architecture (stepped workflow)
 
 ```
@@ -341,5 +364,5 @@ workflow:
 For comprehensive documentation on creating stepped workflows, see:
 
 - **[guides/bikelane.md](../../guides/bikelane.md)** - Full BikeLane user guide
-- **[docs/adr/0013-bmad-workflow-import.md](../../docs/adr/0013-bmad-workflow-import.md)** - Technical ADR
+- **ADR-0013: Stepped Workflow Support** - Technical ADR (see `docs/adr/0013-bmad-workflow-import.md` in framework repo)
 - **[pennyfarthing-dist/workflows/architecture.yaml](../../workflows/architecture.yaml)** - Example implementation

package/pennyfarthing-dist/workflows/architecture/workflow.yaml

@@ -0,0 +1,65 @@
+# Architecture Workflow - Migrated from BMAD format
+# Collaborative architectural decision-making with progressive disclosure
+#
+# Flow: Initialize → [Continue?] → Context → Patterns → Components → Interfaces → Risks → Document
+# Use for architectural decisions, system design, and technical planning
+#
+# BMAD Enhancements:
+# - Continuation handler (step-01b) for resuming workflows
+# - A/P/C menus: Advanced Elicitation, Party Mode, Continue
+# - Web search integration for current technology versions
+# - AI agent consistency focus in component and risk steps
+# - Pre-documentation validation checks
+
+workflow:
+  name: architecture
+  description: Collaborative architectural decision facilitation for AI-agent consistency. Produces a decision-focused architecture document optimized for preventing agent conflicts through step-by-step discovery with A/P/C collaboration menus.
+  version: "2.0.0"
+  type: stepped
+
+  # Step configuration
+  steps:
+    path: ./steps/
+    pattern: step-{nn}-*.md
+    # Note: step-01b-continue.md is loaded conditionally by step-01 when existing workflow detected
+
+  # Variables available in step files
+  variables:
+    project_root: .
+    planning_artifacts: sprint/planning/
+    output_file: sprint/planning/architecture.md
+    input_required:
+      - prd
+
+  # User approval gates - pause for confirmation at key decision points
+  # Steps with A/P/C menus naturally pause; these are the formal gates
+  gates:
+    after_steps: [2, 4, 6]
+    gate_marker: "<!-- GATE -->"
+
+  # Collaboration menus available in steps
+  collaboration:
+    menus:
+      - key: A
+        name: Advanced Elicitation
+        description: Use discovery protocols to develop deeper insights
+      - key: P
+        name: Party Mode
+        description: Bring multiple perspectives to analyze from different angles
+      - key: C
+        name: Continue
+        description: Save content and proceed to next step
+      - key: R
+        name: Revise
+        description: Need to gather more information or make changes
+
+  # Output template
+  template: ./templates/architecture-decision.md
+
+  # Agent assignment
+  agent: architect
+
+  # Triggers - when to suggest this workflow
+  triggers:
+    types: [architecture, design, adr, system-design]
+    tags: [architecture, stepped]

package/pennyfarthing-dist/workflows/architecture.yaml

@@ -26,8 +26,8 @@ workflow:
 
   # Variables available in step files
   variables:
-    output_file: planning-artifacts/architecture.md
-    planning_artifacts: planning-artifacts
+    output_file: sprint/planning/architecture.md
+    planning_artifacts: sprint/planning/
     input_required:
       - prd
 

package/pennyfarthing-dist/workflows/bdd-tandem.yaml

@@ -0,0 +1,70 @@
+# BDD Tandem Workflow - BDD with Full Tandem Chain
+# Extends standard BDD with tandem observers:
+#   - Architect backseats UX-Designer during design
+#   - UX-Designer backseats Dev during implementation
+#   - PM backseats Reviewer during review
+#
+# Flow: SM → UX-Designer (+Architect) → TEA → Dev (+UX-Designer) → Reviewer (+PM) → SM
+
+workflow:
+  name: bdd-tandem
+  description: BDD with full tandem chain across design, implementation, and review
+  version: "1.0.0"
+
+  phases:
+    - name: setup
+      agent: sm
+      output: [session_file, branches, story_context]
+
+    - name: design
+      agent: ux-designer
+      input: [session_file, story_context]
+      output: [design_spec, user_flows, wireframes, behavior_scenarios]
+      gate:
+        type: design_review
+        condition: UX spec defines user flows and acceptance behaviors
+      tandem:
+        partner: architect
+        scope: file-watch
+
+    - name: red
+      agent: tea
+      input: [design_spec, behavior_scenarios, story_context]
+      output: [failing_tests]
+      gate:
+        type: tests_fail
+        condition: Behavior scenarios have test coverage
+
+    - name: green
+      agent: dev
+      input: [failing_tests, design_spec, story_context]
+      output: [implementation, passing_tests]
+      gate:
+        type: tests_pass
+        condition: All tests passing, UX spec implemented
+      tandem:
+        partner: ux-designer
+        scope: file-watch
+
+    - name: review
+      agent: reviewer
+      input: [implementation, passing_tests, design_spec]
+      output: [approval]
+      gate:
+        type: approval
+        condition: Code review approved, UX requirements met
+      tandem:
+        partner: pm
+        scope: file-watch
+
+    - name: finish
+      agent: sm
+      input: [approval]
+      output: [archived_session, story_summary]
+
+  triggers:
+    types: [ui, ux, behavior, component, settings]
+    tags: [bdd-tandem, tandem, ux-first]
+    points:
+      min: 3
+    default: false

package/pennyfarthing-dist/workflows/epics-and-stories/workflow.yaml

@@ -16,8 +16,8 @@ workflow:
   # Variables available in step files
   variables:
     project_root: .
-    planning_artifacts: ./artifacts
-    output_file: artifacts/create-epics-and-stories.md
+    planning_artifacts: sprint/planning/
+    output_file: sprint/planning/create-epics-and-stories.md
 
   # Agent assignment (customize as needed)
   agent: architect

package/pennyfarthing-dist/workflows/implementation-readiness/workflow.yaml

@@ -28,8 +28,8 @@ workflow:
   # Variables available in step files
   variables:
     project_root: .
-    planning_artifacts: ./artifacts
-    output_file: artifacts/implementation-readiness-report.md
+    planning_artifacts: sprint/planning/
+    output_file: sprint/planning/implementation-readiness-report.md
 
   # Agent assignment - PM/SM role for adversarial review
   agent: sm

package/pennyfarthing-dist/workflows/prd/workflow.yaml

@@ -22,8 +22,8 @@ workflow:
   # Variables available in step files
   variables:
     project_root: .
-    planning_artifacts: ./artifacts
-    output_file: artifacts/prd.md
+    planning_artifacts: sprint/planning/
+    output_file: sprint/planning/prd.md
 
   # Gates - pause for user approval at key decision points
   gates:

package/pennyfarthing-dist/workflows/product-brief/workflow.yaml

@@ -16,8 +16,8 @@ workflow:
   # Variables available in step files
   variables:
     project_root: .
-    planning_artifacts: ./artifacts
-    output_file: artifacts/product-brief.md
+    planning_artifacts: sprint/planning/
+    output_file: sprint/planning/product-brief.md
 
   # Template for product brief output
   template: ./templates/product-brief.template.md