# Retro

> Sprint retrospective — analyzes git velocity, commit patterns, test health, and shipping cadence. Use after a sprint, at the end of the week, or when the user wants to reflect on progress.

- **Type:** Skill
- **Install:** `agentstack add skill-houseofmvps-ultraship-retro`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Houseofmvps](https://agentstack.voostack.com/s/houseofmvps)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Houseofmvps](https://github.com/Houseofmvps)
- **Source:** https://github.com/Houseofmvps/ultraship/tree/main/skills/retro
- **Website:** https://www.npmjs.com/package/ultraship

## Install

```sh
agentstack add skill-houseofmvps-ultraship-retro
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Sprint Retrospective

Retrospectives turn shipping data into actionable insights. This skill analyzes your git history, commit patterns, test health, and shipping velocity to surface what's working and what needs attention.

**Announce at start:** "I'm running a sprint retrospective on this project."

## Process

### Step 1: Gather Data

Run the retro analyzer:

```bash
node ${CLAUDE_PLUGIN_ROOT}/tools/retro-analyzer.mjs  --days 7
```

For custom date ranges:
```bash
node ${CLAUDE_PLUGIN_ROOT}/tools/retro-analyzer.mjs  --since 2026-03-24
```

### Step 2: Present the Retrospective

Format the data as a clear, actionable report:

#### Velocity Report Card

```
+===========================================+
|     S P R I N T   R E T R O              |
+===========================================+
|  Period        Mar 24 – Mar 31           |
|  Commits       47                         |
|  Lines Added   2,341                      |
|  Lines Removed 892                        |
|  Net Change    +1,449                     |
|  Authors       1                          |
+===========================================+
```

#### Commit Breakdown

Show the distribution of commit types (features, fixes, refactors, tests, docs, chores) as a visual breakdown. Highlight the feature-to-fix ratio — a healthy project ships more features than fixes.

#### Hot Files

List the most-changed files. Files with excessive churn may need to be split into smaller modules.

#### Test Health

- Number of test files
- Passing / failing tests
- Whether a test script exists
- Recommendation if tests are absent or failing

#### Shipping Cadence

- Peak day of week (when do you ship most?)
- Peak hour (when are you most productive?)
- Tags/releases in this period

### Step 3: Insights & Recommendations

Based on the data, surface:

**What went well:**
- High velocity periods
- Good deletion-to-addition ratio (code hygiene)
- Consistent shipping cadence
- Test coverage improvements

**What needs attention:**
- Fix-heavy sprints (more fixes than features = quality debt)
- Hot files that churn excessively
- Missing or failing tests
- Uneven shipping cadence (feast-or-famine pattern)

**Action items:**
- Concrete, specific recommendations with clear next steps
- Link to relevant Ultraship skills (e.g., "Use `/tdd` for the untested module")

### Step 4: Cross-Reference with Learnings (Optional)

If the project has learnings (from `/learn`), search for relevant context:

```bash
node ${CLAUDE_PLUGIN_ROOT}/tools/learnings-manager.mjs search --query "sprint"
node ${CLAUDE_PLUGIN_ROOT}/tools/learnings-manager.mjs search --query "debugging"
```

Incorporate past learnings into recommendations.

## Multi-Project Mode

For founders running multiple projects, run retros across all of them:

```bash
node ${CLAUDE_PLUGIN_ROOT}/tools/retro-analyzer.mjs ~/project-a --days 7
node ${CLAUDE_PLUGIN_ROOT}/tools/retro-analyzer.mjs ~/project-b --days 7
```

Compare velocity across projects to understand where time is being spent.

## Output

The retrospective should be concise and actionable — not a data dump. Lead with insights, support with data. The goal is to help the user ship better next week.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Houseofmvps](https://github.com/Houseofmvps)
- **Source:** [Houseofmvps/ultraship](https://github.com/Houseofmvps/ultraship)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/ultraship

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-houseofmvps-ultraship-retro
- Seller: https://agentstack.voostack.com/s/houseofmvps
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
