Implementation Map

Implementation Phase Plans

The active planning layer for synthetic market-data and smart-money/smart-flow architecture work. Architecture reviews and research reports are background; phase documents and Beads issues define execution scope.

Active scope guide Synthetic market data Smart flow

Jump to

Document Precedence

  1. Current Beads issue
  2. Referenced phase document under docs/implementation/
  3. Architecture plan under docs/plans/
  4. Research report under docs/research-docs/

This repository uses docs/research-docs/ for research reports; docs/research/ is not present. Research reports provide rationale and useful constraints, but they do not add active implementation scope unless that scope is explicitly pulled into a phase document and Beads issue.

Source Plans

Planning Rules

  • Prefer small, reviewable PRs.
  • Do not implement an entire architecture plan at once.
  • Use Beads issues for execution tracking and dependency management.
  • Keep durable architecture and phase detail in these docs, not in long Beads descriptions.
  • Synthetic data must emit canonical market event types, not synthetic-only pipeline event types.
  • Synthetic labels must remain separate from emitted market events.
  • Smart-flow logic must distinguish facts, evidence, hypotheses, confidence, and abstention.
  • Historical calibration is future work, not an MVP dependency.
  • Early synthetic tests must not require Docker, ClickHouse, NATS, or Redis.
  • Synthetic foundations should come before demos, UI controls, or live service work.

Beads Map

Stream Epic Roadmap
Synthetic market data islandflow-259 - Plan synthetic market-data implementation phases docs/implementation/synthetic-market-data/00-roadmap.html
Smart money / smart flow islandflow-zxh - Plan smart-money to smart-flow implementation phases docs/implementation/smart-money/00-roadmap.html

Dependency Order

Order Phase Beads issue Blocks next because
1ASynthetic deterministic spineislandflow-259.1Establishes seeded raw event generation and provenance assumptions for later synthetic work.
1BSmart-flow contracts and vocabularyislandflow-zxh.1Can safely run in parallel with synthetic phase 01; defines evidence/hypothesis language before scoring work.
2Synthetic manifests, fixtures, and CLIislandflow-259.2Evidence clustering needs deterministic fixtures before broad behavior changes.
3Smart-flow evidence clustering and featuresislandflow-zxh.2Scenario labels need the evidence vocabulary they are expected to exercise.
4Synthetic scenarios, labels, and expected outputsislandflow-259.3Hypothesis scoring needs labeled positive, negative, and abstention cases.
5Smart-flow hypothesis scoring and abstentionislandflow-zxh.3Synthetic replay integration should validate the derived hypothesis pipeline.
6Synthetic replay integrationislandflow-259.4Smart-flow golden tests need replayable synthetic runs.
7Smart-flow replay evaluation and golden testsislandflow-zxh.4Demos should wait until replay proves the semantics.
8Synthetic demo and load profilesislandflow-259.5API/UI explainability should show stable, named, deterministic runs.
9Smart-flow API/UI explainabilityislandflow-zxh.5Final MVP presentation layer after the evidence pipeline is validated.

Future Work

Synthetic historical calibration

islandflow-259.6 depends on synthetic phase 05, but is not required for MVP.

Smart-flow calibration

islandflow-zxh.6 depends on smart-flow phase 05 and synthetic future calibration, but is not required for MVP.