@pennyfarthing/core 11.1.0 → 11.2.0

package/pennyfarthing-dist/scripts/workflow/workflow-status.sh

@@ -1,161 +1,5 @@
 #!/bin/bash
-# Show current stepped workflow progress
-# Usage: .pennyfarthing/scripts/workflow/workflow-status.sh [name]
-#
-# If no name provided, shows status of active workflow session
-
-set -euo pipefail
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-WORKFLOWS_DIR="$PROJECT_ROOT/.pennyfarthing/workflows"
-SESSION_DIR="$PROJECT_ROOT/.session"
-
-if ! command -v yq &> /dev/null; then
-  echo "Error: yq is required but not installed"
-  echo "Install with: brew install yq"
-  exit 1
-fi
-
-WORKFLOW_NAME="${1:-}"
-
-# If no name, try to detect from session
-if [[ -z "$WORKFLOW_NAME" ]]; then
-  SESSION_FILE=$(find "$SESSION_DIR" -maxdepth 1 -name "*-workflow-session.md" 2>/dev/null | head -1)
-
-  if [[ -z "$SESSION_FILE" ]]; then
-    echo "# Workflow Status"
-    echo ""
-    echo "No active workflow session found."
-    echo ""
-    echo "Use \`/workflow start <name>\` to begin a new workflow."
-    exit 0
-  fi
-
-  WORKFLOW_NAME=$(grep -E "^\*\*Workflow:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/\*\*Workflow:\*\* //' | tr -d ' ')
-
-  if [[ -z "$WORKFLOW_NAME" ]]; then
-    WORKFLOW_NAME=$(basename "$SESSION_FILE" | sed 's/-workflow-session.md//')
-  fi
-else
-  SESSION_FILE="$SESSION_DIR/${WORKFLOW_NAME}-workflow-session.md"
-fi
-
-if [[ ! -f "$SESSION_FILE" ]]; then
-  echo "# Workflow Status: $WORKFLOW_NAME"
-  echo ""
-  echo "No session found for workflow '$WORKFLOW_NAME'"
-  echo ""
-  echo "Use \`/workflow start $WORKFLOW_NAME\` to begin."
-  exit 0
-fi
-
-# Find workflow file
-WORKFLOW_FILE=""
-if [[ -f "$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml" ]]; then
-  WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml"
-elif [[ -f "$WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml" ]]; then
-  WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml"
-fi
-
-WORKFLOW_DIR=$(dirname "$WORKFLOW_FILE")
-
-# Parse session state
-CURRENT_STEP=$(grep -E "^\- \*\*Current Step:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "1")
-MODE=$(grep -E "^\- \*\*Mode:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "create")
-STATUS=$(grep -E "^\- \*\*Status:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "in_progress")
-STARTED=$(grep -E "^\- \*\*Started:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "-")
-LAST_UPDATED=$(grep -E "^\- \*\*Last Updated:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "-")
-STEPS_COMPLETED=$(grep -E "^\- \*\*Steps Completed:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "[]")
-NOTES=$(grep -E "^\- \*\*Notes:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "-")
-
-# Get total steps from workflow
-if [[ -n "$WORKFLOW_FILE" && -f "$WORKFLOW_FILE" ]]; then
-  # Resolve steps path based on mode
-  MODE_PATH=$(yq eval ".workflow.modes.$MODE // \"\"" "$WORKFLOW_FILE")
-  if [[ -n "$MODE_PATH" && "$MODE_PATH" != "null" ]]; then
-    STEPS_PATH="$MODE_PATH"
-  else
-    STEPS_PATH=$(yq eval '.workflow.steps.path' "$WORKFLOW_FILE")
-  fi
-
-  # Resolve relative path
-  if [[ "$STEPS_PATH" == ./* ]]; then
-    STEPS_PATH="$WORKFLOW_DIR/${STEPS_PATH#./}"
-  elif [[ "$STEPS_PATH" != /* ]]; then
-    STEPS_PATH="$PROJECT_ROOT/$STEPS_PATH"
-  fi
-
-  STEP_COUNT=$(find "$STEPS_PATH" -maxdepth 1 -name "step-0*.md" -o -name "step-1*.md" 2>/dev/null | wc -l | tr -d ' ')
-  WORKFLOW_DESC=$(yq eval '.workflow.description' "$WORKFLOW_FILE" | head -1)
-else
-  STEP_COUNT="?"
-  WORKFLOW_DESC="-"
-fi
-
-# Calculate completion percentage
-COMPLETED_COUNT=$(echo "$STEPS_COMPLETED" | tr -cd ',' | wc -c | tr -d ' ')
-if [[ "$STEPS_COMPLETED" != "[]" && -n "$STEPS_COMPLETED" ]]; then
-  COMPLETED_COUNT=$((COMPLETED_COUNT + 1))
-fi
-
-if [[ "$STEP_COUNT" != "?" && "$STEP_COUNT" -gt 0 ]]; then
-  COMPLETION_PCT=$((COMPLETED_COUNT * 100 / STEP_COUNT))
-else
-  COMPLETION_PCT=0
-fi
-
-# Build progress bar
-BAR_WIDTH=20
-if [[ "$STEP_COUNT" != "?" && "$STEP_COUNT" -gt 0 ]]; then
-  FILLED=$((COMPLETION_PCT * BAR_WIDTH / 100))
-  EMPTY=$((BAR_WIDTH - FILLED))
-  PROGRESS_BAR=$(printf '%*s' "$FILLED" '' | tr ' ' '#')$(printf '%*s' "$EMPTY" '' | tr ' ' '-')
-else
-  PROGRESS_BAR=$(printf '%*s' "$BAR_WIDTH" '' | tr ' ' '?')
-fi
-
-# Status indicator
-case "$STATUS" in
-  completed)
-    STATUS_ICON="[COMPLETE]"
-    ;;
-  paused)
-    STATUS_ICON="[PAUSED]"
-    ;;
-  *)
-    STATUS_ICON="[IN PROGRESS]"
-    ;;
-esac
-
-# Output status
-echo "# Workflow Status: $WORKFLOW_NAME"
-echo ""
-echo "**Description:** $WORKFLOW_DESC"
-echo ""
-echo "## Progress"
-echo ""
-echo "\`\`\`"
-echo "[$PROGRESS_BAR] $COMPLETION_PCT%"
-echo "\`\`\`"
-echo ""
-echo "| Field | Value |"
-echo "|-------|-------|"
-echo "| Status | $STATUS_ICON |"
-echo "| Mode | $MODE |"
-echo "| Current Step | $CURRENT_STEP of $STEP_COUNT |"
-echo "| Completed | $COMPLETED_COUNT steps |"
-echo "| Steps Done | $STEPS_COMPLETED |"
-echo "| Started | $STARTED |"
-echo "| Last Updated | $LAST_UPDATED |"
-if [[ "$NOTES" != "-" ]]; then
-  echo "| Notes | $NOTES |"
-fi
-echo ""
-echo "**Session:** $SESSION_FILE"
-echo ""
-
-if [[ "$STATUS" != "completed" ]]; then
-  echo "**Next:** Use \`/workflow resume\` to continue from step $CURRENT_STEP"
-fi
+# DEPRECATED: Use `pf workflow status` instead.
+# This shim forwards to the Python CLI for backward compatibility.
+echo "Warning: workflow-status.sh is deprecated. Use: pf workflow status $*" >&2
+exec pf workflow status "$@"

package/pennyfarthing-dist/skills/pf-bc/usage.md

@@ -57,7 +57,7 @@ pf bc save <NAME> [--dry-run]
 | `NAME` | Yes | Layout name to save as |
 | `--dry-run` | No | Preview without making changes |
 
-Fetches the active layout from the running Cyclist/BikeRack server (checks `.bikerack-port` then `.cyclist-port`). Fails if no server is running.
+Fetches the active layout from the running Cyclist/BikeRack server (reads `.wheelhub-port`). Fails if no server is running.
 
 Output: `{"success": true, "name": "<name>", "panels": <count>}`
 

package/pennyfarthing-dist/skills/pf-jira/examples.md

@@ -129,11 +129,14 @@ pf jira reconcile --fix
 ## Sprint Management
 
 ```bash
+# Read sprint ID from current-sprint.yaml (never hardcode)
+SPRINT_ID=$(grep 'jira_sprint_id:' sprint/current-sprint.yaml | awk '{print $2}')
+
 # Add issue to sprint
-pf jira sprint add 276 MSSCI-11999
+pf jira sprint add "$SPRINT_ID" MSSCI-11999
 
 # Preview
-pf jira sprint add 276 MSSCI-11999 --dry-run
+pf jira sprint add "$SPRINT_ID" MSSCI-11999 --dry-run
 ```
 
 ## Common Workflows

package/pennyfarthing-dist/skills/pf-workflow/examples.md

@@ -4,19 +4,19 @@
 
 ```bash
 # List all available workflows
-.pennyfarthing/scripts/workflow/list-workflows.sh
+pf workflow list
 
 # Show TDD workflow details
-.pennyfarthing/scripts/workflow/show-workflow.sh tdd
+pf workflow show tdd
 
 # Show current session's workflow
-.pennyfarthing/scripts/workflow/show-workflow.sh
+pf workflow show
 
 # Show trivial workflow
-.pennyfarthing/scripts/workflow/show-workflow.sh trivial
+pf workflow show trivial
 ```
 
-## Checking State (Python CLI)
+## Checking State
 
 ```bash
 # Check current workflow state
@@ -31,6 +31,13 @@ pf workflow phase-check tdd review
 pf workflow phase-check trivial implement
 # Returns: dev
 
+# Get workflow type
+pf workflow type tdd
+# Returns: phased
+
+pf workflow type architecture
+# Returns: stepped
+
 # Emit handoff marker for Cyclist
 pf workflow handoff reviewer
 ```
@@ -39,40 +46,44 @@ pf workflow handoff reviewer
 
 ```bash
 # Start architecture workflow in create mode (default)
-.pennyfarthing/scripts/workflow/start-workflow.sh architecture
+pf workflow start architecture
 
 # Start in validate mode
-.pennyfarthing/scripts/workflow/start-workflow.sh architecture --mode validate
+pf workflow start architecture --mode validate
 
 # Check progress
-.pennyfarthing/scripts/workflow/workflow-status.sh
+pf workflow status
 
 # Resume after interruption
-.pennyfarthing/scripts/workflow/resume-workflow.sh
-.pennyfarthing/scripts/workflow/resume-workflow.sh architecture
+pf workflow resume
+pf workflow resume architecture
+
+# Complete current step and advance
+pf workflow complete-step
+pf workflow complete-step architecture --step 3
 ```
 
 ## Phase Repair
 
 ```bash
 # Preview phase fix
-.pennyfarthing/scripts/workflow/fix-session-phase.sh 56-1 review --dry-run
+pf workflow fix-phase 56-1 review --dry-run
 
 # Fix phase to review (after Dev completed)
-.pennyfarthing/scripts/workflow/fix-session-phase.sh 56-1 review
+pf workflow fix-phase 56-1 review
 
 # Fix phase to approved (after Reviewer approved)
-.pennyfarthing/scripts/workflow/fix-session-phase.sh 56-1 approved
+pf workflow fix-phase 56-1 approved
 
 # Using Jira key
-.pennyfarthing/scripts/workflow/fix-session-phase.sh MSSCI-12190 approved
+pf workflow fix-phase MSSCI-12190 approved
 ```
 
 ## Switching Workflow Mid-Session
 
 1. Verify the target workflow exists:
    ```bash
-   .pennyfarthing/scripts/workflow/show-workflow.sh trivial
+   pf workflow show trivial
    ```
 
 2. Edit the session file:
@@ -89,7 +100,7 @@ pf workflow handoff reviewer
 pf workflow check --json
 # Edit session to change workflow from trivial to tdd
 # Fix phase to match where you are
-.pennyfarthing/scripts/workflow/fix-session-phase.sh 56-1 red
+pf workflow fix-phase 56-1 red
 ```
 
 ### Agent activated on wrong phase

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

@@ -11,25 +11,22 @@ Pennyfarthing uses YAML-defined workflows to control agent sequences. The defaul
 
 ## Quick Reference
 
-### Shell Script Commands
-
-| Command | Script | Purpose |
-|---------|--------|---------|
-| `/pf-workflow` or `/pf-workflow list` | `.pennyfarthing/scripts/workflow/list-workflows.sh` | List all workflows |
-| `/pf-workflow show [name]` | `.pennyfarthing/scripts/workflow/show-workflow.sh [name]` | Show workflow details |
-| `/pf-workflow set <name>` | Edit session file `**Workflow:**` line | Switch workflow mid-session |
-| `/pf-workflow start <name>` | `.pennyfarthing/scripts/workflow/start-workflow.sh <name> [--mode M]` | Start stepped workflow |
-| `/pf-workflow resume [name]` | `.pennyfarthing/scripts/workflow/resume-workflow.sh [name]` | Resume interrupted workflow |
-| `/pf-workflow status` | `.pennyfarthing/scripts/workflow/workflow-status.sh` | Show stepped workflow progress |
-| `/pf-workflow fix-phase <id> <phase>` | `.pennyfarthing/scripts/workflow/fix-session-phase.sh <id> <phase> [--dry-run]` | Repair session phase |
-
 ### Python CLI Commands
 
 | Command | CLI | Purpose |
 |---------|-----|---------|
+| `/pf-workflow` or `/pf-workflow list` | `pf workflow list` | List all workflows |
+| `/pf-workflow show [name]` | `pf workflow show [name]` | Show workflow details |
+| `/pf-workflow set <name>` | Edit session file `**Workflow:**` line | Switch workflow mid-session |
+| `/pf-workflow start <name>` | `pf workflow start <name> [--mode M]` | Start stepped workflow |
+| `/pf-workflow resume [name]` | `pf workflow resume [name]` | Resume interrupted workflow |
+| `/pf-workflow status` | `pf workflow status` | Show stepped workflow progress |
+| `/pf-workflow fix-phase <id> <phase>` | `pf workflow fix-phase <id> <phase> [--dry-run]` | Repair session phase |
 | Check workflow state | `pf workflow check [--json]` | Current story, phase, state |
 | Check phase owner | `pf workflow phase-check <workflow> <phase>` | Which agent owns a phase |
+| Get workflow type | `pf workflow type <workflow>` | phased/stepped/procedural |
 | Emit handoff marker | `pf workflow handoff <next-agent>` | CYCLIST handoff marker |
+| Complete step | `pf workflow complete-step [name] [--step N]` | Advance stepped workflow |
 
 ### Built-in Workflows
 

package/pennyfarthing-dist/skills/pf-workflow/usage.md

@@ -1,11 +1,11 @@
 # Workflow — Detailed Usage
 
-## Shell Script Commands
+## Commands
 
 ### List Workflows
 
 ```bash
-.pennyfarthing/scripts/workflow/list-workflows.sh
+pf workflow list
 ```
 
 No arguments. Returns table of workflows with type, phases/steps count, modes, default flag, description.
@@ -13,7 +13,7 @@ No arguments. Returns table of workflows with type, phases/steps count, modes, d
 ### Show Workflow
 
 ```bash
-.pennyfarthing/scripts/workflow/show-workflow.sh [NAME]
+pf workflow show [NAME]
 ```
 
 | Arg | Required | Description |
@@ -31,7 +31,7 @@ Warning: Only do this when story requirements have fundamentally changed. Switch
 ### Start Stepped Workflow
 
 ```bash
-.pennyfarthing/scripts/workflow/start-workflow.sh <NAME> [--mode <MODE>]
+pf workflow start <NAME> [--mode <MODE>]
 ```
 
 | Arg/Option | Required | Description |
@@ -44,7 +44,7 @@ Creates a new session and begins at step 1.
 ### Resume Stepped Workflow
 
 ```bash
-.pennyfarthing/scripts/workflow/resume-workflow.sh [NAME]
+pf workflow resume [NAME]
 ```
 
 | Arg | Required | Description |
@@ -54,7 +54,7 @@ Creates a new session and begins at step 1.
 ### Workflow Status
 
 ```bash
-.pennyfarthing/scripts/workflow/workflow-status.sh
+pf workflow status
 ```
 
 No arguments. Shows current step, progress percentage, mode.
@@ -62,7 +62,7 @@ No arguments. Shows current step, progress percentage, mode.
 ### Fix Session Phase
 
 ```bash
-.pennyfarthing/scripts/workflow/fix-session-phase.sh <STORY_ID> <TARGET_PHASE> [--dry-run]
+pf workflow fix-phase <STORY_ID> <TARGET_PHASE> [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -80,9 +80,22 @@ Valid phases by workflow:
 
 Updates `**Phase:**` field, `**Phase Started:**` timestamp, and handoff history table.
 
+### Complete Step
+
+```bash
+pf workflow complete-step [NAME] [--step N]
+```
+
+| Arg/Option | Required | Description |
+|------------|----------|-------------|
+| `NAME` | No | Workflow name (auto-detects from session) |
+| `--step N` | No | Complete specific step number instead of current |
+
+Advances session: increments step, updates completed list, recalculates percentage.
+
 ---
 
-## Python CLI Commands
+## State & Phase Commands
 
 ### Check Workflow State
 
@@ -109,6 +122,18 @@ pf workflow phase-check <WORKFLOW_NAME> <PHASE>
 
 Returns the agent name that owns the phase.
 
+### Get Workflow Type
+
+```bash
+pf workflow type <WORKFLOW_NAME>
+```
+
+| Arg | Required | Description |
+|-----|----------|-------------|
+| `WORKFLOW_NAME` | Yes | Workflow name (e.g., `tdd`, `architecture`) |
+
+Returns `phased`, `stepped`, or `procedural`.
+
 ### Emit Handoff Marker
 
 ```bash

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

@@ -1,14 +1,23 @@
 # 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
+# When to use: Best for UI/UX-heavy stories where designer-architect pairing
+# shapes implementation. Use this instead of base bdd when the story involves
+# complex user flows, new component patterns, or cross-domain UI integration.
+#
+# Tandem pairings:
+#   - DESIGN phase: UX-Designer + Architect (file-watch) — Architect validates technical feasibility
+#   - RED phase: TEA + Dev (file-watch) — Dev provides implementation context for test strategy
+#   - GREEN phase: Dev + UX-Designer (file-watch) — UX-Designer ensures design fidelity
+#   - REVIEW phase: Reviewer + PM (file-watch) — PM validates business requirements
+#
+# Compared to base bdd: Adds tandem observers on every working phase.
+# Designer-developer pairing ensures UX intent survives implementation.
+#
+# Flow: SM → UX-Designer (+Architect) → TEA (+Dev) → Dev (+UX-Designer) → Reviewer (+PM) → SM
 
 workflow:
   name: bdd-tandem
-  description: BDD with full tandem chain across design, implementation, and review
+  description: BDD with full tandem chain — designer and architect consultation across phases
   version: "1.0.0"
 
   phases:
@@ -36,6 +45,9 @@ workflow:
         file: gates/tests-fail
         type: tests_fail
         condition: Behavior scenarios have test coverage
+      tandem:
+        partner: dev
+        scope: file-watch
 
     - name: green
       agent: dev

package/pennyfarthing-dist/workflows/git-cleanup/steps/step-01-analyze.md

@@ -32,7 +32,7 @@ Build a complete picture of uncommitted changes across ALL repos defined in `.cl
 **CRITICAL: Use the multi-repo script, not plain `git status`.**
 
 ```bash
-.pennyfarthing/scripts/git/git-status-all.sh
+pf git status
 ```
 
 This shows branch, staged/unstaged changes, and unpushed commits for **all repos** defined in the project configuration.

package/pennyfarthing-dist/workflows/git-cleanup/steps/step-04-verify.md

@@ -34,7 +34,7 @@ Git cleanup summary report including:
 ### 4.1 Final Git Status (All Repos)
 
 ```bash
-.pennyfarthing/scripts/git/git-status-all.sh
+pf git status
 ```
 
 Expected: Clean working directory in all repos, or only intentionally skipped files.

package/pennyfarthing-dist/workflows/git-cleanup/steps/step-05-complete.md

@@ -68,7 +68,7 @@ To run git-cleanup again:
 Or for a quick status check across all repos:
 
 ```bash
-.pennyfarthing/scripts/git/git-status-all.sh
+pf git status
 ```
 
 ---

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

@@ -0,0 +1,65 @@
+# Review Tandem Workflow - TDD with Focused Architectural Review
+#
+# When to use: Best for stories that primarily need architectural review during
+# the review phase. Use this for large refactors (10+ pts), cross-cutting
+# infrastructure changes, or stories where an architect audit catches issues
+# that a standard code review might miss.
+#
+# Tandem pairings:
+#   - REVIEW phase: Reviewer + Architect (file-watch) — Architect provides
+#     focused architectural audit alongside standard code review
+#
+# Compared to base tdd: Same phase flow, but adds architect consultation
+# during review only. Lighter than tdd-tandem (no tandem on red/green phases).
+#
+# Flow: SM → TEA → Dev → Reviewer (+Architect) → SM
+
+workflow:
+  name: review-tandem
+  description: TDD with tandem architect consultation on review phase
+  version: "1.0.0"
+
+  phases:
+    - name: setup
+      agent: sm
+      output: [session_file, branches, story_context]
+
+    - name: red
+      agent: tea
+      input: [session_file, story_context]
+      output: [failing_tests]
+      gate:
+        file: gates/tests-fail
+        type: tests_fail
+        condition: All acceptance criteria have test coverage
+
+    - name: green
+      agent: dev
+      input: [failing_tests, story_context]
+      output: [implementation, passing_tests]
+      gate:
+        file: gates/tests-pass
+        type: tests_pass
+        condition: All tests passing, no skipped tests
+
+    - name: review
+      agent: reviewer
+      input: [implementation, passing_tests]
+      output: [approval]
+      gate:
+        file: gates/approval
+        type: approval
+        condition: Code review approved, architecture validated
+      tandem:
+        partner: architect
+        scope: file-watch
+
+    - name: finish
+      agent: sm
+      input: [approval]
+      output: [archived_session, story_summary]
+
+  triggers:
+    tags: [review-tandem, tandem]
+    points:
+      min: 8

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

@@ -1,14 +1,22 @@
 # TDD Tandem Workflow - TDD with Full Tandem Chain
-# Extends standard TDD with tandem observers on every phase:
-#   - Architect backseats TEA during red phase
-#   - TEA backseats Dev during green phase
-#   - PM backseats Reviewer during review phase
 #
-# Flow: SM → TEA (+Architect) → Dev (+TEA) → Reviewer (+PM) → SM
+# When to use: Best for 5+ point feature stories where architectural alignment
+# during implementation provides high value. Use this instead of base tdd when
+# the story involves cross-cutting concerns, new patterns, or complex integrations.
+#
+# Tandem pairings:
+#   - RED phase: TEA + Architect (file-watch) — Architect reviews test strategy
+#   - GREEN phase: Dev + Architect (file-watch) — Architect guides implementation patterns
+#   - REVIEW phase: Reviewer + PM (file-watch) — PM validates business requirements
+#
+# Compared to base tdd: Adds tandem observers on every working phase.
+# The extra context from partner agents helps catch architectural drift early.
+#
+# Flow: SM → TEA (+Architect) → Dev (+Architect) → Reviewer (+PM) → SM
 
 workflow:
   name: tdd-tandem
-  description: TDD with full tandem chain across all phases
+  description: TDD with full tandem chain — architect and PM consultation across phases
   version: "2.0.0"
 
   phases:
@@ -37,7 +45,7 @@ workflow:
         type: tests_pass
         condition: All tests passing, no skipped tests
       tandem:
-        partner: tea
+        partner: architect
         scope: file-watch
 
     - name: review
@@ -60,5 +68,5 @@ workflow:
   triggers:
     tags: [tandem]
     points:
-      min: 3
+      min: 5
     default: false

package/pennyfarthing_scripts/CLAUDE.md

@@ -12,8 +12,9 @@ Python Click CLI for Pennyfarthing. Entry point: `pennyfarthing_scripts/cli.py`.
 | `pf bc` | Panel focus and layout management | `bc/cli.py` |
 | `pf validate` | Project validators | `validate/cli.py` |
 | `pf agent` | Agent session management | `cli.py` (inline) |
-| `pf workflow` | Workflow state and phase management | `cli.py` (inline) |
+| `pf workflow` | Workflow state and phase management | `workflow/cli.py` |
 | `pf bikerack` | BikeRack dashboard launcher | `bikerack/cli.py` |
+| `pf git` | Repository operations (status, branches, worktree, hooks) | `git_group/cli.py` |
 | `pf debug` | Analysis tools (hotspots, deadcode, healthscore) | `cli.py` (inline group) |
 
 ### Sugar Shortcuts
@@ -139,9 +140,17 @@ Options: `--session-id`, `--no-persona`, `--json`, `--minimal`, `--full`, `--qui
 
 | Command | Description | Source |
 |---------|-------------|--------|
-| `pf workflow check` | Current workflow state | `workflow.py` |
-| `pf workflow phase-check WORKFLOW PHASE` | Check phase owner | `workflow.py` |
-| `pf workflow handoff AGENT` | Emit handoff marker | `cli.py` (inline) |
+| `pf workflow check [--json]` | Current workflow state | `workflow/cli.py` |
+| `pf workflow phase-check WORKFLOW PHASE` | Check phase owner | `workflow/cli.py` |
+| `pf workflow handoff AGENT` | Emit handoff marker | `workflow/cli.py` |
+| `pf workflow type WORKFLOW` | Get workflow type (phased/stepped/procedural) | `workflow/cli.py` |
+| `pf workflow list` | List all available workflows | `workflow/cli.py` |
+| `pf workflow show [NAME]` | Show workflow details | `workflow/cli.py` |
+| `pf workflow start NAME [--mode M]` | Start stepped workflow | `workflow/cli.py` |
+| `pf workflow resume [NAME]` | Resume interrupted workflow | `workflow/cli.py` |
+| `pf workflow status [NAME]` | Show stepped workflow progress | `workflow/cli.py` |
+| `pf workflow fix-phase ID PHASE [--dry-run]` | Repair session phase | `workflow/cli.py` |
+| `pf workflow complete-step [NAME] [--step N]` | Complete current step | `workflow/cli.py` |
 
 ## pf bikerack
 
@@ -151,6 +160,19 @@ Options: `--session-id`, `--no-persona`, `--json`, `--minimal`, `--full`, `--qui
 | `pf bikerack stop` | Stop running instance | `bikerack/cli.py` |
 | `pf bikerack status` | Show running state | `bikerack/cli.py` |
 
+## pf git
+
+| Command | Description | Source |
+|---------|-------------|--------|
+| `pf git status [--brief]` | Check git status of all repos | `git/status_all.py` |
+| `pf git branches BRANCH [--repos all\|api\|ui]` | Create feature branches | `git/create_branches.py` |
+| `pf git cleanup` | Start git-cleanup workflow | `git_group/cli.py` |
+| `pf git worktree create NAME BRANCH` | Create worktree(s) | `git/worktree.py` |
+| `pf git worktree remove NAME` | Remove worktree | `git/worktree.py` |
+| `pf git worktree list` | List active worktrees | `git/worktree.py` |
+| `pf git worktree status` | Show worktree status | `git/worktree.py` |
+| `pf git install-hooks` | Install git hooks with .d/ dispatcher | `git/hooks_installer.py` |
+
 ## pf debug
 
 | Command | Description | Source |