This directory holds detailed product, API, operations, research, and architecture-decision documents. For current execution, start at the root docs, then use this index for deeper context.
- AGENTS.md — instructions for agents working in this repo.
- STATUS.md — latest execution state, locked decisions, next actions.
- CONTEXT.md — domain language and product invariants.
- Positioning — FundLabs / FundWise messaging and claims guardrails.
- ROADMAP.md — phased product and engineering plan.
- PRD.md — user stories, product principles, implementation decisions.
- issues.md — indexed
FW-*backlog and pick queue. - ADR directory and DECISIONS.md — current architecture decisions.
- Split Mode mainnet: Split Mode Mainnet Checklist → ops runbook → issues pick queue.
- Fund Mode mainnet closed beta: Fund Mode Beta Checklist → Fund Mode Beta Rehearsal → issues FW-079.
- Locked rollout sequence: ROADMAP → ADR-0043 → issues FW-077–FW-083.
- Security / audit follow-up: issues FW-053–FW-056 → audit.md → dependency audit → sanctions screening.
- Agent / Fundy / API discovery: Agent Skill Endpoint research → Agent Payment Policy → API reference → live
/skill.mdand/api/docsroutes. - Public copy / product claims: Positioning → Shipped vs Planned.
- Monetization: Monetization model → ADR-0032 → Fund Mode Beta Checklist.
| Doc | Purpose |
|---|---|
| README.md | Project overview, quick docs map, setup, current product shape. |
| AGENTS.md | Required agent operating rules, reading order, coding standards. |
| STATUS.md | Latest source of truth for what is live, blocked, or next. |
| CONTEXT.md | Canonical domain model, language, invariants, examples. |
| PRD.md | Product requirements, user stories, implementation decisions, out-of-scope boundaries. |
| ROADMAP.md | Phased delivery plan from Split Mode through Fund Mode, Fundy, and expansion. |
| issues.md | Indexed local backlog with FW-* IDs and pick queue. |
| DECISIONS.md | ADR index only; points to active ADR files. |
| audit.md | Security findings and mainnet blockers. |
| review.md | Product/code review and roast notes. |
| brand.md | Brand system, logo rules, palette, and visual constraints. |
| Doc | Purpose | Primary links |
|---|---|---|
| Split Mode Mainnet Checklist | Public mainnet launch plan for Split Mode. | issues FW-038–FW-040, ops runbook |
| Fund Mode Beta Checklist | Fund Mode rehearsal and invite-only mainnet closed-beta plan for UX, monetization, and ops. | issues FW-042–FW-065, FW-079, beta rehearsal |
| Fund Mode Beta Rehearsal | Scripted Fund Mode rehearsal path and devnet evidence. | Fund Mode checklist, STATUS |
| LI.FI Route Rehearsal | Mainnet-only EVM USDC → Solana USDC route rehearsal. | Split Mode checklist |
| Operations Runbook | Supabase, Cloudflare, RLS verification, and production ops steps. | Split Mode checklist, issues FW-038 |
| Zerion Readiness | Zerion CLI readiness script usage and context modes. | ROADMAP |
| Doc | Purpose |
|---|---|
| Positioning | Canonical tagline, FundLabs product-family positioning, messaging hierarchy, claims guardrails. |
| Shipped vs Planned | Canonical shipped/planned/out-of-scope product matrix. |
| Monetization | Launch monetization notes; ADR-0032 is authoritative for the current take-rate model. |
| Fund Mode Proposal Audit | Proposal proof/comment/edit-history model and storage/access rules. |
| Doc | Purpose | Related implementation |
|---|---|---|
| API Reference | Static API reference snapshot. | app/api/docs/route.ts, app/api/openapi.json/route.ts |
| Agentic Settlement Endpoint Research | Payable Settlement Request, x402, MPP, pay.sh research. | app/skill.md/route.ts, lib/server/fundwise-api-discovery.ts |
| Agent Payment Policy | Spending Policies, endpoint gaps, safety policy, Group ownership notes. | Planned Scoped Agent Access |
| Zerion Readiness | CLI commands for wallet readiness and verification. | scripts/zerion-readiness.mjs |
| Doc | Purpose |
|---|---|
| audit.md | Security findings and mainnet blockers. |
| Security Playbook | Web3 security best-practices checklist: hosting (Cloudflare Pages + Supabase + Railway + Solana RPC), org-level multisig + access control, project-level supply-chain + CI/CD + code-level + Anchor program hygiene, Sealevel exploit reference, FundLabs-specific decisions, ongoing verification cadence. Generated 2026-05-16. |
| Dependency Audit | Dependency advisory triage and accepted risk notes. |
| Sanctions Screening | Minimal wallet screening approach and limitations. |
| Operations Runbook | RLS verification and production environment procedures. |
| Supabase RPC and Settlement hardening | Service-role-only RPC grants and unique Settlement transaction signatures. |
| issues FW-053–FW-056 | Current branch-audit remediation backlog. |
Research is supporting context only. If research disagrees with STATUS, CONTEXT, PRD, or latest ADRs, the source-of-truth docs win.
- Research index — retained research notes that still support current decisions.
- Fund Mode monetization research — focused take-rate and pricing comparison for Fund Mode.
- DECISIONS.md — root ADR index.
- Active ADR index — ADR directory index.
- Active ADR directory — current architecture decisions.
| ADR | Title |
|---|---|
| 0001 | Pivot from Fund Flow to FundWise |
| 0002 | Stablecoins only for Balances |
| 0003 | Off-chain metadata, on-chain money |
| 0004 | Drop inherited hackathon dependencies |
| 0005 | Squads multisig for Fund Mode |
| 0006 | Wallet-only auth |
| 0007 | Rename circles to Groups |
| 0008 | Keep Next.js / shadcn stack |
| 0009 | Switch from Firebase to Supabase |
| 0010 | Store multisig and vault addresses for Fund Mode |
| 0011 | Fix USDC as the MVP Settlement asset |
| 0012 | Require authenticated verified ledger writes before mainnet |
| 0013 | Store global profile display names separately |
| 0014 | Optional Phantom Connect alongside wallet adapter |
| 0015 | Wallet-signed session cookies for server mutations |
| 0016 | Prioritize Split Mode and hide cross-chain routing |
| 0017 | Snapshot Source Currency Expenses into USDC ledger |
| 0018 | Agent Skill Endpoint and Fundy Telegram bot |
| 0019 | Expense dispute handling via Group consensus |
| 0020 | Dashboard and Expense UX overhaul |
| 0021 | GTM rollout order: Split, Fundy, Fund Mode beta |
| 0022 | Fundy moves to a separate repository |
| 0023 | Tax advisory and filing live in Fundy |
| 0024 | Visa Frontier track and card partnerships |
| 0025 | Keep Split Mode free and monetize later surfaces |
| 0026 | Research-informed Fund Mode infrastructure boundaries |
| 0027 | Fund Mode is the hero product |
| 0028 | FundLabs product-family positioning |
| 0029 | Squads governance is the Fund Mode source of truth |
| 0030 | Supabase RPC and Settlement hardening |
| 0031 | Fund Mode pricing decision (superseded by ADR-0032) |
| 0032 | Fund Mode take-rate monetization (supersedes ADR-0031) |
| 0033 | Staged release pipeline |
| 0034 | Threshold-change Proposal semantics |
| 0035 | lib/squads/ Module fences Squads governance plumbing |
| 0036 | lib/fees/ Module is deep by design |
| 0037 | withAuthenticatedHandler HOF for wallet-session API routes |
| 0038 | Split fundwise-mutations.ts into per-concept Modules |
| 0039 | Fundy is a product; agent-as-Member is the north-star |
| 0040 | Receipt Endpoint ships standalone, decoupled from Payable Settlement Requests |
| 0041 | Fund Mode mainnet closed beta is a gated stretch for Solana Summit |
| 0042 | Tributary protocol for Fund Mode Recurring Contributions, devnet-first (Proposed) |
| 0043 | Roadmap sequence: Split, Fund, Seeker, Telegram, multi-chain, non-crypto |
- Split Mode Mainnet Checklist
- Stablecoins only for Balances
- Off-chain metadata, on-chain money
- USDC as MVP settlement asset
- Wallet-signed sessions
- Supabase RPC and Settlement hardening
- Source Currency snapshots
- LI.FI Route Rehearsal
- Fund Mode Beta Checklist
- Fund Mode Beta Rehearsal
- Fund Mode Proposal Audit
- Squads multisig for Fund Mode
- Store multisig and vault addresses
- Research-informed Fund Mode infrastructure boundaries
- Fund Mode is the hero product
- Squads governance source of truth
- Agent Skill Endpoint and Fundy Telegram bot
- Fundy moves to a separate repository
- Tax advisory and filing live in Fundy
- Agentic Settlement Endpoint Research
- Agent Payment Policy
- API Reference
- Positioning
- GTM rollout order
- Visa Frontier track and card partnerships
- Keep Split Mode free and monetize later surfaces
- FundLabs product-family positioning
- Roadmap sequence
- Monetization model
- New execution work must get a unique
FW-*issue in issues.md. - New irreversible architecture decisions must get the next ADR number and be added to DECISIONS.md and this index.
- New research belongs under docs/research/ and must be linked from docs/research/README.md.
- If any docs disagree, use STATUS, CONTEXT, PRD, and the latest ADRs as source of truth.