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

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

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

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

clef generation-plan history --limit 5

Quick Reference

Validation

Show generation summary:

npx tsx cli/src/index.ts generate --summary

Show generation history:

npx tsx cli/src/index.ts generate --history

Related Skills