Skip to content

feat: Automated retrospective ceremony with enforcement #601

Closed

Description

@tamirdresher

Problem

Scheduled retros get skipped. Action items tracked in markdown have 0% completion rate (measured across 6 retros). Without enforcement, squads ship fast but don't learn from mistakes.

Proposal

Add a retro ceremony template with Ralph enforcement:

Ceremony definition (ceremonies.md):

  • Schedule: Friday 14:00 UTC
  • Fallback: first Ralph round after missed Friday
  • Facilitator: Lead agent
  • Output: session log + decision entries + GitHub issues for action items

Ralph enforcement:

  • Every round, check: is a retro overdue (>7 days since last)?
  • If yes: run retro BEFORE any other work
  • Test-RetroOverdue helper function checks .squad/log/*retrospective* files

Action item tracking:

  • Retro action items are created as GitHub Issues (not markdown)
  • Labeled retro-action for tracking
  • Measured: completion rate of retro-action issues vs old markdown approach

Deep retro template:

  • Scan orchestration logs, session logs, closed issues, decision history
  • Produce: velocity analysis, pattern analysis, agent effectiveness, decision quality
  • Concrete action items with owners

Prior Art

Implemented after discovering 0/7 action items completed from previous retro. The enforcement mechanism (Ralph checks + auto-trigger) has been running for 1 day — too early for completion rate data but the detection logic is proven.

Deliverables

  • Ceremony template: retro definition for ceremonies.md
  • Ralph prompt addition: retro enforcement instructions
  • Test-RetroOverdue PowerShell function
  • Deep retro facilitation prompt template
  • Docs: retro best practices (issues not markdown)

Activity

  1. tamirdresher commented on Mar 24, 2026

    @tamirdresher
    CollaboratorAuthor

    Revision after checking main: The ceremonies framework and scheduler exist. What's missing: (1) retro-specific overdue detection (>7 days since last retro = auto-trigger), (2) Test-RetroOverdue helper function, (3) the insight that retro action items must be GitHub Issues not markdown (0% completion rate on markdown, measured across 6 retros). Narrowing to enforcement gap only.

  2. bradygaster commented on Mar 26, 2026

    @bradygaster
    Collaborator

    Resolved by #605/#607 (merged). Retrospective ceremony with Ralph enforcement now available. Test-RetroOverdue enforces cadence, and action items are tracked as GitHub Issues instead of markdown. Production data shows 100% completion rate.

  3. bradygaster commented on Mar 26, 2026

    @bradygaster
    Collaborator

    Reopening — PR #607 is still open with changes requested. Will close once that PR is reviewed and merged.

  4. github-actions commented on Mar 26, 2026

    @github-actions
    Contributor

    🏗️ Squad Triage — Flight (Lead)

    Issue: #601 — feat: Automated retrospective ceremony with enforcement
    Assigned to: FIDO (Quality Owner)
    Reason: Issue relates to testing/quality work

    @copilot evaluation: 🔴 Not suitable — issue involves work outside the coding agent's capability profile.

    Team roster:

    • Flight (Lead) → label: squad:flight
    • Procedures (Prompt Engineer) → label: squad:procedures
    • EECOM (Core Dev) → label: squad:eecom
    • FIDO (Quality Owner) → label: squad:fido
    • PAO (DevRel) → label: squad:pao
    • CAPCOM (SDK Expert) → label: squad:capcom
    • CONTROL (TypeScript Engineer) → label: squad:control
    • Surgeon (Release Manager) → label: squad:surgeon
    • Booster (CI/CD Engineer) → label: squad:booster
    • GNC (Node.js Runtime) → label: squad:gnc
    • Network (Distribution) → label: squad:network
    • RETRO (Security) → label: squad:retro
    • INCO (CLI UX & Visual Design) → label: squad:inco
    • GUIDO (VS Code Extension) → label: squad:guido
    • Telemetry (Aspire & Observability) → label: squad:telemetry
    • VOX (REPL & Interactive Shell) → label: squad:vox
    • DSKY (TUI Engineer) → label: squad:dsky
    • Sims (E2E Test Engineer) → label: squad:sims
    • Handbook (SDK Usability) → label: squad:handbook
    • Ralph (Work Monitor) → label: squad:ralph
    • @copilot (Coding Agent) → label: squad:copilot

    To reassign, remove the current squad:* label and add the correct one.

  5. github-actions commented on Mar 26, 2026

    @github-actions
    Contributor

    📋 Assigned to Procedures (Prompt Engineer)

    Issue: #601 — feat: Automated retrospective ceremony with enforcement

    Procedures will pick this up in the next Copilot session.

    For Copilot coding agent: If enabled, this issue will be worked automatically.
    Otherwise, start a Copilot session and say:
    Procedures, work on issue #601

  6. bradygaster commented on Mar 26, 2026

    @bradygaster
    Collaborator

    Triage: Contributor-submitted feature (Tamir). Retrospective ceremony enhancement. Assigned to Procedures (prompt/coordinator design) for review.

  7. added a commit that references this issue on Mar 26, 2026
    4a0570f
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    go:needs-researchNeeds investigationsquadSquad triage inbox — Lead will assign to a memberstatus:contributor-invitedA specific contributor has been invited to work on thistype:featureNew capability

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions