@pennyfarthing/core 8.0.4 → 9.0.0

package/README.md

@@ -1,6 +1,6 @@
 # Pennyfarthing
 
-**v7.9.2** | *The outer loop goes once, the inner loop goes many times.*
+**v8.1.0** | *The outer loop goes once, the inner loop goes many times.*
 
 <img src="pennyfarthing.png" alt="Pennyfarthing Logo" width="75" style="float:left; margin:10px">
 
@@ -62,7 +62,7 @@ npx pennyfarthing init
 npx pennyfarthing doctor
 
 # Start working (in Claude Code)
-/work
+/new-work
 ```
 
 ### Optional: Visual Terminal
@@ -88,7 +88,7 @@ BikeLane is the umbrella workflow system supporting three types:
 ### Example: TDD Workflow (Phased)
 
 ```
-/work → SM → TEA → Dev → Reviewer → SM (finish)
+/new-work → SM → TEA → Dev → Reviewer → SM (finish)
          │     │     │       │
       setup  tests  impl   review
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pennyfarthing/core",
-  "version": "8.0.4",
+  "version": "9.0.0",
   "description": "Claude Code agent framework with TDD workflow and persona system",
   "type": "module",
   "bin": {
@@ -30,8 +30,8 @@
     "url": "https://github.com/1898andCo/pennyfarthing/issues"
   },
   "scripts": {
-    "build": "pnpm --filter @pennyfarthing/shared build && pnpm --filter @pennyfarthing/core build && pnpm --filter @pennyfarthing/cyclist build && ./scripts/utils/generate-skill-docs.sh",
-    "docs": "./scripts/utils/generate-skill-docs.sh",
+    "build": "pnpm --filter @pennyfarthing/shared build && pnpm --filter @pennyfarthing/core build && pnpm --filter @pennyfarthing/cyclist build && ./scripts/generate-skill-docs.sh",
+    "docs": "./scripts/generate-skill-docs.sh",
     "dev": "pnpm -r --parallel dev",
     "test": "pnpm -r test",
     "lint": "eslint 'packages/*/src/**/*.ts' --max-warnings 0",

package/pennyfarthing-dist/agents/README.md

@@ -284,7 +284,7 @@ When running in Cyclist, background tasks are automatically tracked:
 Use the background task tracking utilities to manage session file entries:
 
 ```bash
-source .pennyfarthing/scripts/utils/background-tasks.sh
+source .pennyfarthing/scripts/lib/background-tasks.sh
 SESSION_FILE=".session/${STORY_ID}-session.md"
 
 # After spawning, record the task:

package/pennyfarthing-dist/agents/dev.md

@@ -153,7 +153,7 @@ Write to session file BEFORE spawning handoff:
 3. Await `HANDOFF_RESULT` with `next_agent`
 4. **ABSOLUTE LAST ACTION:**
    ```bash
-   .pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
+   .pennyfarthing/scripts/core/handoff-marker.sh {next_agent}
    ```
 5. Output result verbatim and EXIT
 </exit-sequence>

package/pennyfarthing-dist/agents/handoff.md

@@ -229,7 +229,7 @@ When you receive `HANDOFF_RESULT`:
 **CRITICAL: The calling agent MUST run this as their ABSOLUTE LAST ACTION:**
 
 ```bash
-.pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
+.pennyfarthing/scripts/core/handoff-marker.sh {next_agent}
 ```
 
 Then output the script's result verbatim and EXIT. Nothing else after.

package/pennyfarthing-dist/agents/reviewer-preflight.md

@@ -35,7 +35,7 @@ cd "${REPO}" 2>/dev/null || cd "packages/${REPO}" && git fetch origin && git che
 ## 2. Check Test Cache
 
 ```bash
-source scripts/utils/test-cache.sh
+source .pennyfarthing/scripts/test/test-cache.sh
 SESSION_FILE=".session/{STORY_ID}-session.md"
 
 if test_cache_valid "$SESSION_FILE"; then

package/pennyfarthing-dist/agents/reviewer.md

@@ -124,6 +124,7 @@ OWNER=$(.pennyfarthing/scripts/workflow/phase-owner.sh {workflow} {phase})
 ## MANDATORY: Complete Before Exiting
 
 - [ ] Write Reviewer Assessment to session file
+- [ ] **If APPROVED:** Merge PR directly with `gh pr merge {PR_NUMBER} --merge --delete-branch`
 - [ ] Spawn `handoff` subagent with VERDICT (approved/rejected)
 - [ ] Verify handoff completed (subagent emits marker)
 </handoff-gate>
@@ -158,16 +159,32 @@ OWNER=$(.pennyfarthing/scripts/workflow/phase-owner.sh {workflow} {phase})
 <exit-sequence>
 ## Exit Sequence
 
+### If APPROVED:
 1. Write Reviewer Assessment to session file
-2. Spawn `handoff` subagent with VERDICT
-3. Await `HANDOFF_RESULT` with `next_agent`
+2. **Merge the PR directly** (don't wait for SM):
+   ```bash
+   gh pr merge {PR_NUMBER} --merge --delete-branch
+   ```
+3. Update session phase to `finish`
+4. Spawn `handoff` subagent with VERDICT=approved
+5. Await `HANDOFF_RESULT` with `next_agent` (will be `sm`)
+6. **ABSOLUTE LAST ACTION:**
+   ```bash
+   .pennyfarthing/scripts/core/handoff-marker.sh sm
+   ```
+7. Output result verbatim and EXIT
+
+### If REJECTED:
+1. Write Reviewer Assessment to session file
+2. Spawn `handoff` subagent with VERDICT=rejected
+3. Await `HANDOFF_RESULT` with `next_agent` (will be `dev`)
 4. **ABSOLUTE LAST ACTION:**
    ```bash
-   .pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
+   .pennyfarthing/scripts/core/handoff-marker.sh dev
    ```
 5. Output result verbatim and EXIT
 
-**Verdict routing:** APPROVED → sm | REJECTED → dev
+**Verdict routing:** APPROVED → merge PR, then sm | REJECTED → dev
 </exit-sequence>
 
 <skills>

package/pennyfarthing-dist/agents/sm-setup.md

@@ -135,14 +135,14 @@ GRANTS=$(cat .claude/settings.local.json 2>/dev/null | jq '.permissions.grants /
 
 ## Step 3: Claim in Jira
 
-Use `/jira claim` command:
+Use `/jira check` and `/jira claim` commands:
 
 ```bash
 # Check availability first
-.pennyfarthing/scripts/jira/jira-claim-story.sh {JIRA_KEY}
+/jira check {JIRA_KEY}
 
 # Then claim (assign to self + move to In Progress)
-.pennyfarthing/scripts/jira/jira-claim-story.sh {JIRA_KEY} --claim
+/jira claim {JIRA_KEY}
 ```
 
 **Exit codes:**

package/pennyfarthing-dist/agents/sm.md

@@ -175,6 +175,16 @@ Present to user:
    - **Stepped workflow** → Tell user to run `/workflow start {workflow}` (no handoff)
 </new-work-flow>
 
+<merge-gate>
+## Merge Gate (BLOCKING)
+
+Before starting new work: `gh pr list --state open` - BLOCKS if any exist.
+
+Open PRs → incomplete work → merge conflicts, stale branches, CI failures.
+
+**Resolution:** Merge/close all PRs first. Use `/reviewer` to complete reviews.
+</merge-gate>
+
 <gate>
 ## Pre-Handoff Checklist (BLOCKING)
 
@@ -276,7 +286,7 @@ OWNER=$(.pennyfarthing/scripts/workflow/phase-owner.sh {workflow} {phase})
 3. Await `HANDOFF_RESULT` with `next_agent`
 4. **ABSOLUTE LAST ACTION:**
    ```bash
-   .pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
+   .pennyfarthing/scripts/core/handoff-marker.sh {next_agent}
    ```
 5. Output result verbatim and EXIT
 

package/pennyfarthing-dist/agents/tea.md

@@ -144,7 +144,7 @@ Write to session file BEFORE spawning handoff:
 3. Await `HANDOFF_RESULT` with `next_agent`
 4. **ABSOLUTE LAST ACTION:**
    ```bash
-   .pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
+   .pennyfarthing/scripts/core/handoff-marker.sh {next_agent}
    ```
 5. Output result verbatim and EXIT
 </exit-sequence>

package/pennyfarthing-dist/agents/testing-runner.md

@@ -40,8 +40,8 @@ This runs lint + typecheck + tests. Exit 0 = all passed.
 ## Setup
 
 ```bash
-source .pennyfarthing/scripts/repo-utils.sh
-source .pennyfarthing/scripts/utils/test-setup.sh
+source .pennyfarthing/scripts/misc/repo-utils.sh
+source .pennyfarthing/scripts/test/test-setup.sh
 
 RUN_ID="${RUN_ID:-$(generate_run_id)}"
 ensure_test_containers
@@ -73,7 +73,7 @@ fi
 
 Write cache after running:
 ```bash
-source .pennyfarthing/scripts/utils/test-cache.sh
+source .pennyfarthing/scripts/test/test-cache.sh
 SESSION_FILE=".session/${STORY_ID}-session.md"
 test_cache_write "$SESSION_FILE" "$RESULT" "$PASS" "$FAIL" "$SKIP" "${DURATION}s"
 ```

package/pennyfarthing-dist/commands/architect.md

@@ -3,5 +3,7 @@ description: System Architect - Technical design and architecture
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "architect"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "architect"
 ```

package/pennyfarthing-dist/commands/continue-session.md

@@ -66,7 +66,7 @@ Source the checkpoint utilities and restore:
 
 ```bash
 # Source checkpoint utilities
-source "${PROJECT_ROOT:-.}/.pennyfarthing/scripts/utils/checkpoint.sh"
+source "${PROJECT_ROOT:-.}/.pennyfarthing/scripts/lib/checkpoint.sh"
 
 # Restore by label
 PHASE=$(checkpoint_restore "phase:${STORY_ID}")
@@ -177,7 +177,7 @@ This command completes the circuit breaker workflow:
 </integration>
 
 <reference>
-- **Checkpoint API:** `scripts/utils/checkpoint.sh`
+- **Checkpoint API:** `.pennyfarthing/scripts/lib/checkpoint.sh`
 - **Circuit Breaker:** `scripts/hooks/context-circuit-breaker.sh`
 - **Related:** `/work`, `/new-work`
 - **Session Files:** `.session/{story-id}-session.md`

package/pennyfarthing-dist/commands/dev.md

@@ -3,5 +3,7 @@ description: Developer - Feature implementation and coding
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/phase-check-start.sh" "dev"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "dev"
 ```

package/pennyfarthing-dist/commands/devops.md

@@ -3,5 +3,7 @@ description: DevOps Engineer - Infrastructure and deployment automation
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "devops"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "devops"
 ```

package/pennyfarthing-dist/commands/health-check.md

@@ -3,7 +3,9 @@ description: Check Pennyfarthing installation health and apply updates
 ---
 
 ```bash
-./scripts/core/agent-session.sh start "devops"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "devops"
 ```
 
 <agent-activation>

package/pennyfarthing-dist/commands/new-work.md

@@ -0,0 +1,23 @@
+---
+description: Start the next available story from the sprint backlog
+---
+
+# New Work
+
+<purpose>
+Shortcut to start the highest priority available story. Alias for `/sprint work next`.
+</purpose>
+
+<on-invoke>
+Invoke the sprint work command with "next" to auto-select the highest priority story:
+
+```
+/sprint work next
+```
+</on-invoke>
+
+<related>
+- `/sprint work` - Interactive story selection
+- `/sprint backlog` - View available stories
+- `/work` - Resume existing work or start new
+</related>

package/pennyfarthing-dist/commands/orchestrator.md

@@ -3,5 +3,7 @@ description: Orchestrator - Coordinator of all agents and meta operations
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "orchestrator"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "orchestrator"
 ```

package/pennyfarthing-dist/commands/parallel-work.md

@@ -3,7 +3,9 @@ description: Start parallel work in a new worktree
 ---
 
 ```bash
-./scripts/core/agent-session.sh start "parallel-work"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "sm"
 ```
 
 <parallel-work-flow>
@@ -20,10 +22,10 @@ read -p "Branch name (e.g., feat/5-3a-feature): " BRANCH_NAME
 
 # Create worktree
 WORKTREE_NAME="wt-${STORY_ID}"
-./scripts/git/worktree-manager.sh create "$WORKTREE_NAME" "$BRANCH_NAME"
+.pennyfarthing/scripts/git/worktree-manager.sh create "$WORKTREE_NAME" "$BRANCH_NAME"
 
 # Get port configuration
-eval $(./scripts/git/worktree-manager.sh ports "$WORKTREE_NAME")
+eval $(.pennyfarthing/scripts/git/worktree-manager.sh ports "$WORKTREE_NAME")
 ```
 
 ### Step 2: Create Session File
@@ -67,5 +69,5 @@ Invoke SM to complete story setup in the worktree context.
 </agent-activation>
 
 <agent-exit>
-On exit: Capture learnings to sidecar, run `./scripts/core/agent-session.sh stop`
+On exit: Capture learnings to sidecar.
 </agent-exit>

package/pennyfarthing-dist/commands/pm.md

@@ -3,5 +3,7 @@ description: Product Manager - Strategic planning and prioritization
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "pm"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "pm"
 ```

package/pennyfarthing-dist/commands/prime.md

@@ -4,7 +4,7 @@ description: Load essential project context at agent activation
 
 <purpose>
 Quickly load essential context files to reduce agent cold-start overhead.
-Automatically invoked on agent activation via agent-session.sh.
+Automatically invoked on agent activation via `pf agent start`.
 </purpose>
 
 <when-to-use>
@@ -17,23 +17,23 @@ Automatically invoked on agent activation via agent-session.sh.
 
 ## Running /prime
 
-Use the prime.sh script:
+Use the Python CLI:
 
 ```bash
 # Load all essential context (default)
-$CLAUDE_PROJECT_DIR/.pennyfarthing/scripts/prime.sh
+python3 -m pennyfarthing_scripts.cli agent start "sm"
 
-# Minimal mode - CLAUDE.md only (fastest)
-$CLAUDE_PROJECT_DIR/.pennyfarthing/scripts/prime.sh --minimal
+# Minimal mode - fastest startup
+python3 -m pennyfarthing_scripts.cli agent start "sm" --minimal
 
 # Full mode - include domain docs
-$CLAUDE_PROJECT_DIR/.pennyfarthing/scripts/prime.sh --full
+python3 -m pennyfarthing_scripts.cli agent start "sm" --full
 
-# Quiet mode - suppress headers (used by agent-session.sh)
-$CLAUDE_PROJECT_DIR/.pennyfarthing/scripts/prime.sh --quiet
+# Skip persona loading
+python3 -m pennyfarthing_scripts.cli agent start "sm" --no-persona
 
-# With agent sidecar loading
-$CLAUDE_PROJECT_DIR/.pennyfarthing/scripts/prime.sh --agent reviewer
+# JSON output (for Cyclist integration)
+python3 -m pennyfarthing_scripts.cli agent start "sm" --json
 ```
 
 ## Options
@@ -106,17 +106,16 @@ With `--quiet`, section headers are suppressed.
 
 <integration>
 
-## agent-session.sh Integration
+## Python CLI Integration
 
 The `/prime` command is automatically invoked when agents activate:
 
 1. User invokes `/sm`, `/tea`, `/dev`, or `/reviewer`
-2. `agent-session.sh start` runs
-3. Persona XML is output
-4. `/prime --quiet --agent <agent-name>` loads context automatically
-5. Agent starts with full context AND their learned patterns loaded
+2. `pf agent start <name>` runs
+3. Context is loaded: workflow state, agent definition, persona, behavior guide, sprint context, session, sidecars
+4. Agent starts with full context AND their learned patterns loaded
 
-This reduces the "cold start" problem where agents must discover context through multiple file reads. The `--agent` flag ensures each agent gets their project-specific sidecar patterns immediately.
+This reduces the "cold start" problem where agents must discover context through multiple file reads.
 
 ## Manual Refresh
 
@@ -130,11 +129,8 @@ If context becomes stale mid-session, run `/prime` manually:
 </integration>
 
 <reference>
-- **Script:** `.pennyfarthing/scripts/prime.sh`
-- **Called by:** agent-session.sh on agent start (with `--agent` flag)
-- **Loads:** CLAUDE.md, sprint, session, sidecar, shared context, shared behavior, tactical guide
+- **CLI:** `pf agent start <name>` or `python3 -m pennyfarthing_scripts.cli agent start <name>`
+- **Loads:** Workflow state, agent definition, persona, behavior guide, sprint context, session, sidecars
 - **Sidecar location:** `.pennyfarthing/sidecars/{agent}/*.md`
-- **Shared context:** `.pennyfarthing/guides/agent-behavior.md` (all agents)
-- **Shared behavior:** `.pennyfarthing/guides/agent-behavior.md` (all agents)
-- **Tactical guide:** `.pennyfarthing/guides/agent-behavior.md` (sm, tea, dev, reviewer only)
+- **Behavior guide:** `.pennyfarthing/guides/agent-behavior.md` (all agents)
 </reference>

package/pennyfarthing-dist/commands/reviewer.md

@@ -3,5 +3,7 @@ description: Code Reviewer - Critical code review and quality enforcement
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/phase-check-start.sh" "reviewer"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "reviewer"
 ```

package/pennyfarthing-dist/commands/set-theme.md

@@ -51,6 +51,6 @@ Change the active persona theme for all agents.
 
 6. Refresh the current agent's persona to apply the new theme:
    ```bash
-   d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" refresh
+   python3 -m pennyfarthing_scripts.cli agent start "sm"
    ```
    This outputs the updated persona. **Adopt the new character immediately** - do not continue using the old persona.

package/pennyfarthing-dist/commands/sm.md

@@ -3,5 +3,7 @@ description: Scrum Master - Story coordination and sprint management
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/phase-check-start.sh" "sm"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "sm"
 ```

package/pennyfarthing-dist/commands/sprint.md

@@ -50,6 +50,14 @@ Start work on a story. Primary entry point for development.
 | `next` | Auto-select highest priority story |
 
 ```bash
+# MERGE GATE: Check for open PRs first (blocks if any exist)
+OPEN_PRS=$(gh pr list --state open --json number --jq 'length' 2>/dev/null || echo "0")
+if [[ "$OPEN_PRS" -gt 0 ]]; then
+  echo "⛔ BLOCKED: $OPEN_PRS open PR(s) - merge or close before starting new work"
+  gh pr list --state open
+  # Don't proceed until PRs are cleared
+fi
+
 # Check if story is available
 .pennyfarthing/scripts/sprint/check-story.sh <story-id>
 
@@ -58,10 +66,11 @@ Start work on a story. Primary entry point for development.
 
 <workflow>
 When starting work, this command:
-1. Validates story availability
-2. Loads SM agent
-3. SM creates context and claims Jira
-4. Hands off to TEA (tdd) or Dev (trivial)
+1. **Checks merge gate** - blocks if open PRs exist
+2. Validates story availability
+3. Loads SM agent
+4. SM creates context and claims Jira
+5. Hands off to TEA (tdd) or Dev (trivial)
 </workflow>
 
 ### `/sprint archive <story-id> [pr-number] [--apply]`

package/pennyfarthing-dist/commands/tea.md

@@ -3,5 +3,7 @@ description: Test Engineer/Architect - Test strategy and TDD
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/phase-check-start.sh" "tea"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "tea"
 ```

package/pennyfarthing-dist/commands/tech-writer.md

@@ -3,5 +3,7 @@ description: Technical Writer - Documentation creation and maintenance
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "tech-writer"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "tech-writer"
 ```

package/pennyfarthing-dist/commands/ux-designer.md

@@ -3,5 +3,7 @@ description: UX Designer - User experience design and UI patterns
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "ux-designer"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "ux-designer"
 ```

package/pennyfarthing-dist/commands/work.md

@@ -7,9 +7,11 @@ description: Resume work or start new - smart entry point that picks up where yo
 <agent-activation>
 **FIRST:** Use Bash tool to run:
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "sm"
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
+python3 -m pennyfarthing_scripts.cli agent start "sm"
 ```
-This finds the project root and loads your persona. Adopt the character shown in the output.
+This loads your persona. Adopt the character shown in the output.
 </agent-activation>
 
 <purpose>