FinSight — trusted variance narratives
FP&A teams need variance commentary they can trust: LLMs hallucinate numbers, purely deterministic systems can't explain them.
1. Ingest · deterministic
Inputs: Provider, accounting, settlement and email records.
Outputs: Normalized statements.
Validation rules: Schema + Pydantic Decimal-only boundaries.
Failure path: Malformed input quarantined with a data-gap notice; pipeline does not guess.
What I built & decided
Financial reconciliation and exception resolution with deterministic controls; the agent investigates and proposes, humans approve auditable actions.
- Hybrid deterministic + LLM layering: engines compute in Decimal, agents only render language (ADR-001).
- Absolute no-math boundary for the LLM, enforced by a CI arithmetic gate (ADR-007).
- Seven-stage validation harness with no-skip enforcement and a final circuit breaker (ADR-009).
- Hard trust boundary with RAG disabled by default and audit-before-AI ordering (ADR-015).
- ADR-001: ADR-001: Hybrid AI Architecture — Deterministic + LLM
- ADR-007: ADR-007: No LLM Calculations — Deterministic Code Owns All Math
- ADR-009: ADR-009: Seven-Stage Validation Harness — No Stage Skip
- ADR-015: ADR-015: AI Trust Boundary — Verified Assertions In, Language Out; Audit Before AI
- decisions: Decision Log
Evidence & limits
- Live-model evaluation is In progress (manual gate, never CI) — do not present FinSight as model-qualified.
- FS-231 financial figures are omitted from v1: the cited golden path was not found in tests/ and units/arithmetic/dated result are unverified.
- Emulator/ministack integration is Tested at most — never present as live third-party proof.
- No production deployment, business-outcome, or performance claims are supported by these records.
source main · synced 2026-10-13
