FFWF Robotics

Documentation for three projects, each organized the same way.

The projects

Tectum

A schema-driven event substrate. Nodes on substrates exchange immutable events over NATS subjects, and orchestration lives in declarative schema documents rather than Python wiring.

Quickstart

Tau

A programmable coding agent harness. Headless-first agent library with an optional TUI, Python-native extensions, and sessions stored as a tree rather than a flat chat log.

Quickstart

JMFTS

A retrieval appliance combining matryoshka embeddings, ColBERT-style late interaction, and BM25 hybrid search over PostgreSQL with pgvector.

Quickstart

Find your quadrant

Two questions decide where you should be. Are you acting on the system or trying to understand it? And are you here to study, or do you have a job in front of you right now?

Acquisition

Application

Action

Tutorials

Action × Acquisition

A guided build that teaches the concepts as you go. Start at the quickstart and keep going.

Tectum Tau JMFTS

Cookbook

Action × Application

Recipes for one specific job, for someone who already knows the basics and wants the steps without the narration.

Tectum Tau JMFTS

Cognition

DevOps Manual

Cognition × Acquisition

How the system is deployed and operated, and why it is shaped that way. Read this before you run it in anger.

Tectum Tau JMFTS

Reference

Cognition × Application

API surface, config, schemas, invariants. Built for search and lookup, not for reading start to finish.

Tectum Tau JMFTS

The split is Diátaxis. It is a crosswalk, not a sequence — there is no order you are supposed to read the four in.

Documentation state

Every page declares its own state in frontmatter. This table is generated from those declarations at build time, so it cannot drift from the pages it reports on.

Project	Version	Tutorials	Cookbook	DevOps Manual	Reference
Tectum	0.1.0	stub	draft	draft	draft
Tau	v0.9.2	stub	stub	draft	draft
JMFTS	0.1.0	draft	stub	draft	draft

stub nothing written · outdated written, now wrong · draft usable, incomplete · stable trust it

Integrations

Each project stands on its own. These cover what happens at the seams.

Tectum + Tau

Agents as nodes on the substrate: Tau sessions driven by Tectum events, and emitting their own back.

TectumTaudraft

Tectum + JMFTS

Retrieval as a substrate service: JMFTS queries and index updates carried as events.

TectumJMFTSdraft

Tau + JMFTS

Retrieval-backed agents: giving a Tau session searchable memory over a JMFTS corpus.

TauJMFTSdraft

The FFwF Full Stack Agent

All three at once: Tau agents on a Tectum substrate with JMFTS as shared memory.

TectumTauJMFTSdraft