agentleFS
peterbamuhigirepeterbamuhigire/business-plan-skills/skills/meta-finance/meta-agent-sla-financial-controls/SKILL.md

meta-agent-sla-financial-controls

Skill4 starsChanged 19 days agoMITView on GitHub

Use when the agent business has SLA-credit, refund, prepaid-credit, or outcome-pricing variable revenue. Use financial projections for model construction.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No single role both approves and books.

    line 137
  2. Distinctive:

    Every credit / refund logged in the ticketing / billing system

    line 141
  3. Distinctive:

    Document control mapping for attestation pack.

    line 155
  4. Distinctive:

    Document control narratives for each SLA-related process

    line 160
  5. Distinctive:

    No SOC1 mapping when institutional round in scope

    line 195

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md
<!-- dual-compat-start -->

Meta — Agent SLA Financial Controls Skill

Workflow

  1. Confirm the decision audience, scope, current evidence, and applicable finance doctrine.
  2. Apply the ordered domain analysis below and reconcile every calculation to its source.
  3. Record the decision, exceptions, reviewer, and next evidence action before release.

Decision, stop, and recovery controls

  • Decision point: confirm that the requested output is the SLA financial-control matrix and that the decision concerns which credit and reserve controls are mandatory.
  • Stop condition: halt the affected conclusion if required evidence is missing (SLA credit terms, reserve method, and approver roles) or if the work could lead to this identified risk: unapproved credits or an unsupported reserve reaching the ledger.
  • Recovery: obtain the missing record or reviewer, repeat the affected check, and update the exception record before release.

Overview

Bankability scorecards (DFI, institutional) increasingly check financial-control maturity around variable revenue. SLA credits, outcome refunds, prepaid breakage, and dispute resolution are all variable-revenue mechanisms that without controls expose the business to:

  • Unapproved credits drain revenue
  • Inconsistent credit decisions invite gaming
  • Reserve methodology drift without governance produces audit findings
  • Dispute backlog accumulates quietly
  • SOC1 / SOC2 attestation fails for financial reporting controls

This meta-skill installs the SLA financial-control discipline as a documented, named, owned, auditable system.

Use When

  • The agent business has SLA-credit, refund, prepaid-credit, or outcome-pricing variable revenue
  • A SOC1 / SOC2 attestation is being pursued
  • Institutional / DFI DD has asked about financial controls
  • Bankability scorecard checks control maturity
  • An auditor / internal-audit function is being installed
  • Cross-loaded with meta-agent-revenue-recognition-policy, saas-agent-deferred-revenue-and-credit-reserves, meta-accounting-finance-review

Do Not Use When

  • The agent business has no variable revenue (all flat subscription)
  • The plan is pre-revenue and controls are premature (use directional treatment)
  • Route to 10-financial-projections instead when the task is to construct the underlying model.

Required Inputs

Input artefactSource / providerRequired?If missing
SLA, refund, prepaid-credit, and reserve termsSigned contracts, billing owner, finance controllerYesStop control design and request the governing terms.
Approval roles and system capabilitiesApproved org chart, ERP or billing administratorYesReturn a qualified control-gap assessment only.
Dispute and credit historyFinance records and customer-success registerConditionalMark trend and reserve calibration not assessed.
  • SLA terms and credit policy
  • Refund policy
  • Prepaid-credit terms
  • Dispute history (where available)
  • Reserve methodology (per saas-agent-credit-reserve-methodology.md)
  • Org chart and role inventory (CFO, Controller, Head of CS, Legal, Customer Success Managers)
  • ERP / billing-system capability (does it enforce approvals?)
  • Auditor / internal-audit appointment status

1. Design the SLA-credit approval workflow

Per references/saas-agent-sla-financial-controls-policy.md:

Credit sizeApproverDocumentation required
<$500Customer Success Manager (with audit trail)Credit reason code; affected customer; breach evidence
$500-$5,000Head of CSAbove + customer comms; cause analysis
$5,000-$25,000CFO + Head of CSAbove + reserve impact; cause analysis
>$25,000 or material to a customer's annual feeCEO + CFO + LegalAbove + remediation plan
Pattern / multiple sev-1 affecting many customersBoard / audit committee notificationAbove + plan for board pack

Document:

  • Authorities matrix
  • Approval system (ERP / billing workflow)
  • Evidence requirements per level
  • Approval-cycle SLA (response time)

2. Design refund approval workflow

Similar to credits:

Refund sizeApprover
<$500Customer Success Manager
$500-$5,000Head of CS
$5,000-$25,000CFO
>$25,000CEO + CFO + Legal

3. Document the reserve methodology governance

  • Methodology document signed by CFO
  • Quarterly true-up by Controller + CFO
  • Annual review by external auditor
  • Reserve roll-forward reconciled at month-end close
  • Variances documented and explained
  • Methodology change requires CFO approval + auditor concurrence

4. Design the dispute escalation chain

Dispute stageOwnerTimeline
Initial customer claimCustomer Success ManagerRespond within 48 hours
InvestigationCustomer Success Manager + Head of Agent5 working days
Resolution / settlementHead of CS7 working days from claim
Escalation if unresolvedCFO + Legal14 working days
Escalation to mediation / arbitrationCEO + Legal30 working days
LitigationLegal + CEO + Board notificationAs required

Each stage:

  • Documented evidence requirements
  • Decision authority
  • Settlement-authority threshold
  • Audit-log evidence captured

5. Implement segregation of duties

  • Credit / refund approval: customer-facing (CS / Head of CS / CFO / CEO)
  • Credit / refund accounting entry: Controller / Accounts
  • Reserve calculation: Controller
  • Reserve approval: CFO
  • Reserve audit: external auditor + audit committee

No single role both approves and books. Document the segregation.

6. Implement audit trail

  • Every credit / refund logged in the ticketing / billing system
  • Log captures: customer, amount, currency, reason code, breach evidence, approver, approval date, processing date, ERP entry reference
  • Audit log is immutable
  • Periodic integrity verification

7. Wire to SOC1 / SOC2

Map controls to SOC1 / SOC2 control categories:

  • Control environment (org structure, segregation)
  • Risk assessment (variable-revenue risk register)
  • Control activities (approvals, reconciliations, segregation)
  • Information and communication (audit trail, reporting)
  • Monitoring (variance review, quarterly true-up)

Document control mapping for attestation pack.

8. Wire to financial reporting controls (ICFR)

For companies pursuing IPO or institutional rounds requiring ICFR-equivalent discipline:

  • Document control narratives for each SLA-related process
  • Test controls quarterly
  • Remediate exceptions
  • Annual management assertion

9. Wire to insurance and indemnity

  • Insurance coverage scope tested against control posture
  • Self-insurance reserve sized for coverage gaps
  • Indemnity caps in contracts cross-checked

10. Wire to living-plan governance

Per cadence below.

Quality Bar

  • SLA-credit approval workflow documented with thresholds and evidence requirements
  • Refund approval workflow documented
  • Reserve methodology governance documented (CFO sign-off; auditor review)
  • Dispute escalation chain documented with timelines
  • Segregation of duties documented
  • Audit trail captured and immutable
  • SOC1 / SOC2 control mapping (where applicable)
  • ICFR readiness (where applicable)
  • Insurance scope tested
  • A sceptical audit committee chair would accept the controls

Anti-Patterns

  • Credits approved verbally without audit trail
  • Credit approval threshold absent (all credits informally approved)
  • Reserve methodology in a spreadsheet without governance
  • Dispute backlog without escalation discipline
  • Segregation of duties violated (CS approves AND books)
  • No SOC1 mapping when institutional round in scope
  • Audit trail mutable
  • Insurance scope assumed without testing
  • "We trust each other" as the control framework — fails first DD
  • Applying the wrong neighbouring route to meta agent sla financial controls. Correction: confirm the decision and route to the named neighbour before analysis.
  • Treating an assumption as verified evidence. Correction: label it, cite its source or owner, and assign a verification action.
  • Recommending action without a decision threshold. Correction: state the measurable acceptance condition and review trigger.
  • Recording an unavailable check as passed. Correction: mark it not assessed and state the consequence for the decision.
  • Mutating or publishing during an analysis-only task. Correction: remain read-only until the owner gives explicit authority.

Outputs

ArtefactConsumerObservable acceptance condition
Sla Financial Controls deliverableNamed decision-maker or plan authorThe recommended choice, assumptions, countercase, and next action are explicit.
Evidence and exception registerReviewer, funder, board, or implementation ownerEvery load-bearing claim is sourced or labelled as an assumption; missing checks are not shown as passes.
  • SLA-credit approval workflow document
  • Refund approval workflow document
  • Reserve methodology governance document
  • Dispute escalation chain document
  • Segregation-of-duties matrix
  • Audit-trail design
  • SOC1 / SOC2 mapping (where applicable)
  • ICFR readiness assessment (where applicable)
  • Insurance / indemnity cross-check
  • Living-plan cadence assignment

Living-Plan Cadence Defaults

ElementCadenceOwnerVariance threshold
Credit / refund audit-trail reviewweeklyControllermissing evidence
Reserve roll-forward reconciliationmonthlyController + CFOunexplained variance
Reserve methodology true-upquarterlyCFO + Controller + Auditormethodology change
Dispute backlog reviewweeklyHead of CS + Legal>5 disputes aged >7 days
Segregation-of-duties testquarterlyInternal audit / Controllerexception
Control narrative refreshannuallyCFO + Internal auditprocess change
SOC1 / SOC2 attestationannuallyCFO + SOC auditorgap
Insurance coverage reviewsemi-annuallyCFO + Legalexclusion
Audit committee reportquarterlyCFO + Audit Committeefindings

References

  • references/saas-agent-sla-financial-controls-policy.md — full controls policy
  • skills/meta-finance/meta-agent-revenue-recognition-policy/SKILL.md — policy declaration
  • skills/pipeline/10-financial-projections/saas-agent-deferred-revenue-and-credit-reserves/SKILL.md — reserves
  • skills/pipeline/10-financial-projections/saas-agent-sla-cogs-treatment/SKILL.md — classification
  • skills/meta-finance/meta-accounting-finance-review/SKILL.md — accounting review parent
  • skills/pipeline/12-risk-analysis/saas-agent-sla-risk/SKILL.md — risk register
  • skills/pipeline/14-ai-integration/references/ai-agent-sla-layer-archetypes-and-handoffs.md — audit
  • skills/pipeline/10-financial-projections/references/finance-operating-system-and-controls-checklist.md — controls reference

Africa / Uganda Application Notes

  • Local audit firm acceptance — KPMG, PwC, Deloitte, EY accept SOC1-style controls directly; mid-tier firms may benefit from policy walk-through
  • DFI DD on controls — IFC / AfDB / FMO / BII expect control narratives + segregation-of-duties evidence
  • ERP / billing system capability — local accounting software (Sage, QuickBooks, Tally, Pastel) may not enforce approval workflow natively; use ticketing-system + manual reconciliation
  • Mobile-money settlement audit-trail — MoMo / M-Pesa transaction logs are immutable and auditor-acceptable; useful for refund-trail evidence
  • Public-sector dispute escalation — disputes with public-sector customers go through procurement / accounting general; legal capacity required; reserve appropriately
  • Sovereign-AI compliance overlap — sovereign-AI tenders often require local-citizen-headcount audit; SLA control system should map to local compliance discipline
  • Insurance availability — AI E&O thin in Africa; self-insurance reserve essential; document the gap transparently
  • Currency-of-record — controls must address local-currency credit issuance vs USD reporting reconciliation

Evidence Produced

EvidenceFormatAcceptance condition
SLA financial-control matrix decision traceSources, calculations, assumptions, countercase, and selected actionA reviewer can trace the selected action and rejected alternatives to the cited inputs.
Exception recordFailed and not-assessed checks with owner and due actionThe register exposes every unresolved exception that could lead to unapproved credits or an unsupported reserve reaching the ledger.

Capability and Permission Boundaries

Read supplied records and use non-mutating checks to produce the SLA financial-control matrix; drafting control narratives and approval thresholds is permitted when requested. Do not publish, contact third parties, alter live systems, commit funds, or claim legal, tax, audit, valuation, ESG, or investment assurance without the owner's explicit authorisation and the appropriate reviewer.

Degraded Mode

If SLA credit terms, reserve method, and approver roles cannot be obtained, return a qualified SLA financial-control matrix covering only the checks that remain supportable. Leave this decision unresolved: which credit and reserve controls are mandatory. Record the evidence owner and next check; an inaccessible source, tool, or reviewer is never a pass.

Decision Rules

Decision conditionActionFailure or risk avoided
Evidence is sufficient to decide: which credit and reserve controls are mandatoryRecord the conclusion, source trail, owner, and review trigger in the SLA financial-control matrix.Risk of unapproved credits or an unsupported reserve reaching the ledger
Material evidence conflicts or remains uncertainWalk one credit, refund, and reserve true-up through the proposed approvals before accepting the control design.Selecting an option without resolving the decision-relevant uncertainty
Required evidence is missing: SLA credit terms, reserve method, and approver rolesMark the decision on which credit and reserve controls are mandatory not assessed in the SLA financial-control matrix, and send it to the controller and SLA control owner.Otherwise, the work risks unapproved credits or an unsupported reserve reaching the ledger

Quality Standards

Accept the SLA financial-control matrix only when evidence is sufficient for this decision: which credit and reserve controls are mandatory. Assumptions and countercases remain visible, calculations and cross-references reconcile, and the reviewer can see how the recommendation addresses the risk of unapproved credits or an unsupported reserve reaching the ledger.

Worked Example

A customer-success manager can issue large SLA credits directly in billing. The control matrix introduces evidence, approval, and reserve true-up steps, then tests them on a sample credit before release.

Finance Doctrine Gate

Apply the Chwezi doctrine to the SLA financial-control matrix, using the reporting basis and effective date supported by SLA credit terms, reserve method, and approver roles. Reconcile the treatment to the model and narrative, and have the controller, control owner, and appointed auditor review the treatment, reconciliation, and exposure to this risk: unapproved credits or an unsupported reserve reaching the ledger.

<!-- dual-compat-end -->

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.