reflect

Capture and index post-feature learnings, patterns, and decisions into .agent/memory/reflections.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/GiantCroissant-Lunar/fantasim-world --skill reflect-giantcroissant-lunar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reflect
Source: https://github.com/GiantCroissant-Lunar/fantasim-world/tree/main/.agent/skills/reflect
Command: npx skills add https://github.com/GiantCroissant-Lunar/fantasim-world --skill reflect-giantcroissant-lunar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill captures learnings, patterns, and decisions after a feature is completed and stores them for future agent reference.

Core Features & Use Cases

  • Automatic reflection capture after feature completion, with context gathered from code reviews, specs, and commits.
  • Memory indexing in .agent/memory/reflections to support fast retrieval and queries.
  • Tag-based organization and an auto-updating index for quick discovery.
  • Use Case: After delivering a feature, trigger the reflection workflow to document decisions, outcomes, and improvements for future work.

Quick Start

After you finish a feature and pass reviews, run the reflection workflow to generate and store a new reflection document in .agent/memory/reflections and update the index.

Frequently Asked Questions about reflect

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

FAQPage Schema
How do I capture feature learnings and decisions for future agent reference?▼

To capture feature learnings, trigger the reflection workflow after completing a feature to document decisions, outcomes, and improvements, storing them as plain files in .agent/memory/reflections for future reference.

What is agent memory indexing and how does it work with postmortems?▼

Agent memory indexing organizes postmortem reflections into an auto-updating index using tags, enabling fast retrieval and querying of past decisions and patterns stored within the .agent/memory/reflections directory.

When should I generate a postmortem reflection in my development cycle?▼

You should generate a postmortem reflection after a feature is completed and has passed reviews, code merges, or bug resolutions, gathering context from specs and commits to inform future work.

How do I organize and query past reflections using tags?▼

Reflections are organized using tags within an auto-updating index. This tag-based structure supports fast discovery and querying of stored learnings directly through plain file IO.

Can I use plain file IO to store agent memory without external dependencies?▼

Yes, you can store agent memory using plain file IO. This skill writes reflection documents and updates the index without requiring any external dependencies or complex database setups.