dirtydishes/islandflow
1
0
Fork 0
Code Issues 3 Pull requests 5 Projects Releases Packages Wiki Activity Actions

document research basis for phase plans

Browse source
This commit is contained in:
dirtydishes 2026-06-16 13:53:54 -04:00
parent eaa22de302
commit 412c8b8af9
19 changed files with 332 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

17
docs/implementation/smart-money/05-api-ui-explainability.md
View file

@ -8,6 +8,23 @@ Expose evidence-backed smart-flow outputs through API, websocket, and UI surface
The presentation layer should wait until contracts, evidence, scoring, and replay evaluation are stable. Otherwise the UI will harden old overconfident language or teach users to trust unvalidated outputs.
## Source documents
- Architecture plan: [`docs/plans/smart-flow-architecture-review.md`](../../plans/smart-flow-architecture-review.md)
- Research report: [`docs/research-docs/smart-flow-market-mechanics.md`](../../research-docs/smart-flow-market-mechanics.md)
These documents are rationale, not added scope. This phase implements only API, websocket, and UI explainability surfaces for validated outputs.
## Research basis
- Users need to see evidence quality, confidence versus conviction, alternatives, and abstention instead of a single certainty label.
- The research supports cautious smart-flow insight projections, not canonical "smart money" facts.
- Why-not and penalty context are part of the product surface because false positives are central to the domain.
## Deferred research ideas
- Advanced explanatory analytics, learned confidence calibration, and broad catalyst intelligence should wait for future scoped work.
## Dependencies on earlier phases
- `islandflow-zxh.1` - Smart-flow contracts and vocabulary