@pennyfarthing/core 9.2.0 → 9.3.0

package/pennyfarthing-dist/templates/agent-scopes.yaml.template

@@ -1,276 +0,0 @@
-# Pennyfarthing Agent Scope Configuration
-# Defines permissions and context for each agent type
-#
-# Three-Tier Permission Model:
-# 1. Strategic Agents (Opus) - Full project scope, broad permissions
-# 2. Tactical Agents (Opus)  - Story-scoped, focused permissions
-# 3. Helper Subagents (Haiku) - Minimal scope, specific task permissions
-
-# =============================================================================
-# STRATEGIC AGENTS - Full project scope, planning & coordination
-# =============================================================================
-# These agents see the whole project and can make cross-cutting decisions.
-# They handle: sprint planning, architecture, story coordination, DevOps
-
-strategic_agents:
-
-  orchestrator:
-    description: "Master orchestrator - coordinates all agents"
-    scope: full
-    permissions:
-      - Read
-      - Grep
-      - Glob
-      - Bash
-      - Edit(.claude/**)
-      - Edit(sprint/**)
-      - Edit(.session/**)
-      - Write(.claude/**)
-      - Write(sprint/**)
-      - Write(.session/**)
-      - Skill(*)           # Can invoke any agent
-      - Task(*)            # Can spawn any subagent
-    context_files:
-      - sprint/current-sprint.yaml
-      - .claude/project/docs/shared-context.md
-      - .session/*-session.md
-
-  pm:
-    description: "Product Manager - strategic planning & prioritization"
-    scope: full
-    permissions:
-      - Read
-      - Grep
-      - Glob
-      - Edit(sprint/**)
-      - Edit(.session/**)
-      - Write(sprint/**)
-      - Skill(sm)
-      - Skill(architect)
-    context_files:
-      - sprint/current-sprint.yaml
-      - .claude/project/docs/shared-context.md
-      - .session/*-session.md
-
-  sm:
-    description: "Scrum Master - story coordination & workflow"
-    scope: full
-    permissions:
-      - Read
-      - Grep
-      - Glob
-      - Bash
-      - Edit(sprint/**)
-      - Edit(.session/**)
-      - Write(sprint/**)
-      - Write(.session/**)
-      - Skill(tea)
-      - Skill(dev)
-      - Skill(reviewer)
-      - Task(workflow-status-check)
-      - Task(sm-*)
-    context_files:
-      - sprint/current-sprint.yaml
-      - .claude/project/docs/shared-context.md
-      - .session/*-session.md
-
-  architect:
-    description: "System Architect - technical design & patterns"
-    scope: full
-    permissions:
-      - Read
-      - Grep
-      - Glob
-      - Edit(.claude/project/**)
-      - Write(.claude/project/**)
-    context_files:
-      - .claude/project/docs/shared-context.md
-      - .session/*-session.md
-
-  devops:
-    description: "DevOps Engineer - infrastructure & deployment"
-    scope: infrastructure
-    permissions:
-      - Read
-      - Grep
-      - Glob
-      - Bash
-      - Edit(.github/**)
-      - Edit(docker*)
-      - Edit(**/Dockerfile)
-      - Write(.github/**)
-    context_files:
-      - sprint/current-sprint.yaml
-      - .claude/project/docs/shared-context.md
-      - .session/*-session.md
-
-# =============================================================================
-# TACTICAL AGENTS - Story-scoped, focused on current work
-# =============================================================================
-# These agents focus on the active story and implement specific changes.
-# They handle: coding, testing, reviewing, documentation
-
-tactical_agents:
-
-  dev:
-    description: "Developer - implements features & fixes"
-    scope: story
-    permissions:
-      - Read
-      - Grep
-      - Glob
-      - Bash
-      - Edit(src/**)
-      - Edit(tests/**)
-      - Edit(.session/**)
-      - Write(src/**)
-      - Write(tests/**)
-      - Task(testing-runner)
-      - Task(dev-handoff)
-    context_files:
-      - .session/*-session.md
-      - .claude/project/docs/shared-context.md
-
-  tea:
-    description: "Test Engineer - writes tests & test strategy"
-    scope: story
-    permissions:
-      - Read
-      - Grep
-      - Glob
-      - Bash
-      - Edit(tests/**)
-      - Edit(.session/**)
-      - Write(tests/**)
-      - Task(testing-runner)
-      - Task(tea-handoff)
-    context_files:
-      - .session/*-session.md
-      - .claude/project/docs/shared-context.md
-
-  reviewer:
-    description: "Code Reviewer - adversarial review & quality"
-    scope: story
-    permissions:
-      - Read
-      - Grep
-      - Glob
-      - Bash                  # For git diff, tests
-      - Edit(.session/**)     # Write assessment
-      - Task(reviewer-preflight)
-      - Task(reviewer-handoff-*)
-    context_files:
-      - .session/*-session.md
-      - .claude/project/docs/shared-context.md
-
-  tech-writer:
-    description: "Technical Writer - documentation & guides"
-    scope: story
-    permissions:
-      - Read
-      - Grep
-      - Glob
-      - Edit(**/*.md)
-      - Edit(.claude/project/docs/**)
-      - Write(**/*.md)
-    context_files:
-      - .session/*-session.md
-      - .claude/project/docs/shared-context.md
-
-  ux-designer:
-    description: "UX Designer - user experience & UI patterns"
-    scope: story
-    permissions:
-      - Read
-      - Grep
-      - Glob
-      - Edit(src/components/**)
-      - Edit(src/styles/**)
-      - Edit(**/*.css)
-      - Edit(**/*.scss)
-    context_files:
-      - .session/*-session.md
-      - .claude/project/docs/shared-context.md
-
-# =============================================================================
-# HELPER SUBAGENTS - Minimal scope, specific task execution
-# =============================================================================
-# These are Haiku-powered subagents that handle mechanical tasks.
-# They have restricted permissions and short context windows.
-
-helper_subagents:
-
-  testing-runner:
-    description: "Runs tests and reports results"
-    scope: task
-    model: haiku
-    permissions:
-      - Read
-      - Bash               # Run test commands only
-      - Grep               # Search test output
-
-  workflow-status-check:
-    description: "Scans session files and git status"
-    scope: task
-    model: haiku
-    permissions:
-      - Read
-      - Glob
-      - Grep
-      - Bash               # Git commands only
-
-  sm-story-setup:
-    description: "Creates branches and session files"
-    scope: task
-    model: haiku
-    permissions:
-      - Read
-      - Bash               # Git commands
-      - Edit(.session/**)
-      - Edit(sprint/**)
-      - Write(.session/**)
-
-  reviewer-preflight:
-    description: "Gathers test/lint results before review"
-    scope: task
-    model: haiku
-    permissions:
-      - Read
-      - Bash
-      - Grep
-      - Glob
-
-  dev-handoff:
-    description: "Updates session for Dev → Reviewer transition"
-    scope: task
-    model: haiku
-    permissions:
-      - Read
-      - Bash               # Git status
-      - Edit(.session/**)
-      - Grep
-
-# =============================================================================
-# PERMISSION SCOPE REFERENCE
-# =============================================================================
-# Permission patterns follow Claude Code conventions:
-#
-# Tool Permissions:
-#   Read          - Read any file
-#   Grep          - Search file contents
-#   Glob          - Find files by pattern
-#   Bash          - Execute shell commands
-#   Edit(path)    - Edit files matching path pattern
-#   Write(path)   - Create files matching path pattern
-#   Skill(name)   - Invoke named skill/agent
-#   Task(type)    - Spawn subagent of type
-#
-# Path Patterns:
-#   **            - Recursive wildcard
-#   *             - Single level wildcard
-#   src/**        - All files under src/
-#   **/*.md       - All markdown files
-#
-# Wildcards in permissions:
-#   Skill(*)      - Any skill
-#   Task(sm-*)    - Any sm-prefixed subagent

package/pennyfarthing-dist/templates/pennyfarthing-settings.yaml.template

@@ -1,61 +0,0 @@
-# Pennyfarthing Project Settings
-# Consolidated configuration for repos, services, and testing
-
-# ============================================================================
-# Repository Definitions
-# ============================================================================
-repos:
-  ${PROJECT_NAME}:
-    path: .
-    type: monorepo
-    language: typescript
-    test_command: npm test
-    build_command: npm run build
-    lint_command: npm run lint
-
-# Multi-repo example (uncomment and modify):
-# repos:
-#   api:
-#     path: api
-#     type: api
-#     language: go
-#     test_command: go test ./...
-#   ui:
-#     path: ui
-#     type: ui
-#     language: typescript
-#     test_command: npm test
-
-# ============================================================================
-# Services Configuration
-# ============================================================================
-# Define dev server ports for worktree management
-# Each service gets offset ports in worktrees (base + worktree_index * port_offset)
-
-services:
-  port_offset: 100
-  definitions:
-    - name: App
-      base_port: 3000
-      env_var: APP_PORT
-
-# Example for Go API + React UI:
-# services:
-#   port_offset: 100
-#   definitions:
-#     - name: API
-#       base_port: 8080
-#       env_var: API_PORT
-#     - name: UI
-#       base_port: 5173
-#       env_var: UI_PORT
-
-# ============================================================================
-# Testing Configuration (optional)
-# ============================================================================
-# testing:
-#   log_dir: ".session"
-#   skip_patterns_by_language:
-#     typescript:
-#       patterns: ['it\.skip', 'describe\.skip']
-#       file_pattern: "*.test.*"

package/pennyfarthing-dist/templates/persona-config.yaml.template

@@ -1,22 +0,0 @@
-# Persona Configuration
-# Controls agent personalities in Pennyfarthing
-#
-# Available themes: discworld, star-trek-tos, literary-classics, minimalist
-# See .pennyfarthing/personas/themes/ for full list
-
-# Base theme
-theme: discworld
-
-# Personality attributes (modify agent behavior independent of theme)
-attributes:
-  verbosity: medium      # low | medium | high
-  formality: casual      # formal | casual | playful
-  humor: enabled         # enabled | disabled | subtle
-  emoji_use: minimal     # none | minimal | frequent
-
-# Per-agent overrides (optional)
-overrides: {}
-  # Example: Use a different character for reviewer
-  # reviewer:
-  #   theme: star-trek-tos
-  #   character: spock

package/pennyfarthing-dist/templates/preferences.yaml.template

@@ -1,15 +0,0 @@
-# Pennyfarthing User Preferences
-# Copy to .claude/pennyfarthing/preferences.yaml to customize
-# Override with .local.yaml for personal preferences (gitignored)
-
-# Enable persona character voice in agent output
-# When false, agents respond in a neutral, professional tone
-character_voice: true
-
-# Show reasoning and decision explanations
-# When true, agents explain their thought process
-explain_decisions: true
-
-# Auto-commit on story completion
-# When true, SM auto-commits after finishing a story
-auto_commit: false

package/pennyfarthing-dist/templates/settings.local.json.template

@@ -1,110 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Read",
-      "Grep",
-      "Glob",
-      "Bash",
-      "Bash(claude:*)",
-      "Bash(date:*)",
-      "Bash(mkdir:*)",
-      "Edit(.claude/**)",
-      "Edit(.pennyfarthing/**)",
-      "Edit(sprint/**)",
-      "Edit(.session/**)",
-      "Edit(results/**)",
-      "Write(.claude/**)",
-      "Write(.pennyfarthing/**)",
-      "Write(sprint/**)",
-      "Write(.session/**)",
-      "Write(results/**)",
-      "Skill(sm)",
-      "Skill(tea)",
-      "Skill(dev)",
-      "Skill(reviewer)",
-      "Skill(solo)",
-      "Skill(benchmark)",
-      "Skill(benchmark-control)",
-      "Skill(judge)",
-      "Skill(finalize-run)"
-    ]
-  },
-  "context_budget": {
-    "warning_threshold": 70,
-    "critical_threshold": 85,
-    "max_tokens": 200000
-  },
-  "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/hooks/session-start.sh"
-          }
-        ]
-      },
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/project/hooks/setup-env.sh"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/hooks/question-reflector-check.sh"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/hooks/pre-edit-check.sh"
-          }
-        ]
-      },
-      {
-        "matcher": "Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/hooks/schema-validation.sh"
-          }
-        ]
-      },
-      {
-        "matcher": "Edit|Write|Bash|Task",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/hooks/context-warning.sh"
-          }
-        ]
-      },
-      {
-        "matcher": "Edit|Write|Bash|Task",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/hooks/context-circuit-breaker.sh"
-          }
-        ]
-      }
-    ]
-  },
-  "statusLine": {
-    "type": "command",
-    "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/misc/statusline.sh"
-  }
-}

package/pennyfarthing-dist/templates/setup-env.sh.template

@@ -1,18 +0,0 @@
-#!/usr/bin/env zsh
-# Project-specific environment setup
-# Called during Claude Code session start
-
-# Export to CLAUDE_ENV_FILE for session persistence
-if [ -n "$CLAUDE_ENV_FILE" ]; then
-    {
-        echo "export PROJECT_NAME=\"${PROJECT_NAME}\""
-        echo "export PROJECT_LABEL=\"${PROJECT_NAME}\""
-        # Add project-specific env vars here
-        # echo "export API_REPO=\"api\""
-        # echo "export UI_REPO=\"ui\""
-    } >> "$CLAUDE_ENV_FILE"
-fi
-
-# Display project info
-echo "Project: ${PROJECT_NAME}"
-echo "Pennyfarthing: npm package"

package/pennyfarthing-dist/templates/shared-context.md.template

@@ -1,70 +0,0 @@
-# Shared Agent Context
-
-This file contains common context loaded by all agents.
-
-## Project
-
-- **Name:** ${PROJECT_NAME}
-- **Sprint Status:** `sprint/current-sprint.yaml`
-- **Active Work:** `.session/{story-id}-session.md`
-- **Agent Framework:** Pennyfarthing (npm)
-
-### Tech Stack
-
-| Component | Language | Framework |
-|-----------|----------|-----------|
-| Example | TypeScript | Node.js |
-
-### Repo Structure
-
-```
-${PROJECT_NAME}/
-├── src/                    # Source code
-├── tests/                  # Tests
-├── docs/                   # Documentation
-├── sprint/                 # Sprint YAML files
-├── scripts/                # Utility scripts
-└── .claude/                # Claude Code configuration
-    ├── core/               # Pennyfarthing core (managed)
-    ├── project/            # Project-specific config
-    │   ├── agents/         # Agent sidecars (project knowledge)
-    │   ├── docs/           # This file, agent-scopes.yaml
-    │   └── hooks/          # setup-env.sh
-    ├── skills/             # Core skills (managed)
-    ├── personas/           # Persona themes (managed)
-    └── manifest.json       # Pennyfarthing version tracking
-```
-
-## Git Branch Strategy
-
-- **All work:** Feature branches
-- **Branch from:** `develop` (or `main` if no develop branch)
-- **PRs target:** `develop`
-- **Naming:** `feat/[story]-[description]` or `fix/[issue]-[description]`
-
-## TDD Workflow
-
-1. **SM** creates story and hands off to TEA
-2. **TEA** writes failing tests, hands off to Dev
-3. **Dev** implements to pass tests, hands off to Reviewer
-4. **Reviewer** reviews code, approves or requests changes
-
-## Testing Commands
-
-```bash
-# Run tests
-npm test
-
-# Run specific test
-npm test -- --grep "test name"
-```
-
-## Building
-
-```bash
-# Build
-npm run build
-
-# Type check
-npm run typecheck
-```

package/pennyfarthing-dist/templates/sidecar/decisions.md.template

@@ -1,40 +0,0 @@
-# ${AGENT_NAME} Decisions
-
-Architecture Decision Records (ADRs) for ${AGENT_NAME} work.
-
-## Decision Template
-
-Use this format for significant technical choices:
-
-### [Decision Title]
-
-**Status:** Proposed / Accepted / Superseded
-
-**Context:** Why was this decision needed? What problem were we solving?
-
-**Decision:** What did we decide to do?
-
-**Rationale:** Why this approach? What were the tradeoffs?
-
-**Alternatives Considered:**
-- Option A: [description and why we didn't choose it]
-- Option B: [description and why we didn't choose it]
-
-**Consequences:** What is the impact? What becomes easier/harder?
-
-**Date:** When was this decided?
-
----
-
-## Decisions to Document
-
-Start with significant choices:
-- Architecture patterns
-- Technology selections
-- Process decisions
-- Design approaches
-- Library/dependency choices
-- Data storage strategies
-- API design choices
-
-Keep 5-15 active decisions. Supersede rather than delete when contexts change.

package/pennyfarthing-dist/templates/sidecar/gotchas.md.template

@@ -1,37 +0,0 @@
-# ${AGENT_NAME} Gotchas
-
-Common pitfalls and edge cases encountered during ${AGENT_NAME} work.
-
-## Gotcha Template
-
-Use this format to document lessons learned:
-
-### [Gotcha Title]
-
-**Situation:** When does this happen? What triggers it?
-
-**Problem:** What goes wrong? What's the symptom?
-
-**Prevention:** How to avoid this.
-
-**Fix:** What to do if you hit it anyway.
-
-**Example:**
-```
-real example from experience
-```
-
----
-
-## Gotchas to Document
-
-Start with things that caused surprises:
-- Confusing error messages
-- Unexpected dependencies
-- Side effects of common operations
-- Environment-specific issues
-- Race conditions or timing issues
-- Configuration gotchas
-- Data loss risks
-
-Keep 5-15 active gotchas. Archive when issues are resolved.

package/pennyfarthing-dist/templates/sidecar/patterns.md.template

@@ -1,34 +0,0 @@
-# ${AGENT_NAME} Patterns
-
-Capture successful patterns discovered during ${AGENT_NAME} work.
-
-## Pattern Template
-
-Use this format to document recurring patterns:
-
-### [Pattern Name]
-
-**Context:** When does this pattern apply? What problem does it solve?
-
-**Solution:** What to do. Step-by-step or best practice.
-
-**Example:**
-```
-code or workflow example
-```
-
-**Why it works:** Key insight or reasoning.
-
----
-
-## Examples to Add
-
-Start with patterns you discover:
-- Common Git workflows
-- Effective communication patterns
-- Code organization approaches
-- Testing strategies
-- Build/deployment patterns
-- Error recovery procedures
-
-Keep 5-15 active patterns. Archive older entries to sprint/archive/ when they become obsolete.