Living Specs — Index¶
This index lists every active and historical "living spec" in ftl-docs/architecture/specs/.
A living spec describes one product or system domain as it is today. It is rewritten
in place when behavior changes; we do not branch it into versions. The decision trail behind
each spec lives in architecture/decisions/ (the ADRs).
See CHANGE-MANAGEMENT.md at the repo root for the protocol, and _TEMPLATE.md for the
required structure.
Active specs¶
| Spec | Domain | Owner | Last updated | ADRs |
|---|---|---|---|---|
| amm-pricing | CFD-style margin trading: pricing curve, position lifecycle, FT auto-exit, post-match scoring | @amalkrsihna | 2026-05-24 | 0002, 0004, 0005, 0006 |
| wallet-and-margin | Balance / Equity / Used Margin / Free Margin / Margin Level definitions, washout policy, SL/TP semantics | @amalkrsihna | 2026-05-24 | 0004, 0006 |
| signup-and-onboarding | Google OAuth → registration → OTP → profile completion, coming-soon gate, tutorial sequencing | @amalkrsihna | 2026-05-22 | 0007, 0008, 0010 |
| referrals | v2 attribution (referrer-only, on first trade), ?ref= + ?invite= capture, payout economics, copy requirements |
@amalkrsihna | 2026-05-22 | 0008, 0009 |
Deprecated specs¶
(none yet)
Adding a new spec¶
- Pick a kebab-case domain name (
auth-flow,referral,leaderboard, …). Once chosen, don't rename — the path is referenced from code anchors. - Copy
_TEMPLATE.mdto<domain>.mdand fill in every section. - Add a row to the Active specs table above.
- If the new spec encodes a decision, add the matching ADR in
architecture/decisions/in the same PR.