Decodie — Ask Mode

Help the user explore and deepen their understanding of existing learning entries in the .decodie/ directory.

This mode is read-only with respect to .decodie/ data.

Setup

Load rules. Check for ~/.decodie/rules/*.md (global) and .decodie/rules/*.md (project). Read all .md files found. Treat their content as additional instructions controlling documentation output — tone, language, verbosity, format, audience. Project rules override global rules on conflict. If no rules exist, proceed with defaults.

Entry Resolution

Resolve which entry the question targets using this priority:

1. Explicit entry ID — If the question contains an entry ID (e.g., entry-1711540000-a1b2), load it directly.
2. Keyword match — Search active entry titles and topics in index.json. Prefer exact substring matches in titles, then topic tag matches.
3. Current session default — If no match, default to the most recently created entry in the current session.
4. No match — If no entries exist or match, tell the user and suggest browsing index.json.