---
okf_version: "0.1"
---

# Floret Knowledge Bundle

This bundle gives humans and agents a compact map of Floret's purpose, public
surface, internal architecture, and maintenance rules. Start here before changing
core contracts or explaining the project to another system.

# Core Project

* [Project Overview](project.md) - What Floret is, what it is not, and how hosts integrate it.

# Architecture

* [Architecture](architecture/) - Runtime layers, boundaries, execution identities, tools, and observation.
* [Tool output retention](architecture/tool-output-retention.md) - Head/tail previews, durable captures, bounded read/search and retention integrity.

# Public API

* [Built-in tool names](runtime/builtin-tool-names.md) - Callable names and durable semantics.
* [Public API](api/) - Supported downstream packages and when to use them.

# Workflows

* [Maintainer Workflows](workflows/) - Safe paths for changing APIs, tools, providers, and quality gates.

# Decisions

* [Design Decisions](decisions/) - Durable decisions that protect Floret's shape.