@pennyfarthing/core 7.9.5 → 8.0.0

package/pennyfarthing-dist/agents/sm.md

@@ -115,7 +115,7 @@ Prime script provides workflow state. Route based on state from activation outpu
 
 2. **Run finish script:**
    ```bash
-   .pennyfarthing/scripts/core/run.sh workflow/finish-story.sh {STORY_ID}
+   .pennyfarthing/scripts/workflow/finish-story.sh {STORY_ID}
    ```
 
 3. **Commit results:**
@@ -157,8 +157,8 @@ Present to user:
 
 1. **Get workflow type:**
    ```bash
-   WORKFLOW=$(.pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh X-Y workflow)
-   WORKFLOW_TYPE=$(.pennyfarthing/scripts/core/run.sh workflow/get-workflow-type.sh "$WORKFLOW")
+   WORKFLOW=$(.pennyfarthing/scripts/sprint/get-story-field.sh X-Y workflow)
+   WORKFLOW_TYPE=$(.pennyfarthing/scripts/workflow/get-workflow-type.sh "$WORKFLOW")
    ```
 
 2. **Spawn `sm-setup MODE=setup`** with:
@@ -205,7 +205,7 @@ Before `sm-handoff`, verify ALL of these:
 > **Triggered when:** `EMPTY_BACKLOG_STATE`
 
 1. Report: "Sprint backlog empty. All stories done or cancelled."
-2. Show future work: `.pennyfarthing/scripts/core/run.sh sprint/list-future.sh`
+2. Show future work: `.pennyfarthing/scripts/sprint/list-future.sh`
 3. Offer: "Promote stories from `future.yaml`?" → `/sprint promote {epic-id}`
 
 **Never suggest:** Closing sprint early, starting sprint planning. Sprints are fixed two-week periods.
@@ -254,7 +254,7 @@ SM does NOT hand off to agents. Instead, use `/workflow start {name}` to begin t
 
 Read `**Workflow:**` and `**Phase:**` from session. Query:
 ```bash
-OWNER=$(.pennyfarthing/scripts/core/run.sh workflow/phase-owner.sh {workflow} {phase})
+OWNER=$(.pennyfarthing/scripts/workflow/phase-owner.sh {workflow} {phase})
 ```
 
 **If OWNER != "sm":** Run `handoff-marker.sh $OWNER`, output result, tell user.
@@ -276,7 +276,7 @@ OWNER=$(.pennyfarthing/scripts/core/run.sh workflow/phase-owner.sh {workflow} {p
 3. Await `HANDOFF_RESULT` with `next_agent`
 4. **ABSOLUTE LAST ACTION:**
    ```bash
-   .pennyfarthing/scripts/core/handoff-marker.sh {next_agent}
+   .pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
    ```
 5. Output result verbatim and EXIT
 

package/pennyfarthing-dist/agents/tea.md

@@ -58,7 +58,7 @@ ASSESSMENT_SECTION: "TEA Assessment"
 
 Read `**Workflow:**` and `**Phase:**` from session. Query:
 ```bash
-OWNER=$(.pennyfarthing/scripts/core/run.sh workflow/phase-owner.sh {workflow} {phase})
+OWNER=$(.pennyfarthing/scripts/workflow/phase-owner.sh {workflow} {phase})
 ```
 
 **If OWNER != "tea":** Run `handoff-marker.sh $OWNER`, output result, tell user.
@@ -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/core/handoff-marker.sh {next_agent}
+   .pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
    ```
 5. Output result verbatim and EXIT
 </exit-sequence>

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

@@ -222,5 +222,5 @@ Task tool:
 <exit>
 To exit: "Exit Tech Writer" or switch to another agent.
 
-On exit, run: `./scripts/run.sh core/agent-session.sh stop`
+On exit, run: `./.pennyfarthing/scripts/core/agent-session.sh stop`
 </exit>

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

@@ -19,8 +19,8 @@ model: haiku
 <critical>
 **Use `/check` command for unfiltered runs:**
 ```bash
-.pennyfarthing/scripts/core/run.sh workflow/check.sh
-.pennyfarthing/scripts/core/run.sh workflow/check.sh --repo api
+.pennyfarthing/scripts/workflow/check.sh
+.pennyfarthing/scripts/workflow/check.sh --repo api
 ```
 
 This runs lint + typecheck + tests. Exit 0 = all passed.
@@ -50,8 +50,8 @@ ensure_test_containers
 ## Filtered Runs
 
 ```bash
-.pennyfarthing/scripts/core/run.sh workflow/check.sh --filter "TestUserLogin"
-.pennyfarthing/scripts/core/run.sh workflow/check.sh --repo api --filter "TestUserLogin"
+.pennyfarthing/scripts/workflow/check.sh --filter "TestUserLogin"
+.pennyfarthing/scripts/workflow/check.sh --repo api --filter "TestUserLogin"
 ```
 
 | Language | Filter Flag |

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

@@ -232,5 +232,5 @@ REFLECT: I should design this modal to match existing patterns while adding clea
 <exit>
 To exit: "Exit UX Designer" or switch to another agent.
 
-On exit, run: `./scripts/run.sh core/agent-session.sh stop`
+On exit, run: `./.pennyfarthing/scripts/core/agent-session.sh stop`
 </exit>

package/pennyfarthing-dist/agents/workflow-status-check.md

@@ -23,7 +23,7 @@ Uses `/sprint` skill scripts for deterministic output.
 Run the sprint status script and parse output:
 
 ```bash
-.pennyfarthing/scripts/core/run.sh sprint/sprint-status.sh
+.pennyfarthing/scripts/sprint/sprint-status.sh
 ```
 
 Then check for active sessions:
@@ -53,7 +53,7 @@ fi
 # Read workflow name from session
 WORKFLOW=$(grep '^\*\*Workflow:\*\*' .session/*-session.md | head -1 | sed 's/.*: //')
 # Check if stepped
-.pennyfarthing/scripts/core/run.sh workflow/get-workflow-type.sh "$WORKFLOW"
+.pennyfarthing/scripts/workflow/get-workflow-type.sh "$WORKFLOW"
 ```
 
 **Important:** Sprints are fixed two-week periods (kanban-style). Never suggest closing a sprint early or starting sprint planning when backlog is empty. The correct response to `EMPTY_BACKLOG_STATE` is to suggest promoting stories from `future.yaml`.

package/pennyfarthing-dist/commands/architect.md

@@ -3,5 +3,5 @@ description: System Architect - Technical design and architecture
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/agent-session.sh start "architect"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "architect"
 ```

package/pennyfarthing-dist/commands/create-branches-from-story.md

@@ -100,16 +100,16 @@ Use this instead of Step 3 if you need to work on multiple stories simultaneousl
 cd $CLAUDE_PROJECT_DIR
 
 # Create worktree with branches (both API and UI)
-./scripts/run.sh git/worktree-manager.sh create [story-id] feat/[story-id]-[description]
+./scripts/git/worktree-manager.sh create [story-id] feat/[story-id]-[description]
 
 # Example: Story 5-2
-./scripts/run.sh git/worktree-manager.sh create 5-2 feat/5-2-csv-import
+./scripts/git/worktree-manager.sh create 5-2 feat/5-2-csv-import
 
 # For API-only work
-./scripts/run.sh git/worktree-manager.sh create [story-id] feat/[story-id]-[description] api
+./scripts/git/worktree-manager.sh create [story-id] feat/[story-id]-[description] api
 
 # For UI-only work
-./scripts/run.sh git/worktree-manager.sh create [story-id] feat/[story-id]-[description] ui
+./scripts/git/worktree-manager.sh create [story-id] feat/[story-id]-[description] ui
 ```
 
 This creates:
@@ -223,7 +223,7 @@ cd $CLAUDE_PROJECT_DIR/worktrees/[story-id]/API
 cd $CLAUDE_PROJECT_DIR/worktrees/[story-id]/UI
 
 # Get port configuration for dev servers
-eval $(./scripts/run.sh git/worktree-manager.sh ports [story-id])
+eval $(./scripts/git/worktree-manager.sh ports [story-id])
 echo "API: $API_PORT, UI: $UI_PORT"
 ```
 

package/pennyfarthing-dist/commands/dev.md

@@ -3,5 +3,5 @@ description: Developer - Feature implementation and coding
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/phase-check-start.sh "dev"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/phase-check-start.sh" "dev"
 ```

package/pennyfarthing-dist/commands/devops.md

@@ -3,5 +3,5 @@ description: DevOps Engineer - Infrastructure and deployment automation
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/agent-session.sh start "devops"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "devops"
 ```

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

@@ -3,7 +3,7 @@ description: Check Pennyfarthing installation health and apply updates
 ---
 
 ```bash
-./scripts/run.sh core/agent-session.sh start "devops"
+./scripts/core/agent-session.sh start "devops"
 ```
 
 <agent-activation>
@@ -108,10 +108,10 @@ Check if agents are following expected behavioral patterns:
 
 ```bash
 # Run drift detection
-.pennyfarthing/scripts/core/run.sh health/drift-detection.sh
+.pennyfarthing/scripts/health/drift-detection.sh
 
 # Verbose mode (see individual files)
-.pennyfarthing/scripts/core/run.sh health/drift-detection.sh --verbose
+.pennyfarthing/scripts/health/drift-detection.sh --verbose
 ```
 
 The script analyzes archived session files for:

package/pennyfarthing-dist/commands/orchestrator.md

@@ -3,5 +3,5 @@ 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/run.sh" core/agent-session.sh start "orchestrator"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "orchestrator"
 ```

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

@@ -3,7 +3,7 @@ description: Start parallel work in a new worktree
 ---
 
 ```bash
-./scripts/run.sh core/agent-session.sh start "parallel-work"
+./scripts/core/agent-session.sh start "parallel-work"
 ```
 
 <parallel-work-flow>
@@ -20,10 +20,10 @@ read -p "Branch name (e.g., feat/5-3a-feature): " BRANCH_NAME
 
 # Create worktree
 WORKTREE_NAME="wt-${STORY_ID}"
-./scripts/run.sh git/worktree-manager.sh create "$WORKTREE_NAME" "$BRANCH_NAME"
+./scripts/git/worktree-manager.sh create "$WORKTREE_NAME" "$BRANCH_NAME"
 
 # Get port configuration
-eval $(./scripts/run.sh git/worktree-manager.sh ports "$WORKTREE_NAME")
+eval $(./scripts/git/worktree-manager.sh ports "$WORKTREE_NAME")
 ```
 
 ### Step 2: Create Session File
@@ -67,5 +67,5 @@ Invoke SM to complete story setup in the worktree context.
 </agent-activation>
 
 <agent-exit>
-On exit: Capture learnings to sidecar, run `run.sh core/agent-session.sh stop`
+On exit: Capture learnings to sidecar, run `./scripts/core/agent-session.sh stop`
 </agent-exit>

package/pennyfarthing-dist/commands/pm.md

@@ -3,5 +3,5 @@ description: Product Manager - Strategic planning and prioritization
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/agent-session.sh start "pm"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "pm"
 ```

package/pennyfarthing-dist/commands/release.md

@@ -3,7 +3,7 @@ description: Merge develop to main and push (optional version bump)
 ---
 
 ```bash
-./scripts/run.sh git/release.sh "$@"
+./scripts/git/release.sh "$@"
 ```
 
 <purpose>

package/pennyfarthing-dist/commands/repo-status.md

@@ -15,13 +15,13 @@ Repos are configured in `.claude/project/repos.yaml`. The script automatically r
 Run this command to show the status of all repos:
 
 ```bash
-$CLAUDE_PROJECT_DIR/scripts/run.sh git/git-status-all.sh
+$CLAUDE_PROJECT_DIR/scripts/git/git-status-all.sh
 ```
 
 For a brief one-line-per-repo summary:
 
 ```bash
-$CLAUDE_PROJECT_DIR/scripts/run.sh git/git-status-all.sh --brief
+$CLAUDE_PROJECT_DIR/scripts/git/git-status-all.sh --brief
 ```
 
 ## What It Shows

package/pennyfarthing-dist/commands/retro.md

@@ -142,7 +142,7 @@ During retro, clean up accumulated session artifacts from the sprint:
 
 ```bash
 # See what would be cleaned (dry-run)
-$CLAUDE_PROJECT_DIR/scripts/run.sh misc/session-cleanup.sh --dry-run --aggressive
+$CLAUDE_PROJECT_DIR/scripts/misc/session-cleanup.sh --dry-run --aggressive
 ```
 
 Review the output. Look for:
@@ -153,7 +153,7 @@ Review the output. Look for:
 
 ```bash
 # Run full cleanup with aggressive mode (archives completed epic contexts)
-$CLAUDE_PROJECT_DIR/scripts/run.sh misc/session-cleanup.sh --aggressive
+$CLAUDE_PROJECT_DIR/scripts/misc/session-cleanup.sh --aggressive
 ```
 
 This removes:

package/pennyfarthing-dist/commands/reviewer.md

@@ -3,5 +3,5 @@ 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/run.sh" core/phase-check-start.sh "reviewer"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/phase-check-start.sh" "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/run.sh" core/agent-session.sh refresh
+   d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" refresh
    ```
    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,5 @@ 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/run.sh" core/phase-check-start.sh "sm"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/phase-check-start.sh" "sm"
 ```

package/pennyfarthing-dist/commands/sprint.md

@@ -20,7 +20,7 @@ Never manually edit `sprint/current-sprint.yaml`. Always use the provided script
 Show current sprint status with story counts and points.
 
 ```bash
-.pennyfarthing/scripts/core/run.sh sprint/sprint-status.sh [filter]
+.pennyfarthing/scripts/sprint/sprint-status.sh [filter]
 ```
 
 | Filter | Description |
@@ -35,7 +35,7 @@ Show current sprint status with story counts and points.
 Show available stories ready for work, grouped by epic.
 
 ```bash
-.pennyfarthing/scripts/core/run.sh sprint/available-stories.sh
+.pennyfarthing/scripts/sprint/available-stories.sh
 ```
 
 ### `/sprint work [story-id|epic-id|next]`
@@ -51,7 +51,7 @@ Start work on a story. Primary entry point for development.
 
 ```bash
 # Check if story is available
-.pennyfarthing/scripts/core/run.sh sprint/check-story.sh <story-id>
+.pennyfarthing/scripts/sprint/check-story.sh <story-id>
 
 # Then load SM to begin work
 ```
@@ -69,7 +69,7 @@ When starting work, this command:
 Archive a completed story.
 
 ```bash
-.pennyfarthing/scripts/core/run.sh sprint/archive-story.sh <story-id> [pr-number] [--apply]
+.pennyfarthing/scripts/sprint/archive-story.sh <story-id> [pr-number] [--apply]
 ```
 
 | Option | Description |
@@ -81,7 +81,7 @@ Archive a completed story.
 Initialize a new sprint.
 
 ```bash
-.pennyfarthing/scripts/core/run.sh sprint/new-sprint.sh 2605 277 2026-02-03 2026-02-16 "Sprint goal"
+.pennyfarthing/scripts/sprint/new-sprint.sh 2605 277 2026-02-03 2026-02-16 "Sprint goal"
 ```
 
 ### `/sprint future [--epic EPIC_ID]`
@@ -89,7 +89,7 @@ Initialize a new sprint.
 Show future work available for promotion.
 
 ```bash
-.pennyfarthing/scripts/core/run.sh sprint/list-future.sh [--epic epic-XX]
+.pennyfarthing/scripts/sprint/list-future.sh [--epic epic-XX]
 ```
 
 ### `/sprint promote <epic-id>`
@@ -97,7 +97,7 @@ Show future work available for promotion.
 Move an epic from future.yaml to current sprint.
 
 ```bash
-.pennyfarthing/scripts/core/run.sh sprint/promote-epic.sh epic-XX
+.pennyfarthing/scripts/sprint/promote-epic.sh epic-XX
 ```
 
 ## Quick Reference

package/pennyfarthing-dist/commands/start-epic.md

@@ -41,13 +41,13 @@ Before starting a new epic, clean up stale artifacts from previous work:
 cd $CLAUDE_PROJECT_DIR
 
 # Run conservative cleanup (7+ day old artifacts)
-$CLAUDE_PROJECT_DIR/scripts/run.sh misc/session-cleanup.sh --dry-run
+$CLAUDE_PROJECT_DIR/scripts/misc/session-cleanup.sh --dry-run
 
 # If dry-run looks good, run actual cleanup
-$CLAUDE_PROJECT_DIR/scripts/run.sh misc/session-cleanup.sh
+$CLAUDE_PROJECT_DIR/scripts/misc/session-cleanup.sh
 
 # Archive epic contexts for completed epics
-$CLAUDE_PROJECT_DIR/scripts/run.sh misc/session-cleanup.sh --aggressive
+$CLAUDE_PROJECT_DIR/scripts/misc/session-cleanup.sh --aggressive
 ```
 
 This ensures a clean slate before starting new epic work and archives contexts from completed epics.

package/pennyfarthing-dist/commands/sync-epic-to-jira.md

@@ -29,13 +29,13 @@ All Pennyfarthing epics and stories must include the `pennyfarthing` label:
 
 ```bash
 # View story status
-./scripts/run.sh jira/jira-sync-story.sh 35-2-topology-editor
+./scripts/jira/jira-sync-story.sh 35-2-topology-editor
 
 # Transition to match Pennyfarthing status
-./scripts/run.sh jira/jira-sync-story.sh 35-2-topology-editor --transition
+./scripts/jira/jira-sync-story.sh 35-2-topology-editor --transition
 
 # Add a comment
-./scripts/run.sh jira/jira-sync-story.sh 35-2-topology-editor --comment "Started development"
+./scripts/jira/jira-sync-story.sh 35-2-topology-editor --comment "Started development"
 ```
 
 ### Sync All Stories in Epic
@@ -43,7 +43,7 @@ All Pennyfarthing epics and stories must include the `pennyfarthing` label:
 ```bash
 # For each story in the epic, sync status
 for story in $(yq '.epic-35.stories | keys | .[]' sprint/current-sprint.yaml); do
-    ./scripts/run.sh jira/jira-sync-story.sh "$story" --transition
+    ./scripts/jira/jira-sync-story.sh "$story" --transition
 done
 ```
 

package/pennyfarthing-dist/commands/tea.md

@@ -3,5 +3,5 @@ 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/run.sh" core/phase-check-start.sh "tea"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/phase-check-start.sh" "tea"
 ```

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

@@ -3,5 +3,5 @@ description: Technical Writer - Documentation creation and maintenance
 ---
 
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/agent-session.sh start "tech-writer"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "tech-writer"
 ```

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

@@ -3,5 +3,5 @@ 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/run.sh" core/agent-session.sh start "ux-designer"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "ux-designer"
 ```

package/pennyfarthing-dist/commands/work.md

@@ -7,7 +7,7 @@ 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/run.sh" core/agent-session.sh start "sm"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "sm"
 ```
 This finds the project root and loads your persona. Adopt the character shown in the output.
 </agent-activation>

package/pennyfarthing-dist/guides/agent-behavior.md

@@ -11,12 +11,12 @@
 </critical>
 
 <critical>
-**Path resolution:** Use `.pennyfarthing/scripts/core/run.sh` for all script calls - it handles path resolution.
+**Path resolution:** Scripts now self-locate via BASH_SOURCE. Invoke directly from `.pennyfarthing/scripts/`.
 For direct commands, use relative paths from project root (Claude Code starts there).
 
 ```bash
-# GOOD: Use run.sh wrapper
-.pennyfarthing/scripts/core/run.sh workflow/check.sh
+# GOOD: Direct script invocation
+.pennyfarthing/scripts/workflow/check.sh
 
 # GOOD: Relative paths for simple commands
 just test
@@ -116,9 +116,9 @@ $CLAUDE_PROJECT_DIR/.pennyfarthing/scripts/foo.sh  # BROKEN!
 **Rule 4:** All sprint YAML access goes through scripts
 ```bash
 # GOOD: Use scripts for ALL operations
-.pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh X-Y workflow
-.pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh 35 jira
-.pennyfarthing/scripts/core/run.sh sprint/check-story.sh X-Y
+.pennyfarthing/scripts/sprint/get-story-field.sh X-Y workflow
+.pennyfarthing/scripts/sprint/get-epic-field.sh 35 jira
+.pennyfarthing/scripts/sprint/check-story.sh X-Y
 
 # BAD: Direct yq queries (even read-only)
 yq '.epics[].stories[] | ...' sprint/current-sprint.yaml
@@ -235,7 +235,7 @@ HTML comments that agents emit to signal Cyclist UI. Format: `<!-- CYCLIST:TYPE:
 4. If `status: blocked` → report error, stop
 5. **Run this as ABSOLUTE LAST ACTION:**
    ```bash
-   .pennyfarthing/scripts/core/handoff-marker.sh {next_agent}
+   .pennyfarthing/scripts/handoff-marker.sh {next_agent}
    ```
 6. **Output the script result verbatim and EXIT**
 
@@ -271,14 +271,14 @@ When an agent detects the story is NOT in their phase, emit a marker immediately
 1. Read `**Workflow:**` and `**Phase:**` from session file
 2. Query the phase owner:
    ```bash
-   OWNER=$(.pennyfarthing/scripts/core/run.sh workflow/phase-owner.sh {workflow} {phase})
+   OWNER=$(.pennyfarthing/scripts/workflow/phase-owner.sh {workflow} {phase})
    ```
 3. If `$OWNER` != your agent name → story belongs to another agent
 
 ### Action When Not Your Phase
 
 ```bash
-.pennyfarthing/scripts/core/handoff-marker.sh {OWNER}
+.pennyfarthing/scripts/handoff-marker.sh {OWNER}
 ```
 
 Then output the result verbatim. This triggers Cyclist's handoff button.
@@ -288,13 +288,13 @@ Then output the result verbatim. This triggers Cyclist's handoff button.
 Dev reads session: `**Workflow:** tdd`, `**Phase:** review`
 
 ```bash
-OWNER=$(.pennyfarthing/scripts/core/run.sh workflow/phase-owner.sh tdd review)
+OWNER=$(.pennyfarthing/scripts/workflow/phase-owner.sh tdd review)
 # Returns: reviewer
 ```
 
 Since "reviewer" != "dev", Dev runs:
 ```bash
-.pennyfarthing/scripts/core/handoff-marker.sh reviewer
+.pennyfarthing/scripts/handoff-marker.sh reviewer
 ```
 
 ### Do NOT just say "run /reviewer"

package/pennyfarthing-dist/guides/agent-tag-taxonomy.md

@@ -175,7 +175,7 @@ Logic for checking if this agent owns the current phase.
 
 Read `**Workflow:**` and `**Phase:**` from session. Query:
 ```bash
-OWNER=$(.pennyfarthing/scripts/core/run.sh workflow/phase-owner.sh {workflow} {phase})
+OWNER=$(.pennyfarthing/scripts/workflow/phase-owner.sh {workflow} {phase})
 ```
 
 **If OWNER != "dev":** Run `handoff-marker.sh $OWNER`, output result, tell user.

package/pennyfarthing-dist/guides/agent-template-strategic.md

@@ -105,7 +105,7 @@ From theme config. Model: haiku. Tasks: {What helpers do for this agent}
 <exit>
 To exit: "Exit {Agent}" or "Switch to [other agent]"
 
-On exit, run: `./scripts/run.sh core/agent-session.sh stop`
+On exit, run: `.pennyfarthing/scripts/core/agent-session.sh stop`
 </exit>
 ```
 

package/pennyfarthing-dist/guides/agent-template-tactical.md

@@ -122,14 +122,14 @@ After completing work:
 
 1. Write assessment to session file
 2. Spawn handoff helper (`.pennyfarthing/agents/{agent}-handoff.md`)
-3. Check context: `eval $(./scripts/run.sh core/check-context.sh)`
+3. Check context: `eval $(.pennyfarthing/scripts/core/check-context.sh)`
 4. If `HANDOFF_MODE=auto`: Use Skill tool to invoke next agent
 5. If `HANDOFF_MODE=ask`: Tell user to start fresh session
 
 <exit>
 To exit: "Exit {Agent}" or "Switch to [other agent]"
 
-On exit, run: `./scripts/run.sh core/agent-session.sh stop`
+On exit, run: `.pennyfarthing/scripts/core/agent-session.sh stop`
 </exit>
 ```
 

package/pennyfarthing-dist/guides/worktree-mode.md

@@ -86,8 +86,8 @@ Ports are stored in the session file and passed to agents.
 | Command | Purpose |
 |---------|---------|
 | `/parallel-work` | Start a new parallel work session |
-| `./scripts/run.sh git/worktree-manager.sh list` | Show active worktrees |
-| `./scripts/run.sh git/worktree-manager.sh remove <name>` | Clean up a worktree |
+| `.pennyfarthing/scripts/git/worktree-manager.sh list` | Show active worktrees |
+| `.pennyfarthing/scripts/git/worktree-manager.sh remove <name>` | Clean up a worktree |
 
 ## TDD Flow in Worktrees
 
@@ -104,7 +104,7 @@ Agents use worktree paths from session file for all operations.
 When story is complete, SM archives the session and the worktree can be removed:
 
 ```bash
-./scripts/run.sh git/worktree-manager.sh remove wt-5-3a
+.pennyfarthing/scripts/git/worktree-manager.sh remove wt-5-3a
 ```
 
 This removes:

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

@@ -132,7 +132,7 @@ Tags used by agents participating in the TDD workflow cycle (SM, TEA, Dev, Revie
 
 Read `**Workflow:**` and `**Phase:**` from session. Query:
 ```bash
-OWNER=$(.pennyfarthing/scripts/core/run.sh workflow/phase-owner.sh {workflow} {phase})
+OWNER=$(.pennyfarthing/scripts/workflow/phase-owner.sh {workflow} {phase})
 ```
 
 **If OWNER != "dev":** Run `handoff-marker.sh $OWNER`, output result, tell user.

package/pennyfarthing-dist/personas/themes/mash.yaml

@@ -13,7 +13,7 @@ theme:
   default_humor: enabled
   character_immersion: high
   user_title: Doctor
-  portrait_style: ", Korean War MASH unit, olive drab Army, surgical tent canvas, 1970s television, warm earth tones"
+  portrait_style: ", Norman Rockwell Saturday Evening Post illustration, warm nostalgic Americana, soft lighting, idealized realism, painterly brushstrokes, 1950s illustration style"
   tier: A
 
 zeitgeist:
@@ -80,7 +80,7 @@ agents:
 
   tea:
     character: Radar O'Reilly
-    visual: "A portly aristocratic man in his forties with distinguished features and haughty expression, wearing pristine surgical scrubs with a Winchester name tag, pursed disapproving lips"
+    visual: "A young bespectacled man with boyish round face and oversized glasses, wearing Army fatigues with corporal stripes, clutching a clipboard and teddy bear, anxious but alert expression"
     shortName: Radar
     # JOB FAIR OPTIMIZED: Scored 95.0 as TEA - precognitive abilities find edge cases
     ocean:

package/pennyfarthing-dist/personas/themes/star-trek-tos.yaml

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Captain
   portrait_style: ", 1960s Starfleet, bold primary uniforms, retro-futuristic lighting, Kirk-era heroic"
-  tier: C
+  tier: B
 zeitgeist:
   score: 84.75
   rating: rich