| name | saas-agent-revenue-recognition |
| description | Use when producing or reviewing the saas agent revenue recognition component of a business plan; applies its specialist evidence, decisions, and acceptance tests instead of neighbouring pipeline skills. |
| metadata | {"portable":true,"compatible_with":["claude-code","codex"]} |
SaaS Agent Revenue Recognition Skill
Overview
Standard SaaS revenue recognition assumes a ratable subscription with a single performance obligation delivered over time. Agent revenue does not behave that way:
- Per-resolution pricing triggers recognition at a point in time — when the customer accepts that the ticket is resolved.
- Per-outcome pricing triggers recognition at a point in time — when the counter-party process verifies the outcome (recovery posted, code accepted by payer, document filed and accepted, claim paid).
- Subscription + success-fee hybrid has two distinct performance obligations and a transaction-price allocation problem.
- Prepaid task credits create deferred revenue with breakage estimation under ASC 606 BC394 / IFRS 15.B46.
- Outcome-conditional revenue is variable consideration that must be estimated and then constrained.
- Marketplace agents that orchestrate third-party tools or services require a principal-vs-agent determination at the gross-vs-net revenue boundary.
Getting this wrong destroys investor trust, attracts audit qualification, and (most commonly) overstates revenue. Investors and auditors are increasingly explicit about agent rev-rec policy in 2026 because the patterns are new and the prior-period restatement risk is real.
This skill installs the agent revenue recognition discipline — the per-pricing-primitive policy memo that auditors and DD teams will request.
Use When
- A SaaS / ICT plan ships an agent product priced on per-resolution, per-outcome, prepaid credits, subscription + success fee, or any other non-ratable primitive
- The plan must pass an audit (Big-4 / regional firm) or DFI / institutional DD
- An auditor or DD team has requested the revenue recognition policy memo
- The plan involves outcome-conditional revenue and the variable-consideration treatment must be defensible
- An agent platform sells to other agent builders and the principal-vs-agent test must be applied
- The financial model recognises agent revenue and the recognition trigger must be reconciled with the cash and billing cycle
- Cross-loaded with
saas-agent-pricing-strategy and saas-agent-deferred-revenue-and-credit-reserves
Do Not Use When
- The agent product is priced on a flat monthly subscription with a single deliverable (use standard SaaS rev-rec)
- The plan is pre-revenue and the pricing primitive is not yet committed (use directional treatment)
- The product is internal-efficiency only with no external customer (rev-rec does not apply)
Required Inputs
- Pricing primitive(s) in use (from
saas-agent-pricing-strategy)
- Contract templates or commercial-term sheets (from proposal session)
- Definition-of-done for "resolved" / "outcome" / "successful task" — must be objectively measurable
- SLA terms (credit % per breach; credit caps; credit currency)
- Refund policy (full / partial / none)
- Prepaid-credit terms (expiry; non-refundable; transferable; rollover)
- Variable-consideration scope (success fees, volume rebates, performance bonuses)
- Principal-vs-agent indicators (control of the service before transfer; primary responsibility; inventory risk; pricing discretion)
- Tax jurisdiction and applicable framework (US GAAP / IFRS / local GAAP)
- Audit firm (if appointed) and any prior rev-rec opinion on related products
Workflow
Apply the ordered stages below; stop and recover when a stage lacks its required evidence.
1. Identify the pricing primitive(s) in scope
Map each revenue line in the plan to one of:
- Per-resolution / per-task — point-in-time recognition at acceptance
- Per-outcome — point-in-time recognition at counter-party verification
- Subscription / platform fee — ratable over contract term
- Success fee on top of subscription — variable consideration; estimated + constrained
- Prepaid task credits — deferred revenue, recognised as credits consumed; breakage estimated
- Per-agent or per-seat tier — ratable over contract term
- Per-step (platform / infrastructure) — usage-based; recognised as steps consumed
- Outcome-based with refund — variable consideration; recognised net of expected refunds (constrained)
- SLA-tier (bronze / silver / gold) — ratable per tier; SLA credits are reductions in transaction price
If multiple primitives are bundled in a single contract, treat each as a distinct revenue stream and apply the ASC 606 5-step model to the contract as a whole.
2. Apply the ASC 606 / IFRS 15 five-step model
Per references/saas-agent-revenue-recognition-policy-template.md — for each contract / contract type:
- Identify the contract — enforceable rights and obligations; commercial substance; collectability probable
- Identify the performance obligations — distinct goods or services; capable of being distinct + distinct in the context of the contract; common patterns:
- Subscription / platform access = one performance obligation, delivered over time
- Per-resolution agent service = a series of distinct services treated as a single performance obligation only if they meet ASC 606-10-25-15 (substantially the same + same pattern of transfer); typically agent resolutions are each distinct services recognised point-in-time per resolution
- Implementation / onboarding = separate performance obligation if distinct, else combined with subscription
- Success fee = often a separate performance obligation tied to a specific outcome
- Determine the transaction price — fixed + variable + financing component + non-cash + consideration payable to customer:
- Variable consideration for outcome pricing, success fees, volume rebates, refund risk — estimate using expected-value (probability-weighted) or most-likely-amount method, whichever better predicts entitled consideration
- Constraint on variable consideration (ASC 606-10-32-11) — include only the amount for which it is probable a significant reversal will not occur; this is the discipline-keeping step
- SLA credits — reduction in transaction price; estimate expected credits using same approach as variable consideration
- Refund liability — reduction in transaction price for the portion expected to be refunded
- Allocate the transaction price to performance obligations — based on standalone selling price (SSP); use observable SSP if available, else estimate (adjusted market assessment, expected cost plus margin, residual approach where permitted)
- Recognise revenue when (or as) each performance obligation is satisfied:
- Point-in-time for per-resolution / per-outcome / per-task — recognise when customer obtains control (typically acceptance / verification)
- Over time for subscription / platform access — recognise ratably
- Series guidance where applicable for repetitive distinct services
3. Determine recognition trigger per pricing primitive
| Primitive | Recognition trigger | Evidence required |
|---|
| Per-resolution | Customer acceptance of resolved ticket | Acceptance log; auto-acceptance after N hours of no rejection; tracked in ticketing system |
| Per-outcome | Counter-party verification of outcome (claim paid; code accepted; document filed) | Counter-party confirmation; objective external evidence |
| Subscription / platform fee | Ratable over contract term | Contract term in writing; service available |
| Success fee | Outcome achieved + counter-party verified | Same as per-outcome |
| Prepaid task credits | As credits consumed | Credit consumption log; per-credit policy |
| Breakage on prepaid | When customer's exercise of remaining rights becomes remote (typically tracked using historical breakage %) | Breakage estimate documented |
| Per-step (platform) | As steps invoked and metered | Metering log |
| SLA tier | Ratable over tier term; SLA credits reduce transaction price | Tier purchase + SLA-credit accrual |
4. Treat variable consideration
For outcome pricing, success fees, volume rebates, and refund risk:
- Estimation method: expected-value (probability-weighted across a range) is appropriate for many outcomes; most-likely-amount is appropriate when only two outcomes are possible (succeed / fail)
- Constraint: include the variable consideration only to the extent it is probable (US GAAP) / highly probable (IFRS) that a significant reversal will not occur when the uncertainty resolves
- Reassessment: update estimates at each reporting date; recognise change as cumulative catch-up
Worked example: a collections agent on per-outcome pricing earns 12% of recovered amount; historical recovery rate on assigned PAR>90 portfolios is 35%; portfolio value $1,000,000. Expected variable consideration = 35% × $1,000,000 × 12% = $42,000. Apply constraint: if historical variation is wide (e.g. 20-50% recovery), constrain to (e.g.) $30,000 — the amount for which it is probable no significant reversal will occur. Recognise $30,000 as cumulative recoveries occur; book the additional $12,000 over time as variability resolves.
5. Apply principal-vs-agent analysis
For agents that orchestrate third-party services (calling external APIs, brokering services, paying suppliers on behalf of customer):
- Principal indicators: primary responsibility for fulfilling the promise; inventory risk before or after transfer; discretion in establishing the price — recognise revenue gross
- Agent indicators: another party primarily responsible; no inventory risk; no pricing discretion — recognise revenue net (the commission only)
This determination materially changes top-line ARR and gross margin reporting. Document the test outcome and the indicators relied upon.
6. Treat contract modifications
Agent contracts modify often (autonomy expansion; new action class promoted; pricing change; SLA tier upgrade). For each modification:
- Separate contract if the modification adds distinct goods or services at standalone selling price
- Termination + new contract if the remaining services are distinct and price reflects fair standalone value
- Cumulative catch-up if the remaining services are not distinct
Document the modification treatment in the policy memo.
7. Document the auditor-ready policy memo
Per references/saas-agent-revenue-recognition-policy-template.md, produce a policy memo covering:
- Each pricing primitive in scope
- Performance obligations identified
- Transaction price determination including variable consideration method
- Constraint applied with reasoning
- Allocation method
- Recognition trigger with evidence
- Principal-vs-agent conclusion
- Contract-modification policy
- Examples and edge cases
- Cross-reference to the deferred revenue and reserve methodologies
This memo is the artefact that audit firms request. Without it, the plan is not audit-ready.
8. Wire to the financial model
- Each revenue line in the projection traces to a recognition trigger
- Variable consideration is shown net of constraint
- Refund and SLA-credit reserves are visible as reductions in transaction price
- Deferred revenue is visible on the balance sheet
- Breakage assumption is documented
- The cash and revenue lines reconcile (per-resolution cash can lead revenue by 1-3 days under mobile-money; enterprise per-outcome cash can lag revenue by 30-90 days)
9. Wire to living-plan governance
Assign cadence and owners per the cadence table below.
Quality Bar
- Each revenue line in the plan maps to a documented pricing primitive
- The ASC 606 / IFRS 15 5-step analysis is shown explicitly (not implied)
- Variable consideration is estimated and constrained
- The constraint is non-trivial (auditors test whether the constraint was applied)
- Principal-vs-agent analysis is performed for marketplace / orchestration revenue
- Recognition trigger is named per primitive and tied to an evidence source
- Contract-modification policy is stated
- A worked example for each pricing primitive is in the policy memo
- The memo is written to auditor standard (defensible in a comment letter)
- Cross-referenced to deferred-revenue and reserve methodologies
- A Big-4 partner reviewing the plan would not laugh at the policy
Anti-Patterns
- "We recognise on invoice" without identifying the performance obligation
- Recognising the full success-fee at contract signing — fails variable-consideration constraint
- Treating prepaid credits as revenue when sold — fails deferred-revenue rule
- No principal-vs-agent analysis for marketplace agents — overstates ARR and gross margin
- "We follow ASC 606" without showing the 5 steps — auditors test the steps
- Recognising per-resolution at billing rather than at acceptance — creates timing distortion
- No constraint on variable consideration — overstates current revenue
- No reassessment cadence for variable consideration — stale estimates persist
- Treating SLA credits as a marketing expense — they are a transaction-price reduction
- Recognising prepaid breakage at year-end without a defensible historical pattern
- Bundling subscription + success fee into one performance obligation — fails the distinct test
Outputs
- Pricing primitive inventory with recognition trigger per primitive
- ASC 606 / IFRS 15 5-step analysis per contract type
- Variable-consideration estimation and constraint documentation
- Principal-vs-agent analysis (where applicable)
- Auditor-ready revenue recognition policy memo
- Contract-modification policy
- Worked examples per primitive
- Cross-reference to deferred revenue and reserves
- Cross-reference to SLA-COGS treatment
- Living-plan cadence assignment
Living-Plan Cadence Defaults
| Element | Cadence | Owner | Variance threshold |
|---|
| Revenue recognition by primitive (variance vs plan) | monthly | CFO + Controller | -5% by primitive |
| Variable-consideration estimate reassessment | quarterly | Controller | estimate change >10% |
| Constraint reassessment | quarterly | Controller + CFO | constraint change |
| Principal-vs-agent reassessment | quarterly | Controller + CFO | service-flow change |
| Breakage estimate reassessment | quarterly | Controller | historical-pattern change |
| Policy memo refresh | annually + on new primitive | CFO + Controller + Auditor | new pricing primitive |
| Contract-modification log | continuous + monthly | Controller | modification volume spike |
References
references/saas-agent-revenue-recognition-policy-template.md — policy memo template with worked examples per primitiveskills/10-financial-projections/saas-agent-deferred-revenue-and-credit-reserves/SKILL.md — liability sideskills/10-financial-projections/saas-agent-sla-cogs-treatment/SKILL.md — COGS-vs-contra-revenueskills/10-financial-projections/saas-agent-unit-economics-and-cogs/SKILL.md — unit economicsskills/07-marketing-sales-strategy/saas-agent-pricing-strategy/SKILL.md — pricing primitivesskills/meta-agent-revenue-recognition-policy/SKILL.md — meta policy declaration disciplineskills/meta-accounting-finance-review/SKILL.md — accounting review gateskills/meta-living-plan-governance/SKILL.md — governance parentbook-extractions/agent-sla-commercial-business-plan-audit-2026.md — this auditbook-extractions/agent-products-business-plan-audit-2026.md — agent product auditbook-extractions/accounting-bookkeeping-finance-controls-extraction.md — controls
Africa / Uganda Application Notes
- Mobile-money settlement timing — per-resolution agent revenue collected through MoMo / M-Pesa / Airtel Money / Wave / Orange Money settles T+0 to T+2; recognition trigger is still customer acceptance, not settlement, but the cash-vs-revenue reconciliation must be explicit. Recognise at acceptance; receivable until settlement; collected on settlement; reconcile daily.
- IFRS in Africa — most African markets (KE, NG, ZA, UG, TZ, RW, GH) use IFRS; Egypt uses EAS with IFRS convergence. IFRS 15 applies with effectively the same 5-step model as ASC 606; small wording differences (highly probable vs probable in the constraint) matter.
- VAT timing — VAT in Uganda (18%), Kenya (16%), Nigeria (7.5%), South Africa (15%), Rwanda (18%) is invoice-based, not revenue-recognition-based; for per-resolution micro-billing, VAT is on invoice issued, not on each individual resolution recognised. Document the VAT-vs-revenue-recognition reconciliation.
- Withholding tax on services in Uganda (6% under Sched 6), Kenya (variable), Nigeria (5%), South Africa (none on services), Rwanda (variable) — affects net receivable and the cash-vs-revenue line.
- FX revaluation — if revenue is recognised in local currency but reported in USD, FX revaluation under IAS 21 / ASC 830 is unavoidable; document the policy.
- Public-sector receivables in Africa can age 90-180 days — variable-consideration constraint must include collectability risk explicitly; high-DSO contracts may fail the "probable" collectability test, deferring recognition.
- Sovereign-AI procurement contracts often include local-currency pricing with USD index; treat the USD-index adjustment as variable consideration and apply the constraint.
- DFI / multilateral pilots sometimes pay on milestone delivery rather than ratable; treat each milestone as a performance obligation if distinct.
- Audit firms in-region — KPMG, PwC, Deloitte, EY have full IFRS 15 capability; mid-tier (BDO, RSM, Mazars, Grant Thornton) typically do; smaller local firms may need policy-memo support — provide it.
July 2026 Portable Contract
Required Inputs
| Input artefact | Source/provider | Required | Behaviour when absent |
|---|
| Approved commercial assumptions, contracts, usage/cost evidence, accounting framework, opening position, and projection horizon for saas agent revenue recognition | Client records, approved operating model, finance owner, and accounting doctrine | Yes | If absent, contract terms, usage evidence, framework, or cost drivers are unavailable, isolate the affected schedule, label it unassessed, and do not force the model to balance with a plug. |
| Finalised business brief, target reader, country, and stage | Client intake and engagement owner | Yes | Stop section decisions and route the missing context to client intake. |
| Reconciled upstream assumptions that this section consumes | Named pipeline owners | Conditional | Record the dependency, affected claim, owner, and recovery step; do not substitute an invented value. |
Outputs
| Artefact | Consumer | Observable acceptance condition |
|---|
| Revenue-recognition policy schedule and contract-liability bridge | Plan author and target decision-maker | The artefact answers the section decision and traces each material conclusion to the supplied evidence. |
| saas agent revenue recognition exception and handoff note | Downstream section owners | Every blocked or conditional item names its consequence, owner, evidence request, and restart condition. |
| saas agent revenue recognition release record | Reviewer or plan assembler | Records the checks completed, failures, unassessed items, professional review required, and release state. |
Evidence Produced
| Evidence | Format | Acceptance condition |
|---|
| Formula trace, source/assumption register, three-statement or schedule reconciliation, and finance-gate record | Source-linked table, calculation, or annotated prose | The evidence is reproducible from named inputs and distinguishes verified fact, management assumption, and inference. |
| saas agent revenue recognition decision record | Decision note | States the selected action, rejected credible alternative, countercase, rationale, and risk accepted or avoided. |
| saas agent revenue recognition review trace | Gate entry | Identifies the date, input versions, reviewer role, failed checks, recovery owner, and any check that remains not assessed. |
Capability and Permission Boundaries
For saas agent revenue recognition, the controlling focus is contract identification, performance obligations, transaction price, principal-agent assessment, and recognition timing. This skill may inspect records and calculate planning scenarios in read-only mode; it may not post entries, change ledgers, set accounting policy, certify IFRS treatment, or release statutory values without authorised professional review. Its normal mode is read-only analysis and drafting. Any mutation, external communication, spending, certification, or professional conclusion outside that boundary requires explicit authority and must remain traceable to the approving role.
Degraded Mode
For saas agent revenue recognition, loss of evidence about contract identification, performance obligations, transaction price, principal-agent assessment, and recognition timing activates degraded mode. If the controlling saas agent revenue recognition evidence is unavailable, the same boundary applies. When contract terms, usage evidence, framework, or cost drivers are unavailable, isolate the affected schedule, label it unassessed, and do not force the model to balance with a plug. Return the verified subset, label the affected decision qualified or not assessed, explain the downstream consequence, and state the smallest evidence request or authorised action that permits recovery. Do not convert the missing check into a pass.
Decision Rules
| Choice or condition | Action | Failure or risk avoided |
|---|
| For saas agent revenue recognition, commercial billing, cash receipt, service delivery, and accounting recognition occur in different periods | model each event separately, reconcile the bridge, and route judgemental treatment to the finance reviewer | Cash, revenue, liability, and margin can be conflated into a misleading forecast |
| For saas agent revenue recognition, A current legal, regulatory, tax, accounting, market, or platform claim controls the saas agent revenue recognition decision | Verify the controlling source, effective date, jurisdiction, and reviewer status before release | Stale external facts become permanent plan assumptions |
| For saas agent revenue recognition, The evidence reconciles with neighbouring sections and the countercase does not overturn the choice | Complete revenue-recognition policy schedule and contract-liability bridge, attach the evidence and release record, and hand off named dependencies | Premature release and repeated downstream rework |
Workflow
- Define the exact saas agent revenue recognition decision, intended reader, jurisdiction, business stage, and permission boundary.
- Collect approved commercial assumptions, contracts, usage/cost evidence, accounting framework, opening position, and projection horizon and map each material conclusion to its source; stop the affected conclusion when an input could change it.
- Apply the specialist methods and directly linked references already contained in this skill, retaining its domain thresholds, calculations, and Uganda or East Africa context where applicable.
- Compare the credible alternatives, test the countercase and failure path, and apply the decision table rather than selecting a template default.
- Produce revenue-recognition policy schedule and contract-liability bridge with the evidence, exception, and handoff records; reconcile every shared assumption with its owning section.
- Run the section quality checks, applicable finance or professional review, and anti-slop gate. If a gate fails, correct the evidence or decision and return to the responsible step.
Quality Standards
- Revenue-recognition policy schedule and contract-liability bridge must answer a real decision for the named bank, investor, DFI, grant, board, or strategic-partner reader.
- Formula trace, source/assumption register, three-statement or schedule reconciliation, and finance-gate record must be source-linked, dated where facts can change, and sufficient for another reviewer to reproduce the conclusion.
- The section exposes its countercase, stop condition, recovery action, and effect on neighbouring sections.
- No unavailable source, calculation, tool, or professional review is reported as passed; finance and statutory judgements follow the governing doctrine.
- Language remains specific to saas agent revenue recognition, uses British English naturally, and passes the repository anti-slop gate without promotional filler.
Anti-Patterns
- In saas agent revenue recognition, treating an unavailable approved commercial assumptions, contracts, usage/cost evidence, accounting framework, opening position, and projection horizon as confirmed. Correction: qualify the affected conclusion and issue the named evidence request.
- Producing revenue-recognition policy schedule and contract-liability bridge that restates the brief but makes no choice. Correction: record the choice, rejected alternative, rationale, countercase, and implication.
- Ignoring a conflicting upstream assumption. Correction: return it to its owning section and resume only from a reconciled version.
- Reporting an unavailable check as passed. Correction: mark it not assessed and narrow the release state.
- Claiming compliance, assurance, bankability, or investor readiness from narrative quality. Correction: run the applicable gate and retain its evidence.
- Copying the worked example into a client plan. Correction: use the method only and replace every fact with verified engagement evidence.
Worked Example
An agent subscription bundles configuration and twelve months of service. Identify whether configuration is distinct, allocate the transaction price, and recognise each obligation under the selected reporting framework.
References
- Use the verified project evidence register and the owning upstream pipeline section for saas agent revenue recognition; no local deep-dive reference is declared.
- For saas agent revenue recognition claims involving money, tax, grants, reserves, revenue, cost, valuation, or financial statements, apply the Chwezi finance doctrine and record the required professional-review state; illustrative figures never become client facts.
