recall

Entity Retrieval

Overview

This skill loads relevant stored Evolve entities into the current turn before substantive work begins.

Use this skill first whenever the task involves:

• code changes
• debugging
• code review
• repo exploration
• file inspection
• environment/tooling investigation

Skip only for trivial conversational requests with no local context.

Required Action

Before any non-trivial local work, you must complete the recall workflow below. Reading this SKILL.md alone does not satisfy the skill.

Completion Rule

Do not proceed to other analysis or tool use until all steps below are complete.

1. If a manifest has already been injected for this turn, use it to pick which entity files to open. Otherwise inspect ${EVOLVE_DIR:-.evolve}/entities/ and ${EVOLVE_DIR:-.evolve}/public/ for guidance relevant to the current task.
2. Read each matching entity file that appears relevant.
3. Summarize the applicable guidance in your own words before proceeding.
4. If no relevant entities exist, state that explicitly before proceeding.

Required Visible Completion Note

Before moving on, produce an explicit completion note in your reasoning or user update using one of these forms:

• Recall complete: searched ${EVOLVE_DIR:-.evolve}/entities/, read <files>, applicable guidance: <summary>
• Recall complete: searched ${EVOLVE_DIR:-.evolve}/entities/, no relevant entities found

Minimum Acceptable Procedure

1. List or search files under ${EVOLVE_DIR:-.evolve}/entities/ and ${EVOLVE_DIR:-.evolve}/public/ (or read the injected manifest if one is present).
2. Identify candidate entities relevant to the task.
3. Open and read those entity files.
4. Summarize what applies, or state that nothing applies.

Failure Conditions

The skill is not complete if any of the following are true:

• You only read this SKILL.md
• You did not inspect ${EVOLVE_DIR:-.evolve}/entities/
• You did not read the relevant entity files
• You proceeded without stating whether guidance was found