docs/index.mdtype: Index

The manual is a bundle.

These docs are an OKF bundle — one markdown concept per page, cross-linked and indexed. What follows is index.md: the generated listing okf index would write for this directory.

##

Contents

§6 — generated index listing
TypeConceptDescription
Guidegetting-startedInstall the library from NuGet and the okf CLI, then validate your first bundle.
GuideguidesTask recipes: traverse the cross-link graph, gate CI on conformance, generate indexes (§6) and changelogs (§7), round-trip with fmt, publish the AOT binary.
ReferencelibraryThe C# API surface — Bundle, ConceptId, OkfDocument, Frontmatter, the YAML subset, links, IndexGenerator, ChangeLog.
ReferencecliThe six okf commands — flags, exit codes, and copy-paste transcripts.
ReferenceagentssoonThe Microsoft Agent Framework layer — nine bundle tools and a budget-bounded context provider.
GuidemcpServe a bundle to Claude Desktop, Claude Code, and any MCP client with the okf-mcp server — install and connect, step by step.
ReferencespecOKF v0.1, section by section, mapped to the types that implement it.

The reference pages are landing one at a time. Until each does, the overview pages below cover the essentials.

##

Start here

what you came to do
use the library

Load bundles, parse and round-trip concepts, walk the graph from C#. → library.md

use the cli

Validate, index, and graph bundles from one AOT binary — drops into CI. → cli.md

understand okf

What a bundle is, the reserved files, and the one conformance rule. → what-okf-is.md

build an agent

Expose a bundle to an AI agent as tools plus bounded context. → agents.md soon

use it in Claude

Serve the bundle to Claude and any MCP client as read/write tools. → mcp.md

##

How these docs are organised

guides teach · reference tells

Guides are task-shaped — they walk you end to end through one job. Reference pages are lookup-shaped — one entry per type, command, or tool, exhaustive and skimmable. The sidebar is the bundle tree; every page is a concept you could cat.

okf4net.md — back to the overview