Implementation Docs

Each file in this folder describes how a feature is currently built — the actual code structure, known gotchas, and instructions for extending it. Keep these up to date when the code changes.

Template

# [Feature Name] — Implementation

## Current State
What is working, what is wired but unused, what is missing.

## How It Works
Key files, functions, and data flow. Link to source with `file:line` references where useful.

## Gotchas
Non-obvious behaviours, ordering requirements, silent failure modes, or anything that has caused bugs.

## How to Extend
Step-by-step instructions for adding new instances of this feature (e.g. new ticker, new ML feature, new scraper source).