# Report

> Generate a post-implementation report summarizing what was built, correlating planned vs actual changes. Triggers: 'report', 'summarize implementation', 'what did we build', 'execution summary'.

- Skill: `luan/report` (Agent Skill)
- Install (CLI): `npx skillmds@latest add luan/report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/luan/report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: luan (https://skillmd.com/u/luan)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/luan/report

---


# Report

Generate a post-implementation summary as a blueprint artifact. Captures what was built, how it diverged from the plan, and what to watch for.

## Arguments

- `--spec <path>` — source spec to correlate against (optional)
- `--plan <path>` — source plan to correlate against (optional)
- No arguments → auto-detect from `ct spec latest` and `ct plan latest`

## Workflow

### 1. Gather context

```bash
BASE=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's|refs/remotes/||' || echo main)
```

Collect:

- `git log --oneline $BASE..HEAD` — commit history
- `git diff --stat $BASE..HEAD` — file change summary
- `git diff $BASE..HEAD -- '*.rs' '*.ts' '*.py'` — actual diff (truncate at 3000 lines)

### 2. Read source artifacts

If `--spec` or `--plan` provided, read via `ct spec read` / `ct plan read`. Otherwise try `ct spec latest` and `ct plan latest` — skip silently if none found.

### 3. Synthesize report

**Sections:**

- **Summary**: 2-3 sentences — what was built and why.
- **Commits**: table of commits with one-line descriptions.
- **Files Changed**: grouped by area (e.g., src/, tests/, config/).
- **Plan vs Reality** (only if plan/spec available): what matched, what diverged, what was added that wasn't planned.
- **Watchouts**: things the next developer should know — incomplete work, known limitations, areas that need follow-up.

### 4. Store

Scaffold with `blueprint_create`, Edit the body, then `blueprint_commit`.

### 5. Output

Print the report file path and a one-line summary.