reflect

Run a three-step mid-task reflection to identify progress blockers and reaffirm alignment.

1|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/wgordon17/personal-claude-marketplace --skill reflect-wgordon17
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflect
Source: https://github.com/wgordon17/personal-claude-marketplace/tree/main/code-quality/skills/reflect
Command: npx skills add https://github.com/wgordon17/personal-claude-marketplace --skill reflect-wgordon17

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mid-task self-reflection checkpoint using Serena metacognitive tools. Use to pause and evaluate whether you're on track, have gathered enough information, and are actually done before making large changes or moving forward.

Core Features & Use Cases

  • Guided reflection sequence with Task Adherence, Information Completeness, and Completion Check.
  • Optional memory read/write to surface past context and decisions for better alignment.
  • Safe, structured prompts to reduce drift and improve decision quality during ongoing work.

Quick Start

Run the reflection workflow with /reflect to perform the three steps in order and surface actionable next steps.

Frequently Asked Questions about reflect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform a mid-task reflection to check if my development work is still on track?

Mid-task reflection uses a three-step workflow—task-adherence, information-completeness, and completion-check—to evaluate progress, identify blockers, and reaffirm alignment before making major changes. It surfaces actionable next steps and optionally stores insights in memory.

What is metacognition in software engineering and when should I use a reflection checkpoint?

Metacognition in software engineering involves pausing to evaluate your own task progress and information gathering. Use a reflection checkpoint during ongoing research or development when uncertainty arises or before large changes to reduce drift and improve decision quality.

How do I check task adherence and information completeness before committing to major code changes?

Task adherence and information completeness are checked through a guided reflection sequence that enforces evaluating whether your current actions match the goal and whether you have gathered enough context before moving forward with large changes.

Can I use Serena memory operations to store and retrieve insights during an ongoing task?

Yes, the reflection workflow includes optional memory read and write operations using Serena tools. This allows you to surface past context and decisions from memory, and store new insights to maintain better alignment throughout your task.

What is the best way to prevent scope drift during long research or development tasks?

Preventing scope drift is best achieved through structured self-reflection prompts that enforce task-adherence and completion-checks. By pausing to evaluate information completeness and progress blockers, you reduce drift and improve decision quality before proceeding.

Does the reflection workflow require any specific dependencies or environment setup?

No specific dependencies or environment setup are required. The reflection workflow operates independently using Serena metacognitive tools to guide the three-step task-adherence, information-completeness, and completion-check sequence without external components.