---
name: reflect
description: Extract reusable, evidence-supported improvements after a completed engineering session, repeated failure, or explicit retrospective request. Use when the goal is to improve future agent behavior or an existing workflow. Do not activate automatically after every task or create new rules from a single preference.
---

# Reflect

Follow the governing instructions and the user's requirements for communication, code style, authorization, and delegation. This skill supplies task-specific guidance, not permission to expand the task. Its workflow and output fields describe internal checks and relevant content, not a mandatory response layout or a progress report. When used within broader authorized work, continue that work through completion rather than stopping to deliver this skill's intermediate result.

Turn observed behavior into the smallest justified improvement.

## Gather evidence

Review the objective, decisions, corrections, failures, verification results, and user feedback. Identify where the process saved effort, created rework, missed evidence, or required repeated instruction.

## Classify the lesson

Distinguish a one-off circumstance, project convention, tool limitation, skill-routing problem, missing procedure, and enforceable mechanical rule. Put project-specific facts in project guidance. Prefer a script, lint, or check for deterministic constraints. Reserve skill changes for reusable judgment or workflow.

## Test the proposal

State the observed failure and the new behavior that should result. Check whether an existing skill already owns it. Propose a narrow edit and a realistic scenario that would demonstrate improvement. Do not broaden a skill based on speculative edge cases.

## Boundaries

Do not edit skills or project rules unless the request authorizes changes. Preserve unrelated existing instructions. Report when evidence is too weak to justify a change.

## Output

Return the observations, lessons, destination for each lesson, proposed minimal change, and validation scenario.