docs(expenses): define ledger maintenance rules

This commit is contained in:
2026-09-03 14:28:28 -07:00
parent a10f7db5e9
commit 0b37501ba1
2 changed files with 35 additions and 7 deletions

14
AGENTS.md Normal file
View File

@@ -0,0 +1,14 @@
# Repository Maintenance Rules
## Expense synchronization
Whenever a document is added or changed and it confirms an actual booked or paid expense, update [`expenses.md`](expenses.md) in the same change.
1. Add or update exactly one ledger row per real expense. Do not duplicate an expense merely because it appears in both a booking file, PDF, email, or itinerary.
2. Do not add shortlist prices, rejected options, refundable deposits, estimated optional fees, or TBC amounts as expenses.
3. Record the payer exactly. **If it is not clear who paid, ask the user before updating the ledger; do not infer the payer.**
4. Preserve the source currency in the ledger. For shared-cost settlement, use the USD amount recorded in Tricount.
5. The accounting couples are **KTVT** (KT + VT) and **LKMS** (LK + MS). Shared expenses are split 50/50 between them unless a source clearly identifies an expense as couple-only.
6. **Couple-only expenses** stay in the ledger for completeness but do not affect the cross-couple settlement.
7. Ignore discrepancies below US$1 when they plausibly result from currency conversion or rounding.
8. After every ledger-row change, recompute the net balance and update the single settlement sentence in `expenses.md`. Show only the final result in the form: **“KTVT owes LKMS US$X.XX.”** (or the reverse).