Skip to main content

Retrospectives

Flow-based retrospectives for b4arena. Unlike time-range reviews, these are anchored to development flows — coherent sequences from trigger to outcome.

Retro Lifecycle

  1. Identify — Scan data streams (PRs, issues, sessions, learnings) for flows worth a retrospective. Run: /arena → "retro identify"
  2. Register — Selected candidates get a skeleton document here with status: identified
  3. Conduct — Gather targeted data, analyze patterns, persist findings. Run: /arena → "retro conduct "
  4. Act — Actions link to GH issues. Track resolution via checkboxes.

Document Format

Each retro is a markdown file: YYYY-MM-DD-<slug>.md

Frontmatter fields:

  • status: identified | in_progress | completed
  • flow_type: design_cycle | issue_lifecycle | pr_flow | other
  • dimensions: array of architecture | operations | coordination | quality
  • identified_date / completed_date: lifecycle timestamps

Flow Types

TypeDescription
design_cycleEnd-to-end: question through architecture, implementation, deploy
issue_lifecycleDiscovery through resolution: agent finds problem, another resolves
pr_flowHow PRs moved through review, CI, merge
otherAnything that doesn't fit the above

Dimensions

DimensionExamples
architectureDesign decisions, spec gaps, ADR outcomes
operationsDeployment issues, infra problems, agent health
coordinationAgent handoffs, work routing, review flow
qualityTest coverage, regressions, false completions