Guides · YieldFabric

Start here

The alignment economy

The thesis. YF as infrastructure for the alignment economy — humans build entangled joint wanting through AI-augmented conversation; the moment of agreement is the measurement event that collapses it into a realised deal. Five operational roles: reason · communicate · negotiate · structure · execute. Read this first.

Building with YieldFabric

Wire-level reference for LLMs (and humans) building apps on YieldFabric. Auth flows, the five most-common operations, error handling, common pitfalls. Pragmatic companion to the alignment-economy thesis.

Walkthroughs

Cross-service walkthrough

End-to-end narrative: signup → deposit → payment → group → deal. Touches all three services + the federated gateway.

Reason · Communicate · Negotiate

Agents, knowledge & workspaces

The first three operational roles of the alignment economy: knowledge graphs and pipelines (reason), working groups and threads (communicate), intents and drafts (negotiate). Working groups, agents-as-members, the Weaver, Studio, RAG with cross-group federation, the personal notebook, and the safety architecture of Intent → Confirm.

Structure

DMS (Deal Management System)

The Structure-stage machinery. DealPlan as the typed action DAG two parties sign over; the deal lifecycle (Draft → Proposed → Accepted → Active → Completed); plan compilation to workflows; agreement projection as legal-style markdown; the deal_structurer agent persona; the dms-deals system workspace.

Collateralisation

A specific kind of structured deal artifact — the contingent-contract model. Full repo lifecycle, rolls, and rehypothecation chains. Where a confirmed Intent becomes an on-chain collateralised position.

Integration

SDK generation

How to generate type-safe clients from the OpenAPI specs. Per-language generator recommendations + gotchas.

Webhooks & events

Indexed catalog of every public event surface: webhooks, SSE streams, and polling endpoints.

MCP integration

Model Context Protocol integration. 19 tools, 2 prompts, 4 discovery endpoints. Wiring for Claude Code + Cursor.

Reference

Versioning policy

SemVer bump rules, deprecation policy, per-service current versions, deprecation labels in the OpenAPI spec.