app/AGENTS.md

<!-- BEGIN:nextjs-agent-rules -->
# This is NOT the Next.js you know

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
<!-- END:nextjs-agent-rules -->
## Cross-Session Context
Before starting work on investor-flow, read:
1. Domain wiki: `~/Library/Mobile Documents/iCloud~md~obsidian/Documents/Life/System/Projects/investor-flow.md`
2. As-built status: `docs/FUNCTIONAL_DESIGN.md` + `docs/TECH_DESIGN.md` (prefer these over HANDOFF or old slice SPECs for "what's built")
3. Glossary: `CONTEXT.md`

**Confirm at session start:** Print a one-line confirmation like "✓ Read [[investor-flow]] domain model + as-built designs" so the user knows context was loaded.

## Rate-Limit Rules (ADR-0009)

Never bypass the rate-limit system. Every external data source (Yahoo Finance, SEC EDGAR, X/Twitter, Reddit, FRED) must go through either:
- `AdapterQueue` (production pipeline with per-source min-interval + 429 cool-down), or
- A local in-memory throttle with explicit backoff on rate-limit errors (for ad-hoc/service-path fetches)

No direct vendor calls from TRPC endpoints, next.js server actions, or agent scripts without rate-limit protection. The app is designed on the principle that stale cached data beats empty/erroring UI.
fix (ornith-35): watchlistRepository double-encoding bug — single JSON.stringify, 13/13 tests pass 2026-06-30 17:54:01 -04:00			`<!-- BEGIN:nextjs-agent-rules -->`
			`# This is NOT the Next.js you know`

			This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
			`<!-- END:nextjs-agent-rules -->`
fix: backfill symbol_demand for sidebar-added symbols + analyst ratings schema fix 2026-07-23 18:02:24 -04:00			`## Cross-Session Context`
			`Before starting work on investor-flow, read:`
			1. Domain wiki: `~/Library/Mobile Documents/iCloud~md~obsidian/Documents/Life/System/Projects/investor-flow.md`
			2. As-built status: `docs/FUNCTIONAL_DESIGN.md` + `docs/TECH_DESIGN.md` (prefer these over HANDOFF or old slice SPECs for "what's built")
			3. Glossary: `CONTEXT.md`

			`Confirm at session start: Print a one-line confirmation like "✓ Read [[investor-flow]] domain model + as-built designs" so the user knows context was loaded.`

			`## Rate-Limit Rules (ADR-0009)`

			`Never bypass the rate-limit system. Every external data source (Yahoo Finance, SEC EDGAR, X/Twitter, Reddit, FRED) must go through either:`
			- `AdapterQueue` (production pipeline with per-source min-interval + 429 cool-down), or
			`- A local in-memory throttle with explicit backoff on rate-limit errors (for ad-hoc/service-path fetches)`

			`No direct vendor calls from TRPC endpoints, next.js server actions, or agent scripts without rate-limit protection. The app is designed on the principle that stale cached data beats empty/erroring UI.`