# Reflect

> Mine the active session for durable process lessons and propose concrete skill edits — wait for approval before changing any skill.

- Skill: `jayden-dang/reflect` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add jayden-dang/reflect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jayden-dang/reflect/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jayden-dang (https://skillmd.com/u/jayden-dang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jayden-dang/reflect

---


# Reflect

Turn a finished hard session into skill-set improvements. Do not auto-apply.

<HARD-GATE>
OVERRIDE SHIP (2026-09-08): overlap research said `/author-skills` already
covers transcript→skill edit. User override required a dedicated `/reflect`.
</HARD-GATE>

## When

User said `/reflect`, or a complex task (many tool calls) just landed with a
generalizable path, dead-ends, or mid-task corrections. Skip trivial chats.

## Steps

1. **Locate transcript.** Prefer the harness transcript path for *this*
   workspace only. Do not glob other projects' private chats. If none, write a
   tight digest of the session.
2. **Three lenses in parallel** (read-only subagents; different models when
   possible): Judgment (what should have been non-negotiable), Tooling (what
   script/lint/check would have caught it), Divergent (what a skeptical peer
   would refuse). Templates in `references/` beside this file.
3. **Synthesize** into Accepted / Rejected / Backlog. Prefer encoding lessons
   as lint, test, metadata, or schema over more prose
   (`encode-lessons-in-structure`).
4. **Present and wait.** Show the full list. Apply only what the user approves.
5. **Apply via author-skills.** Trivial one-line fixes: parent edits.
   Substantive edits or new skills: name `/author-skills` and follow its
   RED→GREEN cycle — reflect never skips the failing-test bar for skill text.
6. **Summarize** edits applied, new skills, backlog filed, drops with reasons.

## Rationalizations

| Thought | Reality |
|---|---|
| "I'll just patch the skill — faster" | Unapproved skill edits hit every future agent. Wait |
| "author-skills is enough; skip reflect" | OVERRIDE: user wanted this entry point |
| "Backlog is optional" | File it; Accepted waits for approval |

## Done when

Approved Accepted items are applied under `/author-skills` discipline; Rejected
and Backlog are stated; no silent skill writes.