finance

name	finance
description	Finance dispatch — reconciliation sweep with match/pair/dispute decisions, A/R aging chase, and project setup for the finance domain. Reads `ikenga.db` via `host.dbQuery` (SELECT-only); approved decisions dispatch through the host write path. DISPATCH-ONLY: transaction CRUD and payment release belong to the finance app pkg (`com.ikenga.finance`), not here. TRIGGER when the user asks to reconcile transactions, review unmatched ledger rows, chase overdue invoices, or configure the finance skill for this project. DO NOT TRIGGER for transaction CRUD (create/edit/delete), payment release (approve-gate + host own it), or bank pull (external cron). DO NOT run KPI math — cash/burn/runway stays client-side in the pane (R-03 query-collapse). DO NOT send AR follow-ups directly — transport belongs to skill-outbound (R22).
depends_on	["skill-core"]
allowed-tools	Read, Bash, Skill

finance — dispatch-only finance surface

This file is a router. Each action lives in its own file under actions/; load on demand. The state contract (which ikenga.db tables are touched, read-vs-write boundary, dispatch-only scope) is in lib/state.md — read it before building any action.

skill-core note: depends_on: ['skill-core'] is declared above. skill-core ships as com.ikenga.skill-core on ikenga-pkgs main. Per the G-04 contract and the lint spec in 06-skill-action-contract.md §5, no other target is legal.

Query-collapse (R-03): This skill ships ZERO query actions. The Finance pane computes KPI stats (cash/burn/runway/A/R) client-side from host.dbQuery; cross-domain ad-hoc questions route through com.ikenga.skill-query. The R-03 deferral is now a permanent, lintable rule: domain skills are dispatch-only by construction, and a no-query-action constraint is enforced by inspection during DoD review.

No payment release: The approve-gate and the host own payment release. This skill drafts reconciliation decisions for review but never executes bank transfers or payment authorizations.

---

Purpose (one line)

Surface reconciliation decisions for unmatched transactions and overdue A/R — reading ikenga.db state, never owning CRUD.

---

Dispatch actions

Action	File	Mode	One-liner
setup	actions/setup.md	streaming	Configure the finance skill: entities, currencies, runway target, alert thresholds. Writes .atelier/skill-finance/manifest.json.
reconcile-sweep	actions/reconcile-sweep.md	approve	Read unmatched ledger rows + unreconciled inter-company entries; draft match/pair/dispute decisions with confidence evidence; pause for operator approval.
ar-chase	actions/ar-chase.md	approve	Read overdue receivables; draft follow-up decisions; approved draft lands in mail approved-drafts flow (transport = skill-outbound, R22).

All three actions conform to the locked ActionFrontmatter Zod schema in plans/atelier/drafts/action-frontmatter.ts.

---

Routing

If the user says…	Load	Then
"reconcile transactions", "sweep unmatched rows", "match ledger entries", "pair inter-company"	actions/reconcile-sweep.md	Read transaction_ledger (unmatched) + inter_company_entries (unreconciled); draft decisions; pause for approval
"chase AR", "follow up overdue invoices", "Valentim invoice", "A/R aging"	actions/ar-chase.md	Read receivables (overdue); draft follow-up decisions; pause for approval
"setup finance", "configure skill-finance", "finance entities", "runway target"	actions/setup.md	interview mode; confirm entities + currencies + runway target + thresholds in chat; write .atelier/skill-finance/manifest.json

---

What skill-finance does NOT do

• No transaction CRUD — create/edit/delete/classify transactions belongs to the finance app pkg (com.ikenga.finance).
• No payment release — payment authorization belongs to the approve-gate + host path; this skill never executes disbursements.
• No bank pull — nightly bank ingestion (Stripe/Kuda/GTB/Verto) is an external cron (cfo_processing_runs); this skill does not trigger it.
• No query actions — KPI math (cash/burn/runway/A/R totals) stays client-side in the pane (R-03). Ad-hoc ledger questions route through skill-query.
• No send — AR follow-up transport belongs to skill-outbound; this skill drafts the decision and hands off the draft to the mail domain's approved-drafts flow.
• No Supabase — state is local ikenga.db via host.dbQuery/host.dbExec only.
• No direct DB writes — approved reconciliation decisions dispatch through the host write path; the skill never calls host.dbExec directly.

---

Critical files

finance/
├── SKILL.md                      ← you are here (router only)
├── lib/state.md                  ← table-scope contract + read/write boundary
└── actions/
    ├── setup.md                  ← WP-20a body
    ├── reconcile-sweep.md        ← WP-20a body
    └── ar-chase.md               ← WP-20a body