AGENTS · WORKFLOW

Agent search workflow

Candidate search

Extract the central lemma from the requirement and collect broad candidates with --boundary any --json. Limit paths to the directories in scope.

If the initial result is empty, inspect the literal spelling, POS, and query tokenization. Adding synonyms immediately would mix morphology coverage with vocabulary choice.

Constraint refinement

Apply smart, atom POS tags, and phrase order one at a time. Retaining paths and surface forms at each step reveals which constraint removed a candidate.

A query requiring structural boundaries fails explicitly without the compact component resource. Do not treat that failure as a no-match result.

Context review

Read the surrounding symbols, call sites, and tests for the final candidates. kfind provenance explains morphological rules, not program semantics.

After an edit, rerun the same query together with an opposite hard negative to verify that the search condition remains valid.