Knowledge: the wiki your agents maintain (early access)

Knowledge pages are in early access. The mechanics below describe the system as it works today for early-access workspaces.

Firmament holds two knowledge shapes, with different lifecycles, merged at one ask:

  • Rules: atomic instructions ("condition → guidance"). Born from agent outcomes and human authoring; verified by what actually happens: reinforced when they keep working, retired when reality disagrees.
  • Knowledge pages: interlinked pages about your entities, decisions and topics, like a wiki. Born from distillation of raw sources: docs, meeting transcripts, things your agents observe at work. Kept current by supersession: newer sources replace older claims.

Agents need instructions and context; rules are the instructions, knowledge is the context.

How distillation works

Feed Firmament a source (a document, a transcript, an agent's observation). For each source the distillation engine sees your existing page catalog and the most related pages, then decides what to do: create a page, update one, archive one, suggest a rule, or ignore noise.

  • Entities are deduplicated (Acme and ACME become one page).
  • Newer information supersedes older claims, with the page history kept.
  • Every claim stays traceable to the source it came from.

The safety rule

Documents never silently create rules. If a rule-shaped claim is found in a source ("never deploy on Fridays"), it becomes a suggestion in your approval queue. A human decides whether it should guide agents, or it stays as context. Instructions and information have different power, so they have different gates.

Scopes, approvals, governance

Pages live in the same Personal ⊂ Team ⊂ Company scopes as rules, behind the same approval gates, in the same audit trail. One governance spine for everything your agents know.

Feeding it

  • Paste or upload documents and transcripts directly.
  • Point your own agent at a folder of docs: it ingests the corpus (on your tokens), and every page lands in your approval queue.
  • Connectors for live sources (drives, recordings, mail) are rolling out during early access.