pal-e-docs

Phase 4: Betty Sue Sprint Skill (Commands + Board Sync)

phase-2026-03-03-4-betty-sue-skill Phase

Project
Goal: Betty Sue has skill commands for sprint management — creating items, syncing board state from labels, linking PRs, and sprint status. Skill encapsulates MCP tool sequences into reusable commands.
Owner: Betty Sue (Claude config development per sop-claude-config-development)
Repo: forgejo_admin/claude-custom (symlinked as ~/.claude/)
Forgejo Issue: TBD

Architecture

Skills encapsulate multi-step MCP workflows into single commands. Each skill command is a recipe that calls MCP tools in sequence. The skill file defines the steps; the agent (Betty Sue) executes them.
Layer What Example
<strong>Skill command</strong> User-invocable workflow <code>/sprint-sync</code> — read labels on all sprint items, move board columns to match
<strong>MCP tools</strong> Individual API calls the skill orchestrates <code>mcp__forgejo__list_issues</code>, <code>mcp__pal-e-docs__move_sprint_item</code>
<strong>Hooks</strong> Enforcement that fires on tool events PostToolUse after merge → remind Betty Sue to move sprint item to done

Skill Commands to Implement

  • /sprint-sync — Read Forgejo labels on all sprint items' issues, update board columns to match label state using the label-to-column mapping from agent-workflow
  • /sprint-status — Summary of all boards: what's in each column, what's blocked, what moved since last check
  • /sprint-add — Create sprint item from Forgejo issue URL. Calls add_sprint_item() with title convention from template-sprint-item
  • /sprint-kickoff — For all items in next_up, spawn dev agents with Forgejo issue URLs. Follows agent-spawn-conventions.

Hook: Post-Merge Sprint Update

  • Extend existing PostToolUse on mcp__forgejo__merge_approved_pr
  • Inject context: "PR merged. If this issue has a sprint item, move it to done and update the plan phase."
  • This is a reminder hook (like remind-update-docs.sh), not automatic — Betty Sue decides whether to act

Steps

  • Review sop-claude-config-development and existing skill file patterns
  • Create skills/sprint-sync/SKILL.md
  • Create skills/sprint-status/SKILL.md
  • Create skills/sprint-add/SKILL.md
  • Create skills/sprint-kickoff/SKILL.md
  • Extend post-merge hook with sprint item reminder
  • Create skill notes in pal-e-docs for each command
  • Test each command against Sprint 1 data
Deliverable: Betty Sue can /sprint-sync to update boards from labels, /sprint-status for a quick view, /sprint-add to onboard issues, /sprint-kickoff to start work on next_up items.
Depends on: Phase 3 (hooks set labels that /sprint-sync reads).