reflect

name	reflect
description	Analyze sessions or projects for patterns, misses, product signals, process improvements, automation opportunities, and skill effectiveness. Modes: session, project, portfolio.

Reflect

Use this to learn from work already done. The output is decisions and reusable lessons, not a diary.

Modes

• Session: inspect the current conversation and artifacts.
• Project: inspect one repo's state, history, .evolve/, PRs, and outcomes.
• Portfolio: inspect multiple recent projects and find repeated patterns.

Flow

1. Collect source material: transcript, git history, PRs, .evolve/ logs, test results, release state, and user corrections.
2. Separate facts from interpretation.
3. Score outcome, quality, communication, wasted motion, and reusable learning.
4. Identify repeated failure modes and high-leverage process changes.
5. Write only durable lessons that future agents can act on.
6. Dispatch the next skill or stop.

Output

Return top findings, evidence, what to change, what to keep doing, and where to store any durable note. Use references/full-reference.md for portfolio workflow and reflection templates.

Then consider

• governor when reflection should choose the next action.
• evolve when a measurable process improvement is ready.