Senti_AI_Complete_Plan.md

SENTI AI — The Complete Build Plan

The Comprehensive Global Finance AI

Joseph Kariuki | April 2026 | Version 1.2

---

PART 0 — THE BIG PICTURE

What Senti AI Is

Senti AI is a comprehensive, globally scalable Finance AI designed to handle all aspects of financial intelligence. Starting in Kenya as its strategic proving ground—mastering localized financial ecosystems, multilingual support, and complex regulatory requirements—the platform is engineered for rapid international expansion. It features a hybrid deployment model: running securely on global cloud infrastructure for massive scale, while retaining the capability to run locally on-premise for deep privacy and institutional compliance. Senti is the ultimate intelligence layer for personal wealth, business accounting, and global finance.

The Moat: The Four Pillars

Senti is not just "AI that talks about money." Its competitive advantage lies in four distinct capabilities:

1. EXPLAIN finance clearly (Translation and Education).
2. CALCULATE finance correctly (Deterministic Math).
3. MONITOR finance continuously (Real-time Insights).
4. ACT on finance safely (Secure Transactions).

MAJOR UPGRADE — Senti as a Financial Operator

Senti is transitioning from a chatbot to a Financial Operator. It does not just give advice; it thinks, plans, builds, and executes financial work.

THE FOUR MODES OF SENTI

Every Senti response must fall into one of these modes:

1. MODE 1 — ADVISOR: Explains what is happening and what it means (Natural Language).
2. MODE 2 — ANALYST: Reads data, finds patterns, and builds outputs (Excel, PDF, CSV, Dashboards).
3. MODE 3 — PLANNER: Creates budgets, savings plans, and forecasts (Structured Plans + Files).
4. MODE 4 — OPERATOR: Executes safe actions (Invoicing, Tax setup, SMS notifications).

Three Products, One Brain

Product	Data Source	Primary Value
Senti Pro	Core Banking / ERP APIs	Institutional grade — real-time ledger access.
Senti Personal	M-Pesa CSV / Bank API	Savings, budgeting, investments for individuals.
Senti Business	M-Pesa Business / Manual	Bookkeeping, tax, invoicing for SMEs.

---

PART 1 — WHAT YOU HAVE NOW

Operational Components

• Secure Financial Rails — Bank APIs, M-Pesa integrations, and standard internal ledgers.
• Mobile app and webapp — The consumer interface.
• Senti Layer 1 — Data pipeline & Profile builder.
• Senti Layer 2 — NLP engine & Bilingual handler.
• Senti Layer 3 — Neural network (Intent Classifier) & DPO-Trained Fiduciary Brain.
• Senti Layer 4 — Logic engine & Deterministic Math Engine (senti_calc).
• Senti Extensibility — Model Context Protocol (MCP) server & User-Defined Agent Skills.
• FastAPI orchestrator — /process endpoint connecting all layers.

---

PART 2 — THE FULL AI BUILD ROADMAP

Phase	Name	Timeline	Key Deliverable
0	Foundations — Learning PyTorch	Weeks 1–4	Transaction categorizer built from scratch
1	NLP Upgrade — Real Language	Weeks 5–8	Bilingual tokenizer + 500 training sentences
2	Intent Classifier v2	Weeks 9–12	PyTorch NN trained on real financial data
3	Embeddings + Semantic Search	Weeks 13–16	Swahili-English financial word vectors
4	Core Feature NNs	Weeks 17–22	Credit scorer & anomaly detector
5	Rules + Smart Money Engine	Weeks 23–26	Savings automation & tax modules
6	Mistral 7B Integration	Weeks 27–32	LLM plugged in as the language layer
7	Fine-Tuning Senti's Voice	Weeks 33–40	Mistral fine-tuned on global financial data
8	Expansion — The 30 Disciplines	Months 10–14	Specialized modules for all 30 finance sectors
9	Global Scale + Hybrid Cloud	Months 15–18	Multi-region deployment & international APIs
10	Senti Global Launch	Month 24	The complete Finance AI Brain live globally

---

PART 3 — THE MASTER SCOPE (30 DISCIPLINES)

Senti AI is architected to master the entire "money universe" across these 30 sectors:

1. Personal Finance: Budgeting, savings, debt tracking, and affordabilty.
2. Business Finance: Revenue tracking, cash flow, and health scoring for SMEs.
3. Corporate Finance: Capital planning, forecasting, and scenario planning.
4. Banking: Account insights, statement analysis, and loan prequal.
5. Payments & Collections: Invoicing, reconciliation, and payment reminders.
6. Lending & Credit: Credit scoring, risk estimation, and debt restructuring.
7. Accounting: Bookkeeping automation, ledgers, and statement generation.
8. Taxation: Multi-country tax calculation (PAYE, VAT, etc.) and reminders.
9. Insurance: Premium estimation, quote comparison, and claims guidance.
10. Wealth Management: Projections, risk profiling, and asset allocation.
11. Capital Markets: Market explainers, stock/bond education, and comparisons.
12. Treasury Management: Cash forecasting, FX exposure, and liquidity tracking.
13. Risk Management: Default scoring, anomaly detection, and stress testing.
14. Fraud & Compliance: AML flagging, pattern analysis, and KYC support.
15. Financial Advisory: Retirement, school fees, and savings roadmaps.
16. Reporting & Audit: Auto-generated summaries and audit trails.
17. **Budgeting & Forecasting:**Category limits, burn-rate, and "what-if" scenarios.
18. Cash Flow Management: Shortfall alerts and receivables monitoring.
19. Asset & Liability (ALM): Maturity analysis and liquidity matching.
20. Portfolio Management: Diversification checks and rebalancing suggestions.
21. Trading & Analysis: Volatility tracking and educational guidance.
22. Forex & Remittance: Currency conversion and FX risk awareness.
23. Microfinance/SACCO: Member profiling and loan appraisal.
24. SME & Merchant Finance: POS recording and inventory-linked finance.
25. Public Finance: Budget explainers and expenditure tracking.
26. Fintech Infrastructure: API intelligence and transaction state machines.
27. Regulatory & Legal: Versioned law tracking and rule interpretation.
28. Consumer Protection: Scam detection and safe-advice refusal.
29. Behavioral Finance: Spending habit analysis and emotional nudges.
30. Financial Literacy: Glossary support and multilingual teaching.

---

PART 4 — THE MASTER PROMPTS

Prompt A — The Build Prompt (Use for every coding session)

You are helping me build Senti AI — a comprehensive, globally scalable Finance AI designed to handle all aspects of financial intelligence, featuring a hybrid deployment model (global cloud + local on-premise). Our moat is the 4 Pillars: Explain, Calculate, Monitor, Act across 30 finance disciplines. [Insert Full Context from Roadmap...] CURRENT TASK: [REPLACE THIS LINE]

---

Follow the plan. Ship the work. Build in public.