reflect

name	reflect
description	Distill evidence-backed lessons from completed work without retaining raw transcripts.

Reflect

Use after meaningful work, a failure, a decision, or a correction.

Procedure

1. Extract candidate facts from concrete artifacts: changed files, verification results, user decisions, or documented failures.
2. Reject speculation, generic advice, one-off activity logs, and raw transcript content.
3. Check LEARNINGS.md and CORRECTIONS.md for an existing entry before writing.
4. Record only durable, actionable lessons with date and evidence reference.
5. Route user corrections to CORRECTIONS.md; route reusable non-correction lessons to LEARNINGS.md.
6. If a lesson changes current work, update PROJECT_STATE.md or NEXT.md once; do not duplicate it elsewhere.

Quality Gate

Keep an item only when it is specific, reusable, supported by evidence, and likely useful beyond current session.

Never store or copy raw transcripts, transcript exports, or raw tool output.