ACE - Retro

Lightweight retrospective management -- create, tag, and archive retros from the command line. ACE Logo

Gem Version Ruby License: MIT

Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.

Getting Started | Usage Guide | Handbook - Skills, Agents, Templates

ace-retro demo

ace-retro helps teams capture learning while context is still fresh and maintain a searchable archive for follow-up improvements. Use ace-retro create to start a retro from the CLI (or /as-retro-create from an interactive agent session), and /as-retro-synthesize to distill patterns across multiple retros.

How It Works

  1. Create a retrospective from type-aware templates (standard, conversation-analysis, or self-review) with ace-retro create.
  2. Enrich metadata with tags and status updates.
  3. Archive completed retros to preserve history while keeping the active workspace clean.

Testing

  • ace-test ace-retro runs deterministic fast tests (default package loop).
  • ace-test ace-retro all runs the full deterministic suite.
  • ace-test-e2e ace-retro runs retained scenario workflows under test/e2e/.
  • ace-test ace-retro feat is used only when explicit test/feat/ contracts exist.

Use Cases

Capture retros quickly after delivery - use /as-retro-create or ace-retro create to initialize a retro from templates while the work is still fresh.

Synthesize patterns across retros - use /as-retro-synthesize to distill recurring themes and improvement opportunities from multiple retrospectives.

Review and maintain retro metadata - list, show, and update retros with tags and status, then archive completed entries without losing searchability.

Improve agent workflows over time - use /as-handbook-selfimprove to feed retro insights back into handbook guidance for better future performance.

Getting Started | Usage Guide | Handbook - Skills, Agents, Templates | Part of ACE