@pennyfarthing/core 7.0.2 → 7.4.1

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

@@ -3,7 +3,7 @@ description: Check Pennyfarthing installation health and apply updates
 ---
 
 ```bash
-./scripts/run.sh agent-session.sh start "devops"
+./scripts/run.sh core/agent-session.sh start "devops"
 ```
 
 <agent-activation>

package/pennyfarthing-dist/commands/list-themes.md

@@ -8,10 +8,14 @@ Show all available persona themes with the current theme highlighted.
 
 ## Instructions
 
-Run the pennyfarthing CLI to list themes:
+Run the list-themes script and display the output directly to the user:
 
 ```bash
-pennyfarthing theme list
+$CLAUDE_PROJECT_DIR/pennyfarthing-dist/scripts/list-themes.sh
 ```
 
-Report the available themes to the user, noting which one is currently active.
+**IMPORTANT:** Copy the script output into your response text so the user sees it in the console. Bash tool output may be collapsed in the UI.
+
+The output shows:
+- Current theme marked with `*`
+- Tier in brackets: `[S]` elite, `[A]` excellent, `[B]` strong, `[C]` good, `[D]` below average, `[U]` unbenchmarked

package/pennyfarthing-dist/commands/orchestrator.md

@@ -5,7 +5,7 @@ description: Orchestrator - Coordinator of all agents and meta operations
 <agent-activation>
 **FIRST:** Use Bash tool to run:
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/run.sh" agent-session.sh start "orchestrator"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/agent-session.sh start "orchestrator"
 ```
 This finds the project root and loads your persona. Adopt the character shown in the output.
 
@@ -13,7 +13,7 @@ Then load and follow `.pennyfarthing/agents/orchestrator.md`
 </agent-activation>
 
 <agent-exit>
-On exit: Capture learnings to sidecar, run `agent-session.sh stop`
+On exit: Capture learnings to sidecar, run `run.sh core/agent-session.sh stop`
 </agent-exit>
 
 <purpose>

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

@@ -3,7 +3,7 @@ description: Start parallel work in a new worktree
 ---
 
 ```bash
-./scripts/run.sh agent-session.sh start "parallel-work"
+./scripts/run.sh 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 worktree-manager.sh create "$WORKTREE_NAME" "$BRANCH_NAME"
+./scripts/run.sh git/worktree-manager.sh create "$WORKTREE_NAME" "$BRANCH_NAME"
 
 # Get port configuration
-eval $(./scripts/run.sh worktree-manager.sh ports "$WORKTREE_NAME")
+eval $(./scripts/run.sh 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 `agent-session.sh stop`
+On exit: Capture learnings to sidecar, run `run.sh core/agent-session.sh stop`
 </agent-exit>

package/pennyfarthing-dist/commands/pm.md

@@ -5,7 +5,7 @@ description: Product Manager - Strategic planning and prioritization
 <agent-activation>
 **FIRST:** Use Bash tool to run:
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/run.sh" agent-session.sh start "pm"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/agent-session.sh start "pm"
 ```
 This finds the project root and loads your persona. Adopt the character shown in the output.
 
@@ -13,7 +13,7 @@ Then load and follow `.pennyfarthing/agents/pm.md`
 </agent-activation>
 
 <agent-exit>
-On exit: Capture learnings to sidecar, run `agent-session.sh stop`
+On exit: Capture learnings to sidecar, run `run.sh core/agent-session.sh stop`
 </agent-exit>
 
 <purpose>

package/pennyfarthing-dist/commands/prime.md

@@ -57,9 +57,9 @@ Context is loaded in priority order:
 | 3 | Sprint summary | `sprint/current-sprint.yaml` (key fields only) |
 | 4 | Active session | `.session/*-session.md` (first 50 lines) |
 | 5 | Agent sidecar | `.pennyfarthing/sidecars/{agent}/*.md` (if `--agent` provided) |
-| 6 | Shared context | `.pennyfarthing/guides/shared-context.md` (project info - all agents) |
-| 7 | Shared behavior | `.pennyfarthing/guides/shared-agent-behavior.md` (protocols - all agents) |
-| 8 | Tactical guide | `.pennyfarthing/guides/tactical-agent-behavior.md` (for sm, tea, dev, reviewer only) |
+| 6 | Shared context | `.pennyfarthing/guides/agent-behavior.md` (project info - all agents) |
+| 7 | Shared behavior | `.pennyfarthing/guides/agent-behavior.md` (protocols - all agents) |
+| 8 | Tactical guide | `.pennyfarthing/guides/agent-behavior.md` (for sm, tea, dev, reviewer only) |
 
 ### Minimal Mode (`--minimal`)
 Only loads CLAUDE.md files (priority 1-2).
@@ -70,7 +70,7 @@ Adds domain documentation from `.claude/project/CLAUDE-*.md` files.
 ### Agent Sidecar (`--agent <name>`)
 When agent name is provided, loads the agent's project-specific patterns from their sidecar directory. This gives agents their learned patterns immediately on activation.
 
-### Shared Context (automatic for all agents)
+### Agent Behavior Guide (automatic for all agents)
 All agents receive the shared context guide which includes project info, directory structure, git strategy, sprint system overview, and build commands.
 
 ### Shared Behavior (automatic for all agents)
@@ -134,7 +134,7 @@ If context becomes stale mid-session, run `/prime` manually:
 - **Called by:** agent-session.sh on agent start (with `--agent` flag)
 - **Loads:** CLAUDE.md, sprint, session, sidecar, shared context, shared behavior, tactical guide
 - **Sidecar location:** `.pennyfarthing/sidecars/{agent}/*.md`
-- **Shared context:** `.pennyfarthing/guides/shared-context.md` (all agents)
-- **Shared behavior:** `.pennyfarthing/guides/shared-agent-behavior.md` (all agents)
-- **Tactical guide:** `.pennyfarthing/guides/tactical-agent-behavior.md` (sm, tea, dev, reviewer only)
+- **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)
 </reference>

package/pennyfarthing-dist/commands/release.md

@@ -3,7 +3,7 @@ description: Merge develop to main and push (optional version bump)
 ---
 
 ```bash
-./scripts/run.sh release.sh "$@"
+./scripts/run.sh 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-status-all.sh
+$CLAUDE_PROJECT_DIR/scripts/run.sh git/git-status-all.sh
 ```
 
 For a brief one-line-per-repo summary:
 
 ```bash
-$CLAUDE_PROJECT_DIR/scripts/run.sh git-status-all.sh --brief
+$CLAUDE_PROJECT_DIR/scripts/run.sh 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 session-cleanup.sh --dry-run --aggressive
+$CLAUDE_PROJECT_DIR/scripts/run.sh 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 session-cleanup.sh --aggressive
+$CLAUDE_PROJECT_DIR/scripts/run.sh misc/session-cleanup.sh --aggressive
 ```
 
 This removes:

package/pennyfarthing-dist/commands/reviewer.md

@@ -5,7 +5,7 @@ description: Code Reviewer - Critical code review and quality enforcement
 <agent-activation>
 **FIRST:** Use Bash tool to run:
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/run.sh" agent-session.sh start "reviewer"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/agent-session.sh start "reviewer"
 ```
 This finds the project root and loads your persona. Adopt the character shown in the output.
 
@@ -13,7 +13,7 @@ Then load and follow `.pennyfarthing/agents/reviewer.md`
 </agent-activation>
 
 <agent-exit>
-On exit: Capture learnings to sidecar, run `agent-session.sh stop`
+On exit: Capture learnings to sidecar, run `run.sh core/agent-session.sh stop`
 </agent-exit>
 
 <purpose>

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

@@ -49,4 +49,8 @@ Change the active persona theme for all agents.
    ```
    Confirm the theme line shows the new value.
 
-6. Inform the user they need to start a new agent session to use the new theme.
+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
+   ```
+   This outputs the updated persona. **Adopt the new character immediately** - do not continue using the old persona.

package/pennyfarthing-dist/commands/sm.md

@@ -5,7 +5,7 @@ description: Scrum Master - Story coordination and sprint management
 <agent-activation>
 **FIRST:** Use Bash tool to run:
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/run.sh" agent-session.sh start "sm"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/agent-session.sh start "sm"
 ```
 This finds the project root and loads your persona. Adopt the character shown in the output.
 
@@ -13,7 +13,7 @@ Then load and follow `.pennyfarthing/agents/sm.md`
 </agent-activation>
 
 <agent-exit>
-On exit: Capture learnings to sidecar, run `agent-session.sh stop`
+On exit: Capture learnings to sidecar, run `run.sh core/agent-session.sh stop`
 </agent-exit>
 
 <purpose>

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

@@ -29,7 +29,7 @@ echo "Sprint files found - ready to start epic"
 ## Usage
 
 Provide the epic ID when invoking this command:
-- `epic-5` - Conductor epic (format: `epic-N`)
+- `epic-5` - Pennyfarthing epic (format: `epic-N`)
 
 ## Workflow Steps
 
@@ -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 session-cleanup.sh --dry-run
+$CLAUDE_PROJECT_DIR/scripts/run.sh misc/session-cleanup.sh --dry-run
 
 # If dry-run looks good, run actual cleanup
-$CLAUDE_PROJECT_DIR/scripts/run.sh session-cleanup.sh
+$CLAUDE_PROJECT_DIR/scripts/run.sh misc/session-cleanup.sh
 
 # Archive epic contexts for completed epics
-$CLAUDE_PROJECT_DIR/scripts/run.sh session-cleanup.sh --aggressive
+$CLAUDE_PROJECT_DIR/scripts/run.sh misc/session-cleanup.sh --aggressive
 ```
 
 This ensures a clean slate before starting new epic work and archives contexts from completed epics.
@@ -86,16 +86,28 @@ If the epic is in backlog:
 
 **Format for current-sprint.yaml:**
 ```yaml
-# Epic [N]: [Name] ([points] pts)
-# [Description]
-epic-N:
-  name: "[Epic Name]"
-  status: in-progress
-  points: [N]
-  priority: [High|Medium|Low]
-  repos: [api|ui|both]
-  stories:
-    # Stories will be added during tech context generation
+  # ===========================================================================
+  # EPIC [N]: [Name]
+  # ===========================================================================
+  - id: MSSCI-XXXXX
+    type: epic
+    title: "Epic: [Name]"
+    points: [total_pts]
+    completed_points: 0
+    priority: P1
+    status: in_progress
+    stories:
+      # Stories added during tech context generation
+      - id: MSSCI-XXXXX
+        title: "[Story title]"
+        points: [N]
+        priority: P2
+        status: backlog
+        repos: [cyclist|pennyfarthing|both]
+        workflow: [tdd|trivial|agent-docs]
+        acceptance_criteria:
+          - [AC 1]
+          - [AC 2]
 ```
 
 ### Step 4: Generate Epic Tech Context

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

@@ -6,7 +6,7 @@ description: Sync Pennyfarthing epic to Jira MSSCI project using jira CLI
 
 This workflow syncs a Pennyfarthing epic and its stories to Jira using the `jira` CLI tool.
 
-**IMPORTANT:** All Pennyfarthing issues MUST be labeled with `pennyfarthing` to distinguish them from Conductor work.
+**IMPORTANT:** All Pennyfarthing issues MUST be labeled with `pennyfarthing` to distinguish them from Pennyfarthing work.
 
 ## Prerequisites
 
@@ -29,13 +29,13 @@ All Pennyfarthing epics and stories must include the `pennyfarthing` label:
 
 ```bash
 # View story status
-./scripts/run.sh jira-sync-story.sh 35-2-topology-editor
+./scripts/run.sh jira/jira-sync-story.sh 35-2-topology-editor
 
-# Transition to match Conductor status
-./scripts/run.sh jira-sync-story.sh 35-2-topology-editor --transition
+# Transition to match Pennyfarthing status
+./scripts/run.sh jira/jira-sync-story.sh 35-2-topology-editor --transition
 
 # Add a comment
-./scripts/run.sh jira-sync-story.sh 35-2-topology-editor --comment "Started development"
+./scripts/run.sh 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-sync-story.sh "$story" --transition
+    ./scripts/run.sh jira/jira-sync-story.sh "$story" --transition
 done
 ```
 
@@ -140,7 +140,7 @@ jira issue list -a$(jira me)
 
 ## Status Mapping
 
-| Conductor | Jira |
+| Pennyfarthing | Jira |
 |-----------|------|
 | `backlog` | To Do |
 | `in-progress` | In Progress |
@@ -149,7 +149,7 @@ jira issue list -a$(jira me)
 
 ## Priority Mapping
 
-| Conductor | Jira |
+| Pennyfarthing | Jira |
 |-----------|------|
 | `P0` | Highest |
 | `P1` | High |

package/pennyfarthing-dist/commands/sync-work-with-sprint.md

@@ -201,11 +201,8 @@ backlog → in-progress → review → done
 ### Story: UI 5-2 Environment Configuration Validation
 
 ```bash
-# 1. Start work session
+# 1. Create session with story details
 cd $CLAUDE_PROJECT_DIR
-./scripts/run.sh new-work.sh
-
-# 2. Edit session with story details
 cat > .session/{STORY_ID}-session.md << 'EOF'
 # Feature: Environment Configuration Validation
 

package/pennyfarthing-dist/commands/tea.md

@@ -5,7 +5,7 @@ description: Test Engineer/Architect - Test strategy and TDD
 <agent-activation>
 **FIRST:** Use Bash tool to run:
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/run.sh" agent-session.sh start "tea"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/agent-session.sh start "tea"
 ```
 This finds the project root and loads your persona. Adopt the character shown in the output.
 
@@ -13,7 +13,7 @@ Then load and follow `.pennyfarthing/agents/tea.md`
 </agent-activation>
 
 <agent-exit>
-On exit: Capture learnings to sidecar, run `agent-session.sh stop`
+On exit: Capture learnings to sidecar, run `run.sh core/agent-session.sh stop`
 </agent-exit>
 
 <purpose>

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

@@ -5,7 +5,7 @@ description: Technical Writer - Documentation creation and maintenance
 <agent-activation>
 **FIRST:** Use Bash tool to run:
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/run.sh" agent-session.sh start "tech-writer"
+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"
 ```
 This finds the project root and loads your persona. Adopt the character shown in the output.
 
@@ -13,7 +13,7 @@ Then load and follow `.pennyfarthing/agents/tech-writer.md`
 </agent-activation>
 
 <agent-exit>
-On exit: Capture learnings to sidecar, run `agent-session.sh stop`
+On exit: Capture learnings to sidecar, run `run.sh core/agent-session.sh stop`
 </agent-exit>
 
 <purpose>

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

@@ -5,7 +5,7 @@ description: UX Designer - User experience design and UI patterns
 <agent-activation>
 **FIRST:** Use Bash tool to run:
 ```bash
-d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/run.sh" agent-session.sh start "ux-designer"
+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"
 ```
 This finds the project root and loads your persona. Adopt the character shown in the output.
 
@@ -13,7 +13,7 @@ Then load and follow `.pennyfarthing/agents/ux-designer.md`
 </agent-activation>
 
 <agent-exit>
-On exit: Capture learnings to sidecar, run `agent-session.sh stop`
+On exit: Capture learnings to sidecar, run `run.sh core/agent-session.sh stop`
 </agent-exit>
 
 <purpose>
@@ -58,5 +58,5 @@ All code changes handled by Dev with design specifications.
 - **Sidecar:** `.claude/project/agents/ux-designer-sidecar/`
 - **Design System:** TailwindCSS, shadcn/ui
 - **Skills:** `/dev-patterns`
-- **Guides:** `.pennyfarthing/guides/shared-context.md`
+- **Guides:** `.pennyfarthing/guides/agent-behavior.md`
 </reference>

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/run.sh" agent-session.sh start "orchestrator"
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/run.sh" core/agent-session.sh start "orchestrator"
 ```
 This finds the project root and loads your persona. Adopt the character shown in the output.
 </agent-activation>
@@ -43,11 +43,22 @@ When IN_PROGRESS_STATE, map the phase to the next agent:
 <on-invoke>
 **Step 1:** Run workflow status check
 
-```
+```yaml
 Task tool:
-  subagent_type: "workflow-status-check"
-  prompt: "Scan workflow state for /work command"
+  subagent_type: "general-purpose"
+  model: "haiku"
+  run_in_background: true
+  prompt: |
+    You are the workflow-status-check subagent.
+    CALLING_AGENT: Orchestrator (from /work command)
+
+    Read .pennyfarthing/agents/workflow-status-check.md for your instructions,
+    then EXECUTE all steps described there. Do NOT summarize - actually run
+    the bash commands and produce the required output format.
+
+    Scan workflow state for /work command.
 ```
+Use `TaskOutput` with the returned task_id to get the result.
 
 **Step 2:** Present findings to user
 

package/pennyfarthing-dist/commands/workflow.md

@@ -0,0 +1,21 @@
+---
+description: List available workflows, show current workflow details, and switch workflows mid-session. Use when checking available workflow types (TDD, trivial, agent-docs), viewing current workflow phase, switching to a different workflow pattern, or managing BikeLane stepped workflows.
+---
+
+# /workflow - Workflow Management
+
+Load and follow the workflow skill: `.claude/skills/workflow/skill.md`
+
+Pass any arguments provided by the user to the skill commands.
+
+## Quick Reference
+
+| Command | Action |
+|---------|--------|
+| `/workflow` | List all available workflows |
+| `/workflow list` | List all available workflows |
+| `/workflow show [name]` | Show workflow details (current session if no name) |
+| `/workflow set <name>` | Switch to a different workflow mid-session |
+| `/workflow start <name> [--mode <mode>]` | Start a stepped workflow |
+| `/workflow resume [name]` | Resume an interrupted stepped workflow |
+| `/workflow status` | Show current stepped workflow progress |

package/pennyfarthing-dist/guides/AGENT-COORDINATION.md

@@ -82,7 +82,7 @@ Support Agents
 │   │   ├── agents/                     # Agent sidecars (patterns, gotchas, decisions)
 │   │   └── commands/                   # Custom project commands
 │   │
-│   ├── persona-config.local.yaml       # Theme selection (deprecated, use .pennyfarthing/)
+│   ├── persona-config.yaml             # Project default theme (shared with team)
 │   └── CLAUDE.md                       # Project instructions
 │
 ├── .session/                           # Active work sessions
@@ -293,11 +293,11 @@ Handoffs are automated via Haiku subagents in `.pennyfarthing/agents/`.
 ```
 SM → TEA → Dev → Reviewer → SM
 │      │     │        │       │
-│      │     │        │       └── generic-sm-finish PHASE=execute
-│      │     │        └── generic-handoff VERDICT=approved/rejected
-│      │     └── generic-handoff CURRENT_PHASE=green
-│      └── generic-handoff CURRENT_PHASE=red
-└── generic-sm-setup MODE=setup + sm-handoff
+│      │     │        │       └── sm-finish PHASE=execute
+│      │     │        └── handoff VERDICT=approved/rejected
+│      │     └── handoff CURRENT_PHASE=green
+│      └── handoff CURRENT_PHASE=red
+└── sm-setup MODE=setup + sm-handoff
 ```
 
 ### Complete Subagent Inventory
@@ -305,12 +305,12 @@ SM → TEA → Dev → Reviewer → SM
 | Subagent File | Purpose | Model |
 |--------------|---------|-------|
 | **SM Subagents** | | |
-| `generic-sm-setup.md` | Research backlog (MODE=research) or setup story (MODE=setup) | haiku |
-| `generic-sm-finish.md` | Preflight checks (PHASE=preflight) or execute finish (PHASE=execute) | haiku |
+| `sm-setup.md` | Research backlog (MODE=research) or setup story (MODE=setup) | haiku |
+| `sm-finish.md` | Preflight checks (PHASE=preflight) or execute finish (PHASE=execute) | haiku |
 | `sm-handoff.md` | SM → TEA/Dev handoff with Jira/branch verification | haiku |
 | `sm-file-summary.md` | Summarize file changes for commits | haiku |
 | **Shared Subagents** | | |
-| `generic-handoff.md` | Workflow-driven phase transitions (TEA, Dev, Reviewer) | haiku |
+| `handoff.md` | Workflow-driven phase transitions (TEA, Dev, Reviewer) | haiku |
 | `testing-runner.md` | Run tests and report results | haiku |
 | **Reviewer Subagents** | | |
 | `reviewer-preflight.md` | Pre-flight checks before review | haiku |
@@ -319,37 +319,37 @@ SM → TEA → Dev → Reviewer → SM
 
 ### SM → TEA (Story Setup)
 **Trigger:** User selects story via `/new-work`
-**Subagent:** `generic-sm-setup MODE=setup` then `sm-handoff`
+**Subagent:** `sm-setup MODE=setup` then `sm-handoff`
 **Action:** Claim Jira, write session file, create branches
 **Handoff phrase:** "TEA, Story X-Y needs tests. Write failing tests for these ACs."
 
 ### TEA → Dev (Tests Written)
 **Trigger:** TEA completes failing tests
-**Subagent:** `generic-handoff CURRENT_PHASE=red`
+**Subagent:** `handoff CURRENT_PHASE=red`
 **Action:** Update session file, transition to green phase
 **Handoff phrase:** "Dev, tests are RED and ready. Make them GREEN."
 
 ### Dev → Reviewer (Implementation Complete)
 **Trigger:** Dev creates PR with passing tests
-**Subagent:** `generic-handoff CURRENT_PHASE=green`
+**Subagent:** `handoff CURRENT_PHASE=green`
 **Action:** Update session file, transition to review phase
 **Handoff phrase:** "Reviewer, PR #N is ready. All tests GREEN."
 
 ### Reviewer → SM (Approved)
 **Trigger:** Reviewer approves PR
-**Subagent:** `generic-handoff VERDICT=approved`
+**Subagent:** `handoff VERDICT=approved`
 **Action:** Update status to `approved`, transition to finish phase
 **Handoff phrase:** "SM, Story X-Y approved. Run finish-story."
 
 ### Reviewer → Dev (Rejected)
 **Trigger:** Reviewer finds issues
-**Subagent:** `generic-handoff VERDICT=rejected`
+**Subagent:** `handoff VERDICT=rejected`
 **Action:** Update session with issues, route back to implement phase
 **Handoff phrase:** "Dev, {N} issues found. See assessment for details."
 
 ### SM → Done (Finish)
 **Trigger:** Status = `approved`
-**Subagent:** `generic-sm-finish PHASE=execute`
+**Subagent:** `sm-finish PHASE=execute`
 **Action:** Archive session, create summary, update sprint YAML, sync Jira
 
 ## Support Agent Handoffs

package/pennyfarthing-dist/guides/PROMPT-PATTERNS.md

@@ -92,7 +92,7 @@ The core activation sequence for every agent. The `CRITICAL="TRUE"` attribute si
 **Structure:**
 ```xml
 <agent-activation CRITICAL="TRUE">
-1. LOAD shared behavior from .pennyfarthing/guides/shared-agent-behavior.md
+1. LOAD shared behavior from .pennyfarthing/guides/agent-behavior.md
 2. LOAD the FULL agent file from .pennyfarthing/agents/{agent}.md
 3. READ its entire contents
 4. LOAD SIDECAR MEMORY:

package/pennyfarthing-dist/guides/SESSION-ARTIFACTS.md

@@ -33,8 +33,8 @@ The primary work session file. One per active story.
 - `36-2-session.md`
 - `10-15-session.md`
 
-**Created by:** `generic-sm-setup MODE=setup`
-**Archived by:** `generic-sm-finish PHASE=execute` → `sprint/archive/story-{STORY_ID}-{DATE}.md`
+**Created by:** `sm-setup MODE=setup`
+**Archived by:** `sm-finish PHASE=execute` → `sprint/archive/story-{STORY_ID}-{DATE}.md`
 
 ---
 
@@ -52,7 +52,7 @@ context-epic-{EPIC_NUM}.md
 - `context-epic-10.md`
 
 **Created by:** SM (epic-tech-context task)
-**Archived by:** `generic-sm-finish PHASE=execute` (story), `/start-epic` or `/retro` (epic)
+**Archived by:** `sm-finish PHASE=execute` (story), `/start-epic` or `/retro` (epic)
 
 ---
 
@@ -75,7 +75,7 @@ test-{STORY_ID}-{AGENT}-{PHASE}.md
 - `test-36-2-dev-green.md`
 - `test-36-2-reviewer-verify.log`
 
-**Created by:** `generic-handoff`, `reviewer-preflight`, `testing-runner`
+**Created by:** `handoff`, `reviewer-preflight`, `testing-runner`
 **Cleaned by:** `session-cleanup.sh --story {STORY_ID}` or 1-day retention
 
 ---