Venom Eat

For folders: Read anatomy first (INDEX, README, structure files), then hot paths, then supporting.

Contrast teaches: Note what's missing as much as what's there. Understand why each piece exists.

Tools:

• read — files
• glob — find patterns
• grep — search content
• web_fetch — external docs

3. Digest — Extract What Matters

Four extraction layers:

Constraints:   What this can't do. Limits. Non-negotiables.
Capabilities:  What this can do. Built for what.
Hot paths:     What actually runs. Called most often.
Mappings:      How pieces connect. Dependencies. Call chains.

4. Become — Integrate

What I already know + what I just ate = updated understanding.

• Contradicts prior knowledge? → Note conflict explicitly.
• Confirms prior knowledge? → Note reinforcement.
• New pattern? → MOLT captures (instincts.yaml candidate).

5. Offer — Structure + Next Step

## What I Ate
[Resource name + type + size/scope]

## Structure
[How it's organized — architecture, not file list]

## Key Findings
[3-5 most important things — not obvious things]

## Risks / Gaps
[What could break, what's missing, what's concerning]

## Hot Paths
[What matters most for navigation and editing]

## Recommended Next Step
[One concrete action — not a menu]

End with specific next action or "Want me to [action]?" if user approval needed.

Eat by Type

After Eating

Memory integration:

• If significant patterns found → offer to write to .venom/memory/MEMORY.md
• If corrections discovered → offer to add to .venom/rules/corrections.yaml
• If daily session → write to memory/YYYY/MM/DD/

Example:

Worth saving any of this to memory?
- Decision: [X]
- Pattern: [Y]
- Correction: [Z]

Completeness Check

HUNT doesn't stop until:

• ✅ All entry points identified
• ✅ All integration points mapped
• ✅ Constraints understood (what can't be done)
• ✅ Gaps named (what's missing or unclear)
• ✅ Hot paths known (where to start)

Incomplete eat = wasted time. Hunt to bedrock.

HUNT pulls history. HUNT names the gap. HUNT doesn't stop until bedrock. 🐙