--- name: fondo-reference-architecture-9bf65e361ab5 description: 'Reference architecture for startup financial operations using Fondo as the bookkeeping backbone with complementary tools for banking, payroll, and reporting. Trigger: "fondo architecture", "startup finance stack", "fondo integration architecture". ' allowed-tools: Read, Write, Edit version: 1.6.0 license: MIT author: Jeremy Longshore tags: - saas - accounting - fondo compatibility: Designed for Claude Code --- # Fondo Reference Architecture ## Overview Reference architecture for a startup's financial operations with Fondo at the center, connecting payroll, banking, payments, and internal reporting. ## Prerequisites - A data-flow inventory, authorized business purpose, system owners, access/retention policy, and professional-review boundary. - Separate scoped identities for data sources, processing, storage, reporting, and support, plus synthetic integration fixtures. ## Instructions 1. Enforce field allowlists, access checks, encryption, and retention requirements at every financial-data boundary. 2. Keep financial/tax conclusions under the designated finance professional’s review; integrations may prepare evidence but not replace that review. 3. Use idempotent queues, redacted telemetry, staged promotion, and a correction/rollback path for each downstream consumer. ## Output Maintain an architecture record describing sources, trust boundaries, approved destinations, access/retention controls, owners, professional-review points, and recovery mechanisms. Do not include finance data or secrets. ## Error Handling - Quarantine unknown fields, unapproved destinations, and reconciliation mismatches for finance review. - Disable unsafe consumers and preserve only redacted evidence during recovery. - Restore the prior mapping/configuration before replaying any financial workflow. ## Examples Route a fictional aggregate expense event through an approved staging pipeline, deny an unapproved reporting consumer, and verify a duplicate event is suppressed. Record only the opaque event ID and aggregate outcome. ## Architecture ``` ┌─────────────────────────────────────────────────────────┐ │ Data Sources │ ├──────────┬──────────┬──────────┬──────────┬─────────────┤ │ Mercury │ Gusto │ Stripe │ Brex │ AWS/GCP │ │ Banking │ Payroll │ Revenue │ Expense │ Cloud │ ├──────────┴──────────┴──────────┴──────────┴─────────────┤ │ Plaid / OAuth Connections │ ├─────────────────────────────────────────────────────────┤ │ │ │ FONDO PLATFORM │ │ ┌──────────┐ ┌──────────┐ ┌────────────────┐ │ │ │ Monthly │ │ Tax │ │ R&D Tax Credit │ │ │ │ Close │ │ Filing │ │ Study (6765) │ │ │ └──────────┘ └──────────┘ └────────────────┘ │ │ │ ├─────────────────────────────────────────────────────────┤ │ Outputs │ ├──────────┬──────────┬──────────┬────────────────────────┤ │ P&L │ Balance │ Cash │ R&D Credit │ │ Report │ Sheet │ Flow │ Certificate │ ├──────────┴──────────┴──────────┴────────────────────────┤ │ Internal Dashboard (optional) │ │ Revenue metrics │ Burn rate │ Runway │ Board deck │ └─────────────────────────────────────────────────────────┘ ``` ## Recommended Stack | Category | Tool | Why | |----------|------|-----| | Banking | Mercury or SVB | Startup-friendly, API access, Plaid compatible | | Payroll | Gusto | Best startup payroll, Fondo integration | | Revenue | Stripe | Standard payments, clean webhooks | | Expenses | Brex or Ramp | Auto-receipt capture, categorization | | Bookkeeping | Fondo | Automated, CPA-managed | | Tax Filing | Fondo (TaxPass) | Bundled with bookkeeping | | R&D Credits | Fondo | Integrated with bookkeeping data | | Cap Table | Carta or Pulley | Equity management | | Board Reporting | Fondo exports + internal dashboard | Custom metrics | ## Data Flow 1. Transactions flow from banks/cards/payroll into Fondo via Plaid/OAuth 2. Fondo CPA team categorizes and reconciles monthly 3. Financial statements generated and delivered to Dashboard 4. R&D credit study prepared annually from same data 5. Tax returns filed using reconciled data ## Resources - [Fondo](https://fondo.com) - [Mercury](https://mercury.com) - [Gusto](https://gusto.com) ## Next Steps Start with `fondo-install-auth` to set up your Fondo account. --- Source attribution: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/saas-packs/fondo-pack/skills/fondo-reference-architecture/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2025 Jeremy Longshore Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/saas-packs/fondo-pack/skills/fondo-reference-architecture/SKILL.md Attribution basis: Source repository record Fields of work: Finance & Accounting, Operations, Sales Roles: Accountant, Business Development, CFO / FP&A, Financial Analyst, Operations Manager Specialties: API Tools: Gusto, Stripe Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: b55d39f671cbf502ba6f50acba388150e83b2cffee82de54890e3168c3424f0a