---
name: generation-plan
description: Track generation run lifecycle : begin , record step outcomes , 
 complete , and report Purely passive does not dispatch 
 generators or query other concepts Observer syncs feed it 
 data ; it stores and aggregates
argument-hint: $ARGUMENTS
allowed-tools: Read, Grep, Glob, Bash
---

<!-- Auto-generated by Clef Clef Bind — claude-skills target -->
<!-- Concept: GenerationPlan -->
<!-- Do not edit manually; regenerate with: clef interface generate -->

# GenerationPlan

View generation run tracking for **$ARGUMENTS** with step-by-step status, aggregate summaries, and run history.


> **When to use:** Use when checking the status of a generation run, viewing run summaries, or browsing generation history.


## Design Principles

- **Passive Observer:** GenerationPlan is purely passive — it records what syncs report, never drives execution.
- **Run Isolation:** Each generation run has its own reference. Steps are recorded against the active run.

## Step-by-Step Process

### Step 1: Run Status

Show detailed step-by-step status of a generation run.

**Arguments:** `$0` **run** (R)

**Checklist:**
- [ ] Run reference is valid?

**Examples:**
*Show current run status*
```bash
clef generation-plan status
```

### Step 2: Run Summary

Show aggregate statistics: total/executed/cached/failed steps, duration, files produced.

**Arguments:** `$0` **run** (R)

**Checklist:**
- [ ] All steps accounted for?

**Examples:**
*Show run summary*
```bash
clef generation-plan summary
```

### Step 3: Run History

Show recent generation runs with their outcomes.

**Arguments:** `$0` **limit** (int?)

**Checklist:**
- [ ] Limit is reasonable?

**Examples:**
*Show last 5 runs*
```bash
clef generation-plan history --limit 5
```

## Quick Reference

| Action | Command | Purpose |
|--------|---------|---------|
| begin | `clef generation-plan begin` | Mark run started |
| recordStep | `clef generation-plan record-step` | Record step outcome |
| complete | `clef generation-plan complete` | Mark run finished |
| status | `clef generation-plan status` | Show step-by-step status |
| summary | `clef generation-plan summary` | Show aggregate statistics |
| history | `clef generation-plan history` | Show recent runs |


## Validation

*Show generation summary:*
```bash
npx tsx cli/src/index.ts generate --summary
```
*Show generation history:*
```bash
npx tsx cli/src/index.ts generate --history
```
## Related Skills

| Skill | When to Use |
| --- | --- |
| `/file-emission` | Emitter writes tracked by GenerationPlan |
| `/incremental-caching` | Cache hits/misses recorded as steps |