@pennyfarthing/core 10.0.3 → 10.1.0

package/pennyfarthing-dist/guides/prime.md

@@ -52,8 +52,8 @@ Prime selects a context tier based on session state to manage token overhead:
 ## Invocation
 
 ```bash
-# From agent commands (via CLI)
-python3 -m pennyfarthing_scripts.cli agent start "<agent>" --quiet
+# From agent commands (via pf CLI)
+pf agent start "<agent>" --quiet
 
 # TypeScript API (from Cyclist)
 getPrimeContext(agentName, projectDir)

package/pennyfarthing-dist/guides/skill-schema.md

@@ -146,7 +146,7 @@ args: "[arg1|arg2]"       # Optional: argument summary
 **Example:**
 ```xml
 <run>
-.pennyfarthing/scripts/sprint/sprint-status.sh [filter]
+pf sprint status [filter]
 </run>
 ```
 
@@ -195,7 +195,7 @@ args: "[arg1|arg2]"       # Optional: argument summary
 **Example:**
 ```xml
 <example>
-.pennyfarthing/scripts/sprint/check-story.sh MSSCI-12038
+pf sprint check MSSCI-12038
 # Returns: {"type": "story", "available": true, "title": "...", ...}
 </example>
 ```
@@ -272,68 +272,67 @@ Here's a well-structured skill file following the schema:
 
 ```markdown
 ---
-name: story
+name: sprint
 description: |
-  Story creation, sizing, and completion workflow. Use when creating new stories,
-  estimating points, or finishing completed work.
-args: "[create|size|finish]"
+  Sprint status, backlog, story, and epic management. Use when checking sprint
+  status, managing stories, or working with epics.
+args: "[status|backlog|work|story|epic|standalone]"
 ---
 
-# /story - Story Management
+# /sprint - Sprint Management
 
 <critical>
-All story operations require SM agent activation.
-**Never** create stories outside of sprint context.
+Never manually edit sprint YAML. Use the provided commands.
 </critical>
 
 ## Commands
 
-### `/story create <title>`
+### `/sprint story add <epic-id> "<title>" <points>`
 
-Create a new story in the current epic.
+Add a new story to an epic.
 
 <run>
-.pennyfarthing/scripts/story/create-story.sh "<title>"
+pf sprint story add <epic-id> "<title>" <points>
 </run>
 
 <args>
 | Arg | Required | Description |
 |-----|----------|-------------|
+| `epic-id` | Yes | Parent epic (e.g., `epic-76`) |
 | `title` | Yes | Story title (quoted if contains spaces) |
+| `points` | Yes | Story points |
 </args>
 
 <example>
-.pennyfarthing/scripts/story/create-story.sh "Add user authentication"
-# Returns: {"id": "36-5", "title": "Add user authentication", "status": "backlog"}
+pf sprint story add epic-76 "Add user authentication" 3
 </example>
 
 <output>
-JSON with new story ID, title, and initial status.
-Story is created in backlog status within the active epic.
+Confirmation with new story ID and details.
 </output>
 
 <when>
-After creating, use `/story size <id>` to estimate points.
+After creating, use `/sprint story size` for sizing guidelines.
 </when>
 
 ---
 
-### `/story finish <story-id>`
+### `/sprint story finish <story-id>`
 
 Complete a story after PR merge.
 
 <run>
-.pennyfarthing/scripts/story/finish-story.sh <story-id>
+pf sprint story finish <story-id>
 </run>
 
 <args>
 | Arg | Required | Description |
 |-----|----------|-------------|
-| `story-id` | Yes | Story to finish (e.g., `36-5`) |
+| `story-id` | Yes | Story to finish (e.g., `MSSCI-12052`) |
 </args>
 
 <example>
-.pennyfarthing/scripts/story/finish-story.sh 36-5
+pf sprint story finish MSSCI-12052
 # Archives story, updates Jira, cleans session files
 </example>
 
@@ -358,11 +357,11 @@ d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$
 
 ## Quick Reference
 
-| Command | Script |
-|---------|--------|
-| `/story create <title>` | `create-story.sh` |
-| `/story size <id>` | `size-story.sh` |
-| `/story finish <id>` | `finish-story.sh` |
+| Command | Script/CLI |
+|---------|------------|
+| `/sprint story add ...` | `sprint story add` |
+| `/sprint story size` | `sprint story size` |
+| `/sprint story finish <id>` | `sprint story finish` |
 
 ## Related Skills
 

package/pennyfarthing-dist/guides/xml-tags.md

@@ -447,7 +447,7 @@ Tags used in skill files (`skills/{name}/SKILL.md`) for command documentation.
 
 ```markdown
 <run>
-.pennyfarthing/scripts/sprint/sprint-status.sh [filter]
+pf sprint status [filter]
 </run>
 ```
 
@@ -473,7 +473,7 @@ Tags used in skill files (`skills/{name}/SKILL.md`) for command documentation.
 
 ```markdown
 <example>
-.pennyfarthing/scripts/sprint/check-story.sh MSSCI-12038
+pf sprint check MSSCI-12038
 # Returns: {"type": "story", "available": true}
 </example>
 ```

package/pennyfarthing-dist/scripts/README.md

@@ -8,7 +8,7 @@ Scripts are organized into categorical subdirectories. **Full paths are required
 scripts/
 ├── core/       # Essential scripts (agent-session.sh)
 ├── workflow/   # Workflow mechanics (finish-story.sh, check.sh)
-├── sprint/     # Sprint YAML operations (sprint-status.sh)
+├── sprint/     # Sprint YAML operations (migrated to pf sprint CLI)
 ├── story/      # Story operations (create-story.sh)
 ├── jira/       # Jira integration (jira-claim-story.sh)
 ├── git/        # Git operations (release.sh, worktree-manager.sh)
@@ -27,7 +27,7 @@ Scripts are invoked directly with **full category paths**:
 ```bash
 # From project root
 .pennyfarthing/scripts/core/agent-session.sh start sm
-.pennyfarthing/scripts/sprint/sprint-status.sh
+pf sprint status
 .pennyfarthing/scripts/jira/jira-claim-story.sh MSSCI-12345
 .pennyfarthing/scripts/workflow/finish-story.sh MSSCI-12345
 ```

package/pennyfarthing-dist/scripts/core/agent-session.sh

@@ -91,7 +91,7 @@ check_theme_version() {
     echo "" >&2
     echo "Warning: Theme '${theme_name}' was created with Pennyfarthing ${theme_version}" >&2
     echo "         Current version: ${current_version} - agent roles may have changed." >&2
-    echo "         Run '/theme-maker --update ${theme_name}' to review." >&2
+    echo "         Run '/theme maker' to review and update." >&2
     echo "" >&2
   fi
 
@@ -232,7 +232,11 @@ case "$1" in
       PRIME_ARGS+=(--no-persona)
     fi
 
-    python3 -m pennyfarthing_scripts.prime "${PRIME_ARGS[@]}"
+    if command -v pf &>/dev/null; then
+      pf prime "${PRIME_ARGS[@]}"
+    else
+      python3 -m pennyfarthing_scripts.prime "${PRIME_ARGS[@]}"
+    fi
     ;;
   stop)
     # Use provided session ID, fall back to SESSION_ID env var

package/pennyfarthing-dist/scripts/core/prime.sh

@@ -2,29 +2,27 @@
 # prime.sh - Load essential project context at agent activation
 # Usage: prime.sh [--minimal] [--full] [--quiet] [--agent <name>]
 #
-# Thin wrapper around python -m pennyfarthing_scripts.prime
+# Uses the `pf` CLI (installed via uv/pipx during pennyfarthing init).
+# Falls back to python3 -m with PYTHONPATH if pf is not available.
 
-# Find the package root (where pennyfarthing_scripts lives)
-# Works for both npm installs (node_modules/@pennyfarthing/core) and local dev
-# Use pwd -P to resolve symlinks in the path (handles symlinked parent dirs)
+# Prefer pf CLI if available
+if command -v pf &>/dev/null; then
+    exec pf prime "$@"
+fi
+
+# Fallback: find pennyfarthing_scripts via PYTHONPATH
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
 PACKAGE_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd -P)"
 
-# Fallback: if pennyfarthing_scripts not found at expected location,
-# look in node_modules (handles edge cases like stale copies)
 if [[ ! -d "$PACKAGE_ROOT/pennyfarthing_scripts" ]]; then
-    # Find project root by looking for .pennyfarthing marker
     PROJECT_ROOT="$PWD"
     while [[ ! -d "$PROJECT_ROOT/.pennyfarthing" ]] && [[ "$PROJECT_ROOT" != "/" ]]; do
         PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
     done
-    # Try node_modules location
     if [[ -d "$PROJECT_ROOT/node_modules/@pennyfarthing/core/pennyfarthing_scripts" ]]; then
         PACKAGE_ROOT="$PROJECT_ROOT/node_modules/@pennyfarthing/core"
     fi
 fi
 
-# Set PYTHONPATH so Python can find pennyfarthing_scripts
 export PYTHONPATH="${PACKAGE_ROOT}:${PYTHONPATH:-}"
-
 exec python3 -m pennyfarthing_scripts.prime "$@"

package/pennyfarthing-dist/scripts/git/git-status-all.sh

@@ -3,7 +3,7 @@
 # Usage: ./scripts/git-status-all.sh [--brief]
 #
 # Shows: branch, status, unpushed commits for all repos
-# Reads repo configuration from .claude/project/repos.yaml
+# Reads repo configuration from .pennyfarthing/repos.yaml
 
 set -e
 

package/pennyfarthing-dist/scripts/git/install-git-hooks.sh

@@ -1,10 +1,11 @@
 #!/bin/bash
-# install-git-hooks.sh - Install Pennyfarthing git hooks for dogfooding
+# install-git-hooks.sh - Install Pennyfarthing git hooks for framework development
 #
 # Usage: ./pennyfarthing-dist/scripts/install-git-hooks.sh
 #
-# For dogfooding only. Clients use `pennyfarthing init` which copies hooks
-# from node_modules. This script creates symlinks for development.
+# For the pennyfarthing framework repo and orchestrator repos that inline it.
+# End-user projects use `pennyfarthing init` which copies hooks from node_modules.
+# This script creates symlinks so hook changes in pennyfarthing-dist/ take effect immediately.
 
 set -euo pipefail
 
@@ -14,10 +15,11 @@ source "$SCRIPT_DIR/../lib/find-root.sh"
 HOOKS_SOURCE="$PROJECT_ROOT/pennyfarthing-dist/scripts/hooks"
 HOOKS_DEST="$PROJECT_ROOT/.git/hooks"
 
-# Check we're in the pennyfarthing repo (dogfooding)
+# Check we're in a repo with pennyfarthing-dist (framework or orchestrator)
 if [[ ! -d "$PROJECT_ROOT/pennyfarthing-dist" ]]; then
-    echo "Error: This script is for dogfooding only (pennyfarthing repo)"
-    echo "       Clients should use: pennyfarthing init"
+    echo "Error: This script requires pennyfarthing-dist/ at the project root"
+    echo "       (framework repo or orchestrator with inlined pennyfarthing/)"
+    echo "       End-user projects should use: pennyfarthing init"
     exit 1
 fi
 

package/pennyfarthing-dist/scripts/git/worktree-manager.sh

@@ -3,7 +3,7 @@
 # Usage: worktree-manager.sh {create|remove|list|status|ports|cd} [args]
 #
 # Configuration (choose one):
-#   1. repos.yaml: Define repos in .claude/project/repos.yaml (recommended)
+#   1. repos.yaml: Define repos in .pennyfarthing/repos.yaml (recommended)
 #   2. Legacy env vars: Set API_REPO and UI_REPO in .claude/project/hooks/setup-env.sh
 
 set -e
@@ -109,7 +109,7 @@ load_repos_config
 if [ "$(get_repo_count)" -eq 0 ]; then
     echo "❌ Error: No repositories configured"
     echo ""
-    echo "Option 1: Create .claude/project/repos.yaml (recommended for multi-repo projects)"
+    echo "Option 1: Create .pennyfarthing/repos.yaml (recommended for multi-repo projects)"
     echo "Option 2: Set API_REPO and UI_REPO in .claude/project/hooks/setup-env.sh"
     exit 1
 fi
@@ -161,7 +161,7 @@ Repos Filter (third argument):
   repo1,repo2   - Comma-separated list of specific repo names
 
 Configuration:
-  Option 1 (recommended): Create .claude/project/repos.yaml
+  Option 1 (recommended): Create .pennyfarthing/repos.yaml
   Option 2 (legacy): Set API_REPO and UI_REPO environment variables
 
 Session Files:

package/pennyfarthing-dist/scripts/hooks/post-merge.sh

@@ -6,28 +6,30 @@
 # story branch is merged and automatically updating the sprint YAML status.
 #
 # Installation:
-#   Installed to .git/hooks/post-merge by pennyfarthing init or doctor --fix
+#   End-user projects: pennyfarthing init (copies to .git/hooks/)
+#   Framework/orchestrator: install-git-hooks.sh (symlinks to pennyfarthing-dist/)
 #
 # Dependencies:
 #   - yq (for YAML manipulation)
-#   - sprint-common.sh (for shared sprint functions)
+#   (sprint-common.sh removed — all functions defined locally)
 
 set -uo pipefail
 
-# Self-locate (resolve symlink first for .git/hooks/ symlinks)
+# Find project root
+# Try find-root.sh via symlink resolution first, then fall back to .git location
 REAL_SCRIPT="$(readlink -f "${BASH_SOURCE[0]:-$0}" 2>/dev/null || realpath "${BASH_SOURCE[0]:-$0}" 2>/dev/null || echo "${BASH_SOURCE[0]:-$0}")"
-source "$(dirname "$REAL_SCRIPT")/../lib/find-root.sh"
-
-# PROJECT_ROOT is now set by find-root.sh
+FIND_ROOT="$(dirname "$REAL_SCRIPT")/../lib/find-root.sh"
+if [[ -f "$FIND_ROOT" ]]; then
+    source "$FIND_ROOT"
+else
+    # Running as a copy in .git/hooks/ — derive PROJECT_ROOT from git dir
+    PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")/../.." && pwd)"
+    export PROJECT_ROOT
+fi
 SESSION_DIR="$PROJECT_ROOT/.session"
 SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
 
-# Source sprint-common.sh for shared functions
-SPRINT_COMMON="$PROJECT_ROOT/.pennyfarthing/scripts/sprint/sprint-common.sh"
-if [[ -f "$SPRINT_COMMON" ]]; then
-    # shellcheck source=/dev/null
-    source "$SPRINT_COMMON"
-fi
+# Note: sprint-common.sh removed — all needed functions are defined locally below
 
 # extract_story_id BRANCH_NAME
 # Extract story ID from branch name pattern feat/X-Y-*

package/pennyfarthing-dist/scripts/hooks/pre-commit.sh

@@ -8,8 +8,8 @@
 # 3. Validates sprint YAML files when sprint/*.yaml is modified
 #
 # Installation:
-#   Installed to .git/hooks/pre-commit by pennyfarthing init or doctor --fix
-#   Or symlink: ln -sf ../../pennyfarthing-dist/scripts/hooks/pre-commit.sh .git/hooks/pre-commit
+#   End-user projects: pennyfarthing init (copies to .git/hooks/)
+#   Framework/orchestrator: install-git-hooks.sh (symlinks to pennyfarthing-dist/)
 
 set -uo pipefail
 
@@ -114,7 +114,8 @@ fi
 
 SPRINT_YAML_FILES=$(git diff --cached --name-only -- 'sprint/*.yaml' 'sprint/archive/*.yaml' 2>/dev/null \
     | grep -v 'sprint-template\.yaml$' \
-    | grep -v 'sprint/completed\.yaml$' || true)
+    | grep -v 'sprint/completed\.yaml$' \
+    | grep -v 'sprint/context/archived/' || true)
 
 if [[ -n "$SPRINT_YAML_FILES" ]]; then
     echo "Sprint YAML files staged for commit:"

package/pennyfarthing-dist/scripts/hooks/pre-push.sh

@@ -4,15 +4,21 @@
 # Checks if sprint files were modified and reminds to sync to Jira.
 #
 # Installation:
-#   Installed to .git/hooks/pre-push by pennyfarthing init or doctor --fix
-#   Or symlink: ln -sf ../../pennyfarthing-dist/scripts/hooks/pre-push.sh .git/hooks/pre-push
+#   End-user projects: pennyfarthing init (copies to .git/hooks/)
+#   Framework/orchestrator: install-git-hooks.sh (symlinks to pennyfarthing-dist/)
 
 set -uo pipefail
 
-# Self-locate (resolve symlink first for .git/hooks/ symlinks)
+# Find project root
+# Try find-root.sh via symlink resolution first, then fall back to .git location
 REAL_SCRIPT="$(readlink -f "${BASH_SOURCE[0]:-$0}" 2>/dev/null || realpath "${BASH_SOURCE[0]:-$0}" 2>/dev/null || echo "${BASH_SOURCE[0]:-$0}")"
-if ! source "$(dirname "$REAL_SCRIPT")/../lib/find-root.sh" 2>/dev/null; then
-    exit 0
+FIND_ROOT="$(dirname "$REAL_SCRIPT")/../lib/find-root.sh"
+if [[ -f "$FIND_ROOT" ]]; then
+    source "$FIND_ROOT"
+else
+    # Running as a copy in .git/hooks/ — derive PROJECT_ROOT from git dir
+    PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")/../.." && pwd)"
+    export PROJECT_ROOT
 fi
 
 SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"

package/pennyfarthing-dist/scripts/hooks/sprint-yaml-validation.sh

@@ -15,7 +15,7 @@
 # Input: JSON via stdin with tool_name, tool_input
 # Output: JSON with additionalContext on validation failure
 #
-# See also: .pennyfarthing/scripts/validation/validate-sprint-yaml.sh
+# See also: pf sprint validate
 
 set -euo pipefail
 

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

@@ -7,7 +7,7 @@ Uncategorized utilities and one-off scripts.
 | Script | Purpose |
 |--------|---------|
 | `deploy.sh` | Deployment script |
-| `doctor-dogfood.sh` | Health check for dogfooding setup |
+| `doctor-dogfood.sh` | Health check for framework/orchestrator development setup |
 | `run-ci.sh` | Run CI locally |
 | `statusline.sh` | Status line configuration |
 | `uninstall.sh` | Uninstall Pennyfarthing from project |

package/pennyfarthing-dist/scripts/misc/repo-utils.sh

@@ -4,7 +4,7 @@
 #
 # Usage: source scripts/repo-utils.sh
 #
-# If .claude/project/repos.yaml exists, uses that configuration.
+# If .pennyfarthing/repos.yaml exists, uses that configuration.
 # Otherwise, falls back to legacy $API_REPO/$UI_REPO environment variables.
 #
 # Core Functions:
@@ -28,7 +28,7 @@ set -euo pipefail
 
 # Determine PROJECT_ROOT if not set
 PROJECT_ROOT="${PROJECT_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"
-REPOS_CONFIG="${PROJECT_ROOT}/.claude/project/pennyfarthing-settings.yaml"
+REPOS_CONFIG="${PROJECT_ROOT}/.pennyfarthing/repos.yaml"
 
 # Cache for parsed config (associative arrays)
 declare -A _REPO_PATHS 2>/dev/null || true
@@ -136,7 +136,7 @@ import json
 import sys
 import os
 
-config_path = os.environ.get('REPOS_CONFIG', '.claude/project/repos.yaml')
+config_path = os.environ.get('REPOS_CONFIG', '.pennyfarthing/repos.yaml')
 try:
     with open(config_path) as f:
         config = yaml.safe_load(f)

package/pennyfarthing-dist/scripts/misc/validate-subagent-frontmatter.sh

@@ -31,9 +31,8 @@ NC='\033[0m' # No Color
 # Required fields in frontmatter
 REQUIRED_FIELDS=("name" "description" "tools" "model")
 
-# Expected subagent files (8 total - consolidated in Story 31-11/31-12)
+# Expected subagent files (7 total - consolidated in Story 31-11/31-12)
 EXPECTED_SUBAGENTS=(
-    "workflow-status-check.md"
     "sm-setup.md"
     "sm-finish.md"
     "sm-file-summary.md"

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

@@ -1,29 +1,44 @@
 # Sprint Scripts
 
-Scripts for sprint YAML operations and sprint management.
-
-## Scripts
-
-| Script | Purpose |
-|--------|---------|
-| `sprint-status.sh` | Show current sprint status and metrics |
-| `sprint-info.sh` | Display sprint information |
-| `available-stories.sh` | List available stories in backlog |
-| `archive-story.sh` | Archive completed story to sprint archive |
-| `check-story.sh` | Check story details and readiness |
-| `new-sprint.sh` | Create a new sprint |
-| `promote-epic.sh` | Move epic from planning to current sprint |
-| `sprint-common.sh` | Shared sprint utilities (library) |
-| `sprint-metrics.sh` | Calculate sprint metrics |
+Sprint management is handled by the Python CLI: `pf sprint [COMMAND]`.
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `pf sprint status` | Show current sprint status and metrics |
+| `pf sprint backlog` | List available stories grouped by epic |
+| `pf sprint info` | Sprint info as JSON (for Cyclist sidebar) |
+| `pf sprint metrics` | Sprint velocity and progress metrics |
+| `pf sprint check <id>` | Check story/epic availability (JSON) |
+| `pf sprint future` | Show future initiatives and epics |
+| `pf sprint new` | Initialize a new sprint |
+| `pf sprint validate <file>` | Validate sprint YAML structure |
+| `pf sprint archive <id>` | Archive a completed story |
+| `pf sprint work <id>` | Start work on a story |
+| `pf sprint story field <id> <field>` | Get a story field value |
+| `pf sprint epic field <id> <field>` | Get an epic field value |
+| `pf sprint epic promote <id>` | Move epic from future to current sprint |
+| `pf sprint epic show <id>` | Show epic details |
+| `pf sprint epic cancel <id>` | Cancel an epic |
+| `pf sprint epic archive` | Archive completed epics |
 
 ## Usage
 
 ```bash
-.pennyfarthing/scripts/sprint/sprint-status.sh
-.pennyfarthing/scripts/sprint/available-stories.sh
+pf sprint status
+pf sprint backlog
+pf sprint future epic-55
+pf sprint epic promote epic-41
 ```
 
 ## Ownership
 
 - **Primary users:** SM agent, `/sprint` skill
 - **Maintained by:** Core Pennyfarthing team
+
+## Migration Note
+
+All bash scripts previously in this directory have been migrated to Python CLI
+commands in `pennyfarthing_scripts/sprint/cli.py`. See PR #716 and the follow-up
+deprecation commit for details.

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

@@ -19,5 +19,5 @@ Scripts for story creation and management.
 
 ## Ownership
 
-- **Primary users:** SM agent, `/story` skill
+- **Primary users:** SM agent, `/sprint story` commands
 - **Maintained by:** Core Pennyfarthing team

package/pennyfarthing-dist/scripts/test/test-setup.sh

@@ -4,7 +4,7 @@
 #
 # Usage: source scripts/test/test-setup.sh
 #
-# Configuration is read from .claude/project/repos.yaml
+# Configuration is read from .pennyfarthing/repos.yaml
 # See repos.yaml for schema documentation
 #
 # Functions:

package/pennyfarthing-dist/scripts/tests/handoff-phase-update.test.sh

@@ -6,7 +6,7 @@
 # - AC1: Updating **Phase:** field to next phase
 # - AC2: Updating Phase History table with end timestamp and duration
 # - AC3: Adding Handoff History row with gate and status
-# - AC4: workflow-status-check correctly detects phase (integration)
+# - AC4: prime correctly detects phase (integration)
 # - AC5: All three transitions documented (TEA→Dev, Dev→Reviewer, Reviewer→SM)
 
 set -euo pipefail
@@ -190,14 +190,14 @@ run_test test_ac3_status_in_history
 run_test test_ac3_explicit_edit_for_history
 
 # ==============================================================================
-# AC4: workflow-status-check correctly detects current phase after handoff
+# AC4: prime correctly detects current phase after handoff
 # ==============================================================================
 echo ""
-echo "--- AC4: workflow-status-check compatibility ---"
+echo "--- AC4: prime/workflow.py compatibility ---"
 
 test_ac4_phase_field_format() {
-    # Phase field must use exact format that workflow-status-check expects
-    # workflow-status-check greps for: **Phase:**
+    # Phase field must use exact format that prime/workflow.py expects
+    # parse_session_header greps for: **Phase:**
     if echo "$HANDOFF_CONTENT" | grep -q '\*\*Phase:\*\*'; then
         pass "AC4.1: Uses correct **Phase:** format"
     else