| name | reflect |
| description | Use for an occasional step-back, weekly, at a milestone, or after a big push, NOT every session. A reflection for both the agent and the human: what got done, the patterns worth noticing, what was learned that should change how the work is done, and what to prune or add. |
Reflect: step back, for the agent and the human
Most sessions only need the everyday habits, keep the docs current as you go, journal a few lines at the end. But every so often it's worth stepping back to a higher altitude and asking what the run has been, not just what today's task was. This is a reflection for both of you: the agent learns how to work better, the human sees what they've actually been doing.
Do it occasionally, weekly, at a milestone, at the end of a big push, not every session. A heavy nightly version of this is the thing nobody keeps up; the point is that it's light and real, not a ritual.
Surface, for both audiences:
- The shape of the period. What actually moved, and what didn't. Not a task log, the gist.
- The patterns. What did you keep reaching for, or keep fighting? A recurring friction is a signal worth naming.
- What was learned that should change how the work is done. A lesson is only worth capturing if it changes something, turn it into a doc or skill update there and then (keep it current), don't just note it.
- How the agent itself evolved. The persona, the loops, the way it works, the things that drift slowly and never get caught in a same-turn edit.
- What to prune or add. A rule that's aged, a skill that's earned its place, a habit that isn't serving. Reflection that changes nothing was just journaling.
Output: a short written reflection (in the journal, or a dated reflections/ note), plus any concrete change it triggers, applied the same session. The value isn't the reflection, it's what you and the agent do differently because of it.
This is the periodic step-back. The everyday is covered by keeping docs current as you go and a light end-of-session journal; reflect is the occasional higher-altitude look those can't give you.
