Developer DocsFumadocs + MDXLocal-first

Build from the same runtime truth the operator sees.

Agentic Trader is not a second-order chat demo. These docs are the developer surface for a strict, paper-first trading runtime with inspectable storage, explicit safety gates, and shared contracts across CLI, Ink, observer API, and Web GUI.

Read the docsOpen quick start
Runtime-first
Model service, runtime state, broker state, and review surfaces should agree before we trust a cycle.
Guardrailed
Paper execution, strict LLM gating, provider visibility, and no silent runtime fallbacks remain non-negotiable.
Multi-surface
CLI, Rich, Ink, observer API, and Web GUI all ride the same contracts instead of maintaining UI-only truth.
Current V1 focus
The project is in hardening mode, not in “invent a parallel system” mode.
Optional app-managed Ollama supervision should extend the existing daemon and log surface.
`webgui` stays a thin local shell while `docs` becomes the canonical dev-docs surface.
Bootstrap, provider readiness, and QA evidence are all moving toward a more standardized onboarding path.
Setup
Get Started
Install the repo, run doctor, validate model readiness, and open the main operator surfaces.
Open section
System map
Architecture
Read package ownership, runtime boundaries, and why the repo refuses a parallel orchestration layer.
Open section
Operations
Runtime And Operations
Understand modes, supervision, logs, stop controls, and operator-visible runtime truth.
Open section
Signals
Data And Intelligence
See how market context, provider normalization, and feature bundles feed the agent graph.
Open section
Frontend
Frontend System
Keep `docs` and `webgui` aligned on the shared shadcn preset, JetBrains Mono typography, and modular file organization.
Open section
Continuity
Memory And Review
See how docs, `.ai` notes, feedback drafts, and review artifacts stay aligned with runtime reality.
Open section
Validation
QA And Debugging
Use smoke QA, runtime evidence, and operator-truth checks before treating a change as shippable.
Open section
Setup track
Start with `README.md`, then validate the environment with `doctor`, local model readiness, and the docs quick start.
Architecture track
Use `dev/code-map.md` plus the architecture docs to find the smallest owning module before editing.
Frontend track
`webgui` and `docs` share Next.js App Router, Tailwind v4, and shadcn primitives, but they should not invent a shared package prematurely.

The docs should stay close to the runtime truth, not become a second architecture.