ghostfolio/docs/adr/DECISIONS.md

Decisions

Purpose: Quick-scan table of project decisions. For detailed architecture rationale, see docs/adr/.

Last updated: 2026-02-24

ID	Date	What we decided	Alternatives considered	Why we chose this	What would change our mind	Discussion / Evidence
D-001	2026-02-23	Domain focus: Finance agent on Ghostfolio	Healthcare agent on OpenEMR	Faster delivery path, existing finance services, clear verification surface	Repo constraints shift, delivery risk profile shifts, domain requirements shift	docs/requirements.md, docs/PRESEARCH.md
D-002	2026-02-23	Agent framework: LangChain	LangGraph, CrewAI, AutoGen, custom	Fast path to tool orchestration, tracing integration, eval support	Workflow complexity grows and state-machine orchestration brings better latency and reliability	docs/PRESEARCH.md
D-003	2026-02-23	Observability and eval platform: LangSmith	Braintrust, Langfuse, custom telemetry	Integrated traces, datasets, eval loops, quick setup	Cost and trace volume profile shifts, platform limits appear	docs/requirements.md, docs/PRESEARCH.md
D-004	2026-02-23	Delivery workflow: ADR plus RGR	Ad hoc implementation workflow	Better auditability, tighter change control, faster regression detection	Delivery cadence drops or verification burden grows beyond value	docs/PRESEARCH.md, docs/adr/README.md
D-005	2026-02-24	Open source strategy: Multi-platform eval framework release	Single contribution point (LangChain PR only)	Maximize visibility and impact: npm package + LangChain integration + benchmark leaderboards + academic DOI	LangChain contribution accepted early and becomes primary distribution channel	thoughts/shared/plans/open-source-eval-framework.md, docs/requirements.md

Architecture-level decision records live in docs/adr/.